Instagram DM
Conecte o Simple Agent ao Instagram Direct Messages e responda comentários automaticamente.
Com o canal Instagram, seu AI agent responde mensagens diretas (DMs) e pode ser configurado para responder comentários automaticamente — tudo via Meta Graph API.
Pré-requisitos
- Conta Instagram Business ou Creator — perfil pessoal não é suportado pela API
- Página do Facebook vinculada à conta Instagram
- Meta App com produto Instagram configurado
- Plano Simple Agent Growth ou Agency
Configuração passo a passo
1. Vincular Instagram à Página Facebook
- No Instagram → Configurações → Conta → Contas vinculadas → Facebook
- Selecione a Página correta
- Confirme que está como Administrador da Página
2. Criar o Meta App (se ainda não tiver)
- developers.facebook.com → Criar App → Business
- Adicione o produto Instagram
- Conecte sua Página → a conta Instagram é detectada automaticamente
3. Obter credenciais
No painel do app Meta → Instagram → Configuração:
| Campo | Onde encontrar |
|---|---|
| Instagram Account ID | Instagram → Configuração → Conta Instagram |
| Page Access Token | Ferramentas → Explorer de API do Graph → Token com permissão pages_messaging |
4. Conectar no Simple Agent
- Dashboard → Canais → Instagram
- Cole o Instagram Account ID e Page Access Token
- Clique em Salvar e gerar Webhook URL
5. Configurar webhook na Meta
- Meta App → Webhooks
- Adicione a URL do Simple Agent
- Assine os campos:
messages,messaging_postbacks - Verifique e salve
Funcionalidades
DMs (Direct Messages)
O agent responde automaticamente mensagens recebidas no Direct. O comportamento é idêntico ao widget web — usa o mesmo treinamento, mesmo tom, mesmas fontes.
Comentários (opcional)
Quando ativado, o agent pode:
- Responder comentários com uma mensagem padrão (ex: "Obrigado! Enviamos os detalhes por DM")
- Enviar automaticamente uma DM para quem comentou com uma palavra-chave (ex: "PREÇO")
Configure em Canais → Instagram → Gatilhos de comentário.
Limitações da API Meta
- Janela de 24h: Após a última mensagem do usuário, você tem 24h para responder com qualquer conteúdo. Fora da janela, só é possível enviar Mensagens de Template aprovadas pela Meta.
- Sem envio proativo: A API não permite iniciar conversas — apenas responder.
- Mídia: Imagens enviadas pelo usuário são analisadas via visão. Vídeos não são processados.
Troubleshooting
Agent não responde DMs:
- Confirme que o Instagram está em modo Business (não pessoal)
- Verifique se o Page Access Token tem permissão
instagram_manage_messages - Tokens de usuário expiram em 60 dias — use Token de Sistema para produção
Erro "OAuthException 200":
- A permissão
pages_messagingnão foi aprovada. Submeta o app para revisão na Meta se a conta não for de teste.
Webhook não verifica:
- O endpoint do Simple Agent aceita qualquer Verify Token que você definir — confirme que está colando o mesmo valor nos dois campos.
Permissões necessárias
Para produção (conta real, não de teste), seu app Meta precisa de revisão para:
instagram_manage_messagespages_messaginginstagram_basic
O processo de revisão leva 5–10 dias úteis e exige uma demonstração em vídeo.