Antes de homologar uma integração Meta, compare os requisitos por produto e por conta: identidade do app, proprietário dos ativos, tipo de conta, permissões, token e operação pretendida. A evidência necessária é uma execução com o perfil do cliente que usará o sistema, acompanhada dos casos em que o acesso deve ser recusado.
Uma publicação no Instagram, um relatório de anúncios e uma conversa no WhatsApp são fluxos diferentes. Use a matriz abaixo para transformar requisitos em critérios de aceite, sem presumir que o teste do desenvolvedor representa a configuração de produção. O catálogo de integrações de IA da Meta ajuda a localizar o produto; aqui o foco é a preparação das contas para APIs usadas por uma integração própria.
Resumo rápido
- Inventarie app e ativos pelos identificadores, não apenas pelos nomes exibidos.
- Separe acesso da pessoa, permissão do aplicativo e autorização do token.
- No Instagram, escolha primeiro o caminho de login e confira o tipo de conta exigido.
- Na Marketing API, diferencie contas próprias das contas de terceiros.
- No WhatsApp, valide onboarding, autorização do destinatário e regras de mensagens.
- Guarde uma evidência por requisito e deixe pendências explícitas antes da entrega.
1. Monte o inventário das contas e dos responsáveis
Comece com uma planilha simples: produto, identificador do ativo, proprietário, pessoa que administra, aplicativo utilizado e finalidade. Inclua Página do Facebook, conta profissional do Instagram, conta de anúncios e conta do WhatsApp Business quando participarem do projeto. Um nome parecido no painel não é uma identificação suficiente para liberar uma operação.
Acrescente a relação entre cliente e prestador. Quem é dono do ativo? Quem recebeu acesso para operá-lo? Quem consegue revogar esse acesso? Ativos em organizações diferentes não são, por si, um defeito: uma agência pode operar bens de clientes por autorizações específicas. O problema é não conseguir demonstrar essa relação e depender de uma conta pessoal que ninguém mais administra.
Não transfira propriedade só para simplificar o teste. Primeiro verifique o arranjo que o cliente pretende manter e confirme quais permissões estão disponíveis nele. Uma alteração de titularidade pode ter efeitos operacionais que extrapolam a integração. Documente a pendência e faça a decisão com o responsável pelo ativo.
Defina também o responsável por privacidade, renovação das credenciais e atendimento a falhas. A matriz perde valor quando todos os requisitos técnicos estão marcados, mas ninguém pode responder por uma autorização revogada. O artigo sobre segurança e LGPD na implantação de IA complementa essa organização com cuidados sobre os dados tratados.
2. Compare requisito, evidência e condição de aceite
Separe a capacidade da API da situação concreta da conta. A documentação pode permitir uma função que ainda não foi autorizada para o aplicativo. Uma credencial pode ter permissão nominal e não alcançar o ativo selecionado. Homologar significa verificar todas essas camadas na combinação que irá operar.
| Camada | O que comparar | Evidência de aceite |
|---|---|---|
| Identidade | App, conta e ativo realmente usados | Identificadores conferidos no painel e na resposta |
| Tipo de conta | Requisito do produto e configuração do cliente | Conta elegível para o fluxo escolhido |
| Permissão | Operação necessária e acesso concedido | Consulta ou ação mínima autorizada |
| Credencial | Tipo, escopo, validade e responsável | Token de teste correto e plano de substituição |
| Conta de terceiro | Perfil de teste e perfil do cliente | Login e execução sem depender do desenvolvedor |
| Regra operacional | Limites e políticas aplicáveis ao uso | Bloqueio de operação indevida e alerta claro |
Use três estados: comprovado, pendente e não aplicável. Para “não aplicável”, escreva uma justificativa. Se o sistema apenas lê métricas, a publicação de conteúdo pode ficar fora do escopo; isso é diferente de declarar que a conta tem essa capacidade. Evite um único campo “integração funcionando”, que apaga essa distinção.
Registre a data da consulta e a página oficial usada. Limites, processos de revisão e interfaces podem mudar. O valor observado no painel do cliente é mais útil para a decisão operacional do que um número copiado de um tutorial antigo. Não transforme uma condição vista em uma conta em promessa universal para as demais.
3. Escolha o caminho certo para o Instagram
A coleção oficial da Meta no Postman distingue Instagram API with Instagram Login e Instagram API with Facebook Login. Ambas atendem contas profissionais, de empresas ou criadores. No caminho com Facebook Login, a conta profissional precisa estar ligada a uma Página; com Instagram Login, essa vinculação não é exigida pelo mesmo fluxo.
Essa escolha deve vir antes de pedir permissões. Identifique a função necessária, como publicação ou leitura de informações, e consulte os requisitos da configuração selecionada. Não misture nomes de permissões de caminhos diferentes apenas porque ambos mostram a palavra Instagram. Também não trate conta pessoal como equivalente à profissional.
No ensaio, use uma conta profissional controlada para homologação e o fluxo de autenticação do aplicativo. Confira se o identificador retornado corresponde ao ativo escolhido. Se houver publicação, envie um conteúdo preparado para teste, verifique o destino e combine a remoção com o responsável. Para funções de leitura, escolha uma consulta pequena com resultado conhecido.
Depois faça o caso negativo: remova uma autorização de teste ou tente selecionar um ativo que aquele usuário não administra. O sistema deve explicar a pendência sem trocar silenciosamente de conta. Esse teste evita que uma falha de seleção publique no perfil errado ou misture dados de dois clientes.
4. Separe relatório de anúncios e gestão de campanhas
A coleção oficial da Marketing API lista conta de desenvolvedor, app, token, permissões e conta de anúncios entre os requisitos. Ela também diferencia acesso padrão para contas próprias e acesso avançado para contas de outras pessoas, conforme as permissões utilizadas. Portanto, o roteiro precisa reproduzir o relacionamento real com o cliente.
Para um relatório, comece com a consulta mínima necessária e mantenha operações de alteração fora do teste. Já um sistema que cria ou modifica campanhas precisa comprovar a autorização correspondente e ter um mecanismo de aprovação compatível com o impacto da ação. Ter acesso a métricas não demonstra permissão para gerenciar orçamento.
Registre quais acessos ainda dependem de revisão ou configuração no painel. Consulte o processo aplicável ao app, em vez de concluir que toda integração seguirá exatamente a mesma sequência. Verificação da empresa, revisão do aplicativo e autorização sobre ativos respondem a perguntas diferentes; uma tela aprovada não comprova automaticamente todas as outras.
A coleção também aponta o depurador de tokens para inspecionar tipo e permissões. Faça essa inspeção no ambiente oficial e guarde no relatório somente metadados necessários. Nunca cole o token inteiro em uma planilha compartilhada. Para o caso específico de leitura, o guia de relatórios de Meta Ads e Google Ads com n8n mostra um uso que deve permanecer separado da gestão de campanhas.
5. Confira WhatsApp, destinatários e operação real
O guia oficial de onboarding do WhatsApp organiza a entrada em etapas de preparação, aprendizado e expansão. Ele recomenda alinhar expectativas de volume, qualidade e configuração da conta. Use esse desenho para separar um ensaio pequeno de uma operação que já precisa de escala. Confira os limites atuais no painel da conta antes de prometer capacidade.
Registre a conta do WhatsApp Business, o número utilizado, o responsável pela confirmação de propriedade e o caminho de onboarding. Se já existe atendimento naquele número, verifique o procedimento atual aplicável antes de alterar qualquer coisa. Não apague a conta do aplicativo nem interrompa a recepção como atalho de homologação. A escolha precisa considerar continuidade do serviço e documentação vigente.
A política de mensagens exige autorização do destinatário para contatos e respeito a pedidos de interrupção. Na Business Platform, mensagens iniciadas pela empresa precisam de modelos aprovados; respostas sem modelo ficam condicionadas à janela de atendimento descrita na política. Automação também deve oferecer caminhos claros de escalonamento. Esses pontos precisam aparecer no aceite, além da entrega técnica da mensagem.
Prepare destinatários controlados e conteúdo identificado como teste. Confira envio, recebimento e tratamento dos eventos que o seu sistema utiliza. O sucesso do botão de teste no painel não substitui observar o caminho completo até a aplicação. Uma resposta HTTP favorável na requisição inicial tampouco prova que o atendimento terminou corretamente.
Crie casos para destinatário sem autorização, pedido de saída e falha de credencial. A recomendação é que seu aplicativo bloqueie o fluxo inadequado e preserve evidências sanitizadas. Não provoque spam ou denúncias para medir uma restrição. Esses comportamentos podem ser exercitados por simulação e testes da própria lógica.
Exemplo: agência de Curitiba integrando uma loja
Considere uma agência de Curitiba preparando três funções para uma loja de móveis: publicar conteúdo no Instagram, ler métricas de anúncios e responder consultas no WhatsApp. O cenário é ilustrativo. Antes do código, agência e cliente conferem identificadores e responsáveis, sem alterar a propriedade dos ativos para facilitar a entrega.
Para o Instagram, a equipe escolhe o caminho de login conforme a configuração da conta profissional e as funções desejadas. Para anúncios, mantém o escopo em leitura e verifica se o acesso concedido permite atender a conta do cliente. Para WhatsApp, valida o onboarding do número escolhido e utiliza somente participantes que aceitaram o teste.
A ficha exige uma execução positiva e uma recusa por função. A publicação chega ao perfil de teste correto; a tentativa com autorização removida falha claramente. O relatório lê a conta de anúncio esperada e não oferece botão para modificar campanha. O atendimento respeita a saída do destinatário e mostra o caminho de contato humano previsto pela loja.
Se uma permissão estiver pendente, a agência registra a dependência e impede a ativação daquela função. As demais só são liberadas se funcionarem de forma independente. A entrega passa a ter um escopo verificável, sem apresentar uma aprovação parcial como autorização completa do conjunto.
Erros comuns
- Testar apenas como administrador. Repita o fluxo com o perfil que o cliente utilizará.
- Confundir identidade e permissão. Um token válido não prova acesso ao ativo escolhido.
- Misturar os logins do Instagram. Confira requisitos e permissões do caminho implementado.
- Prometer um limite fixo para toda conta. Registre o valor atual e a condição observada no painel.
- Apagar uma conta existente por rotina. Verifique onboarding e continuidade antes de mudar o número.
- Guardar credenciais como evidência. Salve identificadores, estados e respostas sanitizadas.
Perguntas frequentes
Funcionar na conta do desenvolvedor é suficiente?
Não. O cliente pode ter outro tipo de conta, vínculo com ativos e nível de acesso. A homologação deve reproduzir essa combinação e comprovar as permissões necessárias, sem depender de privilégios extras do desenvolvedor.
Toda integração do Instagram precisa de Página?
A exigência depende do caminho. A documentação oficial distingue a configuração com Facebook Login, que exige a ligação, da configuração com Instagram Login. Confira qual delas foi implementada antes de pedir alterações ao cliente.
Preciso pedir acesso para alterar anúncios se só faço relatórios?
Defina as permissões pelas operações utilizadas e consulte os requisitos dos endpoints. Não acrescente capacidade de alteração apenas por conveniência. O relatório deve ser homologado com o menor acesso que permita sua execução.
Posso liberar uma função com requisito pendente?
Mantenha a função bloqueada até comprovar o requisito. Se outras funções forem independentes e estiverem aprovadas, documente a liberação parcial com precisão. Registre responsável, pendência e condição para nova avaliação.
