Instagram Direct Message (DM)

O gatilho Instagram Direct Message (DM) conecta uma conta Instagram Business ao agente. A partir daí, DMs, respostas a stories e menções que chegam na conta são respondidas automaticamente, usando o prompt e as ferramentas configuradas no agente.

Pré-requisitos

• Conta Instagram Business ou Creator. Conta pessoal não funciona — converta no app do Instagram em Configurações → Tipo de conta e ferramentas → Mudar para conta profissional.
• Acesso de login à conta. A autorização é feita pelo Login do Instagram (você entra com o próprio usuário e senha do Instagram, não pelo Facebook). Não é necessário vincular uma Página do Facebook.

Conectando

O Instagram é conectado como uma caixa de entrada, não dentro do editor do agente — o agente que responde é escolhido no fim do processo.

1. No painel admin, vá em Caixas de entrada e clique em Conectar caixa de entrada.
2. No grupo Instagram, escolha Instagram Direct.

3. Clique em Conectar com Instagram.

4. Uma janela popup abre com o login do Instagram. Entre com a conta que administra o perfil profissional.
5. Autorize as permissões solicitadas (ler e responder mensagens da conta profissional).
6. Quando o popup fecha, o card mostra Conectado: @seu_usuário. Clique em Continuar.
7. Escolha o agente que vai responder as DMs (ou deixe no atendimento humano), confirme o nome da caixa e clique em Concluir.

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 pela API do Instagram.
• A resposta aparece no Direct do usuário como se você tivesse digitado.

Mensagens enviadas pela própria conta (por você, pelo app do Instagram) não acionam o agente — ele só responde a quem escreve para a conta.

Assumindo a conversa (atendimento humano)

Em Conversas, você pode clicar em Assumir para pausar a IA e responder manualmente: a sua mensagem é entregue no Direct do cliente. O atendimento humano pode responder em até 7 dias após a última mensagem do cliente.

Desconectando

Em Caixas de entrada, abra o menu ⋮ da caixa do Instagram, clique em Editar e, no bloco Conexão, clique em Desconectar. O SquadOS para de receber webhooks da conta imediatamente, e a inscrição do lado da Meta também é removida.

Desconectar preserva o histórico das conversas. Excluir a caixa é outra coisa — veja Caixas de entrada.

Token e renovação

O token da Meta vale 60 dias e é renovado automaticamente pelo SquadOS antes de expirar. Se a renovação falhar (por exemplo, se você revogou o acesso do app no Instagram), a caixa mostra um aviso e você precisa reconectar: em Caixas de entrada, use Editar e clique em Conectar com Instagram de novo.

Limites e observações

• A Meta impõe rate limits por conta profissional. Em volumes muito altos, mensagens podem demorar para ser entregues.
• O Instagram só entrega DMs por webhook para contas profissionais — contas pessoais recém-convertidas começam a receber webhooks alguns minutos depois da conversão.
• O agente não consegue iniciar conversa por DM — só responder a quem mandou mensagem primeiro (regra da Meta).
• A janela de resposta automática é de 24h após a última mensagem do usuário. Depois disso, só o atendimento humano (Assumir) consegue responder, dentro da janela de 7 dias.

Problemas comuns

• “Popup bloqueado”: libere popups do navegador para app.squados.io.
• “Token expirado”: a renovação automática falhou. Em Caixas de entrada, abra a caixa com Editar e clique em Conectar com Instagram novamente para reautorizar.
• DMs não chegam: confirme que a conta está em modo Business ou Creator. Aguarde alguns minutos após a conexão para o webhook estabilizar.
• “Não foi possível conectar”: a conta usada no login não é profissional, ou a autorização foi cancelada antes do fim. Converta a conta e tente de novo.