A configuração acontece em dois lugares: Meta for Developers e Painel do gestor → Canais no ConversaFlow. Facebook e Instagram podem usar o mesmo aplicativo, segredo, token de verificação e URL de callback.
Antes de começar
Confirme os acessos e ativos antes de gerar tokens. A maior parte dos erros acontece quando a Página, a conta do Instagram e o aplicativo pertencem a portfólios diferentes ou quando o usuário não possui controle administrativo.
Prepare o aplicativo no Meta for Developers
- Acesse Meus aplicativos e abra o aplicativo empresarial que será usado pelo ConversaFlow.
- Se ainda não houver um aplicativo, escolha Criar aplicativo, selecione um caso de uso empresarial e vincule o portfólio correto.
- Adicione ou configure os produtos de Messenger e Instagram.
- Em Configurações do app → Básico, confirme o domínio, a Política de Privacidade e os Termos de Serviço.
Os nomes e a posição das opções podem mudar na interface da Meta. O resultado necessário é um aplicativo empresarial com acesso à Página e à conta profissional que serão conectadas.
Separe o Segredo do app e crie o token de verificação
Conecte a Página do Facebook
- No produto Messenger do aplicativo, abra a área de configuração da API.
- Selecione ou adicione a Página que será usada no atendimento.
- Copie o ID da Página. Ele é numérico e pode ser encontrado nas informações da Página ou nas ferramentas do aplicativo.
- Gere um token de acesso da Página com acesso aos ativos e permissões necessários.
- Para produção, prepare a análise das permissões de mensagens e o acesso avançado solicitado pela Meta.
Conecte a conta profissional do Instagram
- Confirme no Instagram que a conta é profissional e está associada ao negócio correto.
- No aplicativo da Meta, abra o produto Instagram e conclua a configuração da API de mensagens.
- Adicione a conta profissional como conta de teste enquanto o aplicativo estiver em desenvolvimento.
- Localize o ID da conta profissional. Não use o nome com @ no campo de ID.
- Gere o token de acesso da conta com as permissões de leitura básica e gerenciamento de mensagens exigidas pela Meta.
Preencha os canais no ConversaFlow
Acesse Painel do gestor → Canais e localize o card Facebook e Instagram.
- Preencha primeiro as credenciais compartilhadas.
- Preencha o ID e o token de cada canal que será usado.
- Clique em Testar no Facebook e no Instagram separadamente.
- Ative somente os canais validados.
- Marque Usar Facebook e Instagram no atendimento e clique em Salvar canais.
É possível usar somente Facebook, somente Instagram ou ambos. O ConversaFlow tenta assinar os eventos de mensagens quando a configuração ativa é salva.
Configure o webhook da Meta
- No card Facebook e Instagram, copie a URL de callback da Meta.
- No Meta for Developers, abra a configuração de Webhooks do aplicativo.
- Cole a URL de callback e informe exatamente o mesmo Token de verificação salvo no ConversaFlow.
- Conclua a verificação do callback.
- Assine os eventos messages e messaging_postbacks para os objetos usados pelo Messenger e pelo Instagram.
- Confirme que a Página e a conta profissional também estão vinculadas ao aplicativo.
A URL deve ser copiada da empresa aberta no ConversaFlow e segue este formato:
https://conversaflow.travassyx.com/api/webhooks/meta?tenant_slug=identificador-da-empresa
Prepare o aplicativo para produção
No modo de desenvolvimento, somente administradores, desenvolvedores e contas de teste autorizadas conseguem validar todos os fluxos. Antes de atender clientes reais:
- conclua a verificação empresarial quando a Meta solicitar;
- informe o domínio, a Política de Privacidade e os Termos de Serviço;
- solicite acesso avançado às permissões de mensagens necessárias;
- grave os testes e forneça as instruções exigidas na análise do aplicativo;
- publique o aplicativo somente depois de testar recebimento, resposta e anexos;
- mantenha tokens, ativos e usuários do sistema sob controle da empresa.
Entre as permissões normalmente relacionadas a esses canais estão pages_messaging para Messenger e instagram_business_basic e instagram_business_manage_messages para a API de mensagens do Instagram. A Meta pode exigir permissões adicionais conforme o método de login e os recursos usados pelo aplicativo.
Faça o teste final de cada canal
Erros mais comuns
“Não foi possível validar a URL de callback ou o token”
Salve primeiro o Segredo do app e o Token de verificação no ConversaFlow. Depois copie novamente a URL e informe na Meta o mesmo token, sem espaços extras.
“A Meta recusou o canal”
Confira se o ID é numérico, se o token pertence ao mesmo ativo e se o usuário que gerou a credencial possui acesso administrativo à Página ou à conta profissional.
O teste funciona, mas mensagens reais não chegam
Confirme as assinaturas de messages e messaging_postbacks, a vinculação dos ativos, o modo do aplicativo e as permissões aprovadas para produção.
A mensagem chega, mas a resposta falha
Verifique a validade do token, a permissão de mensagens, a janela de atendimento permitida pela Meta e se o cliente iniciou contato com a empresa.
O Instagram não aparece para seleção
Confirme que a conta é profissional, pertence ao negócio correto e foi adicionada aos ativos e usuários autorizados do aplicativo.