Messenger e Instagram
Os dois canais da Meta que não são WhatsApp — como conectar cada um, por que o Instagram herda do Messenger e por que a janela de 24 horas aqui não tem saída.
Esta página junta Messenger e Instagram porque, no ChatMade, os dois são a mesma coisa por dentro. O adaptador do Instagram é uma extensão do adaptador do Messenger: ele herda a leitura de mensagem e o formato de envio, e muda só o endereço da API da Meta, os campos de perfil que consulta e um detalhe do formato dos eventos.
Isso importa na prática: o que vale para um vale para o outro, salvo onde esta página disser o contrário.
O que você precisa antes
Para os dois:
- Um aplicativo criado em developers.facebook.com.
- Numa instalação própria,
META_APP_ID,META_APP_SECRETeMETA_WEBHOOK_VERIFY_TOKENno.envdo backend. - Um administrador do ChatMade com a permissão
manage_organization.
Para o Messenger, mais: uma Página do Facebook.
Para o Instagram, mais: uma conta profissional (comercial ou de criador).
Messenger
Onde pegar a credencial
No painel do aplicativo na Meta, em Messenger → Settings (“Messenger → Configurações”), gere um token de acesso da Página para a Página que você quer conectar. O ID da Página fica nas configurações da própria Página.
Conectar
- Settings → Integrations (“Configurações → Integrações”).
- Cartão Messenger, descrição “Let customers chat with your AI agent on Facebook Messenger.”
- Connect (“Conectar”). Abre o modal Connect Messenger.
Entrando com o Facebook: o botão Continue with Facebook (“Continuar com o Facebook”), sob a linha “Sign in with Facebook to connect your Page.” Se a sua conta administra mais de uma Página, aparece um seletor com o título Choose the account to connect: (“Escolha a conta para conectar:”).
Colando as credenciais: pelo link Enter credentials manually instead.
| Campo na tela | O que colar |
|---|---|
| Facebook Page ID (“ID da Página”) | O ID numérico da Página |
| Page access token (“Token de acesso da Página”) | O token gerado para essa Página, começando com EAAG… |
O ChatMade valida o token antes de aceitar, e os erros são específicos:
- Token do tipo errado: “That is a {tipo} access token, not a Page access token. In the Meta app dashboard go to Messenger → Settings and click Generate on the row for your Page.”
- Token de outra Página: “That token is for Page {id}, not the Page ID you entered. Webhooks are routed by Page ID, so the two must match.”
- Escolha o agente e clique em Assign agent (“Atribuir agente”).
O webhook é registrado sozinho, com os campos messages e messaging_postbacks. Você não configura nada.
Duas formas de conectar — e elas diferem
Aqui está a parte que costuma confundir.
Pela autorização do Instagram (o botão). O modal Connect Instagram abre com Continue with Instagram (“Continuar com o Instagram”), sob a linha “Sign in with Instagram to connect your professional account.” Esse caminho usa credenciais próprias do Instagram — as variáveis INSTAGRAM_APP_ID e INSTAGRAM_APP_SECRET, que são diferentes das da Meta — e pede os escopos instagram_business_basic e instagram_business_manage_messages.
Por esse caminho você não precisa de uma Página do Facebook. O código diz isso literalmente: “Unlike Messenger this needs no Facebook Page.”
Colando as credenciais. Aqui, sim, você precisa da Página. A tela avisa: “Your Instagram account must be a professional account linked to a Facebook Page. Use the linked page’s access token.”
| Campo na tela | O que colar |
|---|---|
| Instagram account ID (“ID da conta do Instagram”) | O ID numérico, tipo 17841400000000000 |
| Linked page access token (“Token da Página vinculada”) | O token de acesso da Página do Facebook ligada à conta |
O ChatMade confere se o ID é mesmo de uma conta profissional. Não sendo, você lê “The ID entered is not an Instagram professional account ID”.
A conta conectada aparece como @nomedeusuario.
A janela de 24 horas — e a diferença que importa
Messenger e Instagram têm a mesma janela de 24 horas do WhatsApp: passadas 24 horas desde a última mensagem do cliente, a sua mensagem não é mais entregue.
Atenção: aqui não há saída. O WhatsApp reabre a janela com um modelo aprovado; o Messenger e o Instagram não têm esse mecanismo no ChatMade. Fechou, fechou — a mensagem é marcada como não entregue e ponto.
Na prática: se o seu processo depende de retomar contato dias depois, o Messenger e o Instagram não servem. Use WhatsApp com modelo, ou e-mail.
Testar
Não há botão de teste em nenhum dos dois. Mande uma mensagem de verdade para a Página ou para o perfil e veja a resposta chegar.
Limites
- Resposta do Messenger cortada em 2.000 caracteres.
- Janela de 24 horas, sem reabertura.
- Chamadas à Meta com tempo limite de 15 segundos e 2 tentativas.
- Trava contra evento duplicado de 1 hora.
Atenção: nenhum dos dois recebe ou envia mídia neste sistema. Foto no direct, áudio, sticker e vídeo são descartados — só o texto passa. Num canal onde o cliente costuma mandar print, isso pesa.
Desconectar
Botão Disconnect (“Desconectar”) no cartão. A confirmação lista: para de receber e responder mensagens, remove o roteamento do agente, e exige colar as credenciais de novo para voltar.
Próximo passo
Se o seu atendimento também acontece internamente, o Slack é o canal mais completo dos nove.