Voltar às documentações

Como configurar Instagram (Messenger / Meta)

Passo a passo para conectar o Instagram Direct ao OSBChat via API Meta.

Como configurar Instagram (Messenger / Meta)

  1. Use a mesma Meta Business Account e o app já criado (ou crie um em developers.facebook.com).
  2. Adicione o produto Instagram (ou Messenger) ao app e conecte uma página do Facebook à sua conta profissional do Instagram.
  3. No Facebook, vá em Configurações da páginaInstagram e vincule a conta profissional do Instagram à página.
  4. No app Meta, em InstagramConfiguração, associe a conta do Instagram ao app e solicite as permissões instagram_manage_messages e instagram_manage_comments (conforme o uso).
  5. Gere um token de acesso com as permissões necessárias (página + Instagram).
  6. Configure o webhook para mensagens do Instagram no OSBChat (URL de callback e token de verificação).
  7. No OSBChat, em IntegraçõesInstagram, informe os IDs (App ID, App Secret, Page Access Token, Instagram Business Account ID) e o token. Salve e ative.

O fluxo usa OAuth para autorizar a página e a conta do Instagram; após autorizar, o canal fica pronto para receber e enviar mensagens no Direct.

Fotos no Direct

No painel de conversas, mensagens com foto costumam exibir uma prévia da imagem. O link da prévia é gerado pela Meta e pode expirar com o tempo; se isso acontecer, a prévia deixa de carregar e o painel mostra um aviso. Há opção para abrir a imagem em nova aba enquanto o link estiver válido. Se o cliente escreveu texto junto com a foto, essa legenda aparece na conversa.

DM vs comentários em posts

  • Bot Redes Sociais (triagem): atende mensagens diretas (DM). Use um app Meta configurado com webhook para mensagens do Instagram. Triagem, coleta de dados e encaminhamento.
  • Bot Redes Sociais – Interação em Posts: atende apenas comentários nas postagens, não DMs. Exige um app no Meta Developers configurado para receber comentários (webhook de comentários). O bot responde de forma curta nos comentários; se identificar pedido de ajuda ou reclamação, orienta a pessoa a chamar na DM. Para manter separado, você pode usar um app Meta separado só para comentários, ou o mesmo app com o webhook tratando tanto mensagens quanto comentários, e vincular cada integração ao bot correspondente (um canal para DM, outro para comentários).