Instagram

O canal Instagram permite que seu Agente envie e receba mensagens diretas do Instagram por meio da Zaia.

Conectar um canal Instagram

Abra as configurações do canal

1. Vá até Channels.
2. Abra o canal Instagram.
3. Clique no ícone de lápis.
4. Em Connection, clique no ícone de mais.

Crie a conexão

1. Digite um nome para a conexão.
2. Clique em Connect.
3. Conclua o fluxo de login do Instagram na nova aba.

Aprove o acesso do Instagram

Durante a autenticação, o Instagram pode pedir que você:

• Digite as credenciais da conta.
• Conclua a verificação com um código de backup.
• Confirme Save Info.
• Revise as permissões e clique em Allow.

Quando a mensagem de sucesso aparecer, feche a aba.

Finalize a configuração na Zaia

1. Volte para as configurações do canal.
2. Selecione a nova conexão.
3. Clique em Update channel.
4. Volte para Channels.
5. Ative o toggle do canal.

Após a ativação, o canal fica pronto para receber e enviar mensagens do Instagram.

Valide a conexão

Use este teste rápido após a configuração:

1. Envie uma mensagem para a conta Instagram conectada.
2. Aguarde a resposta do Agente.
3. Abra o Chat History e confirme que a conversa aparece com as mensagens trocadas.

Isso confirma a conexão, o fluxo de entrega e a sincronização das mensagens.

---

Human support no Instagram

Os canais do Instagram oferecem suporte à assunção humana dentro da Zaia.

Para atender uma conversa manualmente:

1. Abra a conversa em Atendimentos ou Conversas.
2. Clique em Assumir atendimento.
3. Envie a resposta como atendente humano.
4. Aguarde a resposta do usuário.
5. Clique em Marcar como finalizada quando o ticket for concluído.

Enquanto o ticket estiver em andamento, o Agente para de responder. O chat permanece aberto. Se o contato precisar de humano de novo, use Retomar atendimento no painel Informações do atendimento. Guia: Tickets.

Nota

Para conversas elegíveis fora da janela padrão de 24 horas de mensagens do Instagram, a Zaia envia respostas humanas usando o fluxo de permissão Human Agente da Meta.

Esse é o fluxo usado quando um humano precisa continuar o atendimento após a janela padrão de resposta.

---

Assunção manual fora da Zaia

Os canais do Instagram também oferecem suporte à assunção manual fora da Zaia.

Na Visão Geral do canal, em Assumir conversa fora da plataforma, ligue Habilitar assumir a conversa manualmente e interromper as respostas do Agente.

Quando a opção está ligada:

• Mensagens proativas enviadas de outra plataforma são tratadas como mensagens humanas.
• A plataforma abre um ticket Pendente.
• O Agente para de responder a essa conversa enquanto o atendimento humano estiver ativo.

Guia: Tickets.

Devolver o controle ao Agente

O Instagram exige uma confirmação extra antes que o Agente retome o controle.

1. Reaja à última mensagem do usuário com o emoji pré-configurado.
2. Envie uma nova mensagem.

Ambas as etapas são obrigatórias.

---

Automações a partir da conexão Instagram

Quando uma conexão do Instagram já está válida na Zaia, as automações de Instagram - Novo comentário reutilizam essa conexão. Não é preciso autenticar de novo.

1. Abra Builder → Recursos → Automações.
2. Crie uma automação de Evento externo.
3. Em Origem, selecione Instagram.
4. Em Conexão Instagram, escolha a conexão ativa.

Comentários do Instagram usam essa origem nativa. Origem = Composio serve para outros eventos de conexões MCP — não para o comentário nativo.

O ponto de entrada do workflow fica no node Gatilho de automação. O vínculo com a conexão fica em Automações ou no painel do próprio node, quando o workflow nasce de um template. As execuções aparecem em Execuções com origem Gatilho.

No node Message Sending, a mesma conexão envia Responder comentário publicamente, Responder comentário na DM ou Mensagem direta.

Guia: Automações.