Instagram Direto (DM)

O gatilho Instagram Direto (label real no produto) conecta uma conta business do Instagram ao agente. A partir dai, DMs, respostas a stories e menções que chegam na conta são respondidos automaticamente, usando o prompt e as ferramentas configuradas no agente.

Pre-requisitos

Conta Instagram Business ou Creator. Conta pessoal não funciona — converta no app do Instagram em Configurações -> Conta -> Mudar para conta profissional.
Página do Facebook vinculada a conta do Instagram. A API da Meta exige esse vinculo mesmo para contas business gerenciadas direto pelo Instagram.
Permissoes para autorizar: você precisa ser admin da página do Facebook na hora da autorização.

Conectando

Abra o agente no painel admin.
Vá para Gatilhos.
No card Instagram Direto, clique em Conectar Instagram.
Uma janela popup abre com o login do Instagram/Meta. Faca login com a conta que administra o perfil business.
Autorize as permissoes solicitadas (envio/leitura de DMs, gerenciamento da conta business).
Quando o popup fecha, o card mostra Conectado: @seu_usuário.

Se o navegador bloquear o popup, libere popups para app.squados.io e tente novamente.

Como funciona

O Instagram dispara um webhook para o SquadOS toda vez que chega uma DM.
O SquadOS cria (ou continua) uma conversa por contato do Instagram.
O agente processa a mensagem com seu prompt + ferramentas + base de conhecimento e responde via Graph API.
A resposta aparece no Direct do usuário como se você tivesse digitado.

A mesma conta de Instagram pode ser usada simultaneamente pelo gatilho Instagram Comentarios — você conecta uma vez, mas os dois gatilhos são independentes.

Desconectando

No mesmo card, clique em Desconectar. O SquadOS para de receber webhooks da conta imediatamente. A integração do lado Meta também e desinscrita.

Token e renovação

O token da Meta vale 60 dias e e renovado automaticamente pelo SquadOS antes de expirar. Se a renovação falhar (ex: você revogou as permissoes no Facebook), o card mostra um aviso e você precisa reconectar clicando em Conectar Instagram de novo.

Limites e observações

A Meta impoe rate limits por conta business. Em volumes muito altos, mensagens podem demorar para serem entregues.
O Instagram so entrega DMs por webhook para contas business — contas pessoais convertidas em business comecam a receber webhooks alguns minutos depois da conversão.
O agente não consegue iniciar conversa por DM — so responder a quem mandou primeiro (regra da Meta para Instagram Direct).
A janela de resposta padrão do Instagram e de 24h após a última mensagem do usuário. Após esse prazo, so e possível responder com templates aprovados (que ainda não são suportados pelo SquadOS).

Problemas comuns

“Popup bloqueado”: libere popups do navegador para app.squados.io.
“Token expirado”: a renovação automática falhou. Clique em Conectar Instagram novamente para reautorizar.
DMs não chegam: confirme que a conta esta em modo Business ou Creator e tem página do Facebook vinculada. Aguarde alguns minutos após a conexão para o webhook estabilizar.
“Could not connect”: você não tem permissão de admin na página do Facebook vinculada. Peca para o administrador conectar, ou ganhe permissão no Business Manager.