OmnichannelCentral de conhecimento
Configurar na Meta

Instagram: cadastrar callback e assinar mensagens

Finalize a recepção de mensagens diretas no Omnichannel.

Onde encontrarDevelopers → Instagram → Webhooks; Omnichannel → Integrações → Instagram

Antes de começar

  • Atividade do administrador da empresa ou do responsável técnico autorizado.
  • Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.

Passo a passo

  1. No Omnichannel, confira nome da conta, ID profissional, token, segredo do aplicativo e a versão/base Graph adotada pela instalação.
  2. Use Testar, salvar e assinar na configuração direta, ou conclua a ativação na conexão integrada, conforme a tela disponível.
  3. Copie a URL de webhook e o token de verificação apresentados pelo sistema. A rota da integração é /api/v1/webhooks/instagram no domínio público do Omnichannel.
  4. No produto Instagram do aplicativo, cadastre esses valores e confirme a validação.
  5. Confira os eventos messages, messaging_postbacks e messaging_seen. Volte ao Omnichannel e utilize Assinar novamente se a assinatura ainda estiver pendente.
  6. Verifique o status do aplicativo e os acessos permitidos pelo modo atual na Meta. Homologue uma mensagem direta recebida e uma resposta para a conta autorizada.
  7. Associe o fluxo publicado ao canal e repita a conferência da fila e da transferência para a equipe.

Resultado esperado

Mensagens diretas chegam ao canal Instagram configurado.

Observações importantes

  • Salvar um token não garante que a assinatura de eventos foi concluída.
  • As condições de teste e publicação devem ser verificadas no painel atual da Meta.

Se precisar de ajuda

  • Callback valida, mas nada chega: confira conta, eventos, assinatura e autorização para o usuário remetente.
  • Erro de assinatura: confira o App Secret do produto Instagram.

Referências oficiais