DOCS

Integrar Instagram pela primeira vez

Passo a passo para conectar uma nova conta do Instagram à Agilize, escolher eventos iniciais e validar Direct, Stories, comentários e lives.

Administrador

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.

Ciclo da integração
Carregando diagrama...
A conta precisa estar preparada na Meta antes de receber eventos e executar automações 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

  1. Abra a tela de integração do Instagram.
  2. Leia os requisitos exibidos no card da integração.
  3. Clique em Integrar Instagram.
  4. Na janela Antes de integrar uma nova conta, revise a seleção inicial de eventos.
  5. Mantenha Direct selecionado. Ele é obrigatório para conversas do Instagram.
  6. Selecione os recursos que a conta deve escutar desde o início.
  7. Clique em Continuar.
  8. No login da Meta, escolha a conta e confirme as permissões solicitadas.
  9. Ao concluir, aguarde o retorno para a Agilize.
  10. Abra a lista de Páginas do Instagram e confira se a conta aparece integrada.

Eventos disponíveis na integração

EventoQuando selecionar
DirectSempre. Mantém recebimento e atendimento de conversas do Instagram.
Respostas e reações de StoryQuando a operação quer receber interações de Story junto ao Direct.
Reações a mensagensQuando a equipe quer registrar curtidas ou reações enviadas nas conversas.
Comentários em posts/ReelsQuando a conta deve registrar comentários e permitir automações sociais.
Comentários em LivesQuando 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çãoO que revisar
Fluxo padrão da conversaFluxo que será usado quando uma conversa de Direct entrar normalmente.
Gerar ProtocoloSe a operação usa protocolo para atendimentos desse canal.
Eventos do InstagramEventos selecionados, status de conexão e necessidade de confirmação na Meta.
Filtros de StorySe reações, respostas ou menções de Story devem abrir conversa.
Automação socialSe 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:

  1. Envie uma mensagem de teste para o Instagram integrado.
  2. Confirme se a conversa aparece na Agilize.
  3. Responda pela Agilize e confira se a mensagem chega ao Instagram.
  4. Se Stories estiverem ativos, envie uma resposta de Story controlada e revise se a entrada foi tratada como esperado.
  5. 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

SintomaO que verificar
A conta não aparece depois do loginConfirme 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 aparecemRevise 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 MetaClique em Continuar na Meta no cadastro da Página para concluir a autorização dos recursos selecionados.
Comentários chegam, mas nenhuma resposta é enviadaConfirme se a Página permite automação social e se existe uma regra ativa em Automações Sociais.

Próximos passos