Integrar Instagram pela primeira vez
A integração do Instagram conecta a conta profissional à Agilize para centralizar conversas do Direct, respostas de Story, reações, comentários em posts/Reels e comentários em lives. A conexão é feita pelo login da Meta e salva os recursos autorizados em cada Página Instagram integrada.
Use este guia quando a conta ainda não aparece em Páginas do Instagram na Agilize.
Antes de começar
Confirme estes pré-requisitos:
- a conta do Instagram é profissional, como Empresa ou Criador;
- você tem acesso administrativo à conta do Instagram e à Página do Facebook conectada;
- o Instagram está vinculado à Página do Facebook correta;
- o acesso a mensagens do Instagram está permitido nas configurações da Meta;
- o usuário que fará a conexão pode autorizar permissões no Facebook Login for Business;
- o fluxo padrão da conversa já existe, se a conta deve iniciar atendimento automático pelo Direct.
Se a conta já foi integrada antes, use o guia Ativar eventos em uma conta Instagram já integrada.
Onde acessar
Acesse https://my.agilize.app/messenger/meta/onboarding-facebook?subject=instagram_messenger.
Acesso pela tela: sidebar lateral > módulo Mensageria > Configurações > tree interna Canais Integrados > Páginas do Instagram > Integrar Nova Página.
Também é possível iniciar pelo onboarding de canais quando o card Integrar Instagram estiver disponível para sua conta.
Passo a passo
- Abra a tela de integração do Instagram.
- Leia os requisitos exibidos no card da integração.
- Clique em Integrar Instagram.
- Na janela Antes de integrar uma nova conta, revise a seleção inicial de eventos.
- Mantenha Direct selecionado. Ele é obrigatório para conversas do Instagram.
- Selecione os recursos que a conta deve escutar desde o início.
- Clique em Continuar.
- No login da Meta, escolha a conta e confirme as permissões solicitadas.
- Ao concluir, aguarde o retorno para a Agilize.
- Abra a lista de Páginas do Instagram e confira se a conta aparece integrada.
Eventos disponíveis na integração
| Evento | Quando selecionar |
|---|---|
| Direct | Sempre. Mantém recebimento e atendimento de conversas do Instagram. |
| Respostas e reações de Story | Quando a operação quer receber interações de Story junto ao Direct. |
| Reações a mensagens | Quando a equipe quer registrar curtidas ou reações enviadas nas conversas. |
| Comentários em posts/Reels | Quando a conta deve registrar comentários e permitir automações sociais. |
| Comentários em Lives | Quando a operação usa lives e quer tratar comentários durante a transmissão. |
Escolha apenas eventos que a operação pretende acompanhar. Comentários e lives geram volume adicional e devem ter regra, responsável ou rotina de revisão.
Configurações recomendadas depois da integração
Depois que a Página Instagram aparecer na lista, abra o cadastro dela e revise:
| Configuração | O que revisar |
|---|---|
| Fluxo padrão da conversa | Fluxo que será usado quando uma conversa de Direct entrar normalmente. |
| Gerar Protocolo | Se a operação usa protocolo para atendimentos desse canal. |
| Eventos do Instagram | Eventos selecionados, status de conexão e necessidade de confirmação na Meta. |
| Filtros de Story | Se reações, respostas ou menções de Story devem abrir conversa. |
| Automação social | Se comentários, respostas públicas, private reply e lives estão permitidos nessa Página. |
Para configurar comentários, veja Automações sociais para comentários do Instagram.
Como validar
Faça uma validação simples antes de divulgar a conta:
- Envie uma mensagem de teste para o Instagram integrado.
- Confirme se a conversa aparece na Agilize.
- Responda pela Agilize e confira se a mensagem chega ao Instagram.
- Se Stories estiverem ativos, envie uma resposta de Story controlada e revise se a entrada foi tratada como esperado.
- Se comentários estiverem ativos, comente em um post de teste e confira a tela Comentários Sociais.
A tela de comentários fica em https://my.agilize.app/messenger/social/comment. Acesso pela tela: sidebar lateral > módulo Mensageria > grupo Relatórios > Comentários Sociais (IG).
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| A conta não aparece depois do login | Confirme se o Instagram está vinculado a uma Página do Facebook e se o usuário tem acesso administrativo. |
| Direct funciona, mas comentários não aparecem | Revise se Comentários em posts/Reels foi selecionado e se a Página foi salva após a configuração. |
| A tela pede confirmação na Meta | Clique em Continuar na Meta no cadastro da Página para concluir a autorização dos recursos selecionados. |
| Comentários chegam, mas nenhuma resposta é enviada | Confirme se a Página permite automação social e se existe uma regra ativa em Automações Sociais. |
Próximos passos
- Para contas já conectadas, veja Ativar eventos em uma conta Instagram já integrada.
- Para criar respostas automáticas a comentários, veja Automações sociais para comentários do Instagram.
- Para organizar o fluxo do Direct, veja Fluxos do bot.
