Canais · Atualizado em 06/10/2026

Como conectar o Instagram ao Pipe

Conecte uma conta profissional do Instagram a um fluxo do Pipe, cadastre o webhook e acompanhe o estado da conexão.

O canal Instagram liga uma conta profissional a um fluxo. As mensagens diretas recebidas nessa conta passam a aparecer no atendimento, e a equipe responde pelo Desk. A conexão usa as credenciais do aplicativo da Meta vinculado à conta.

Quando usar

Use o canal quando seus clientes costumam chamar a marca pelo Instagram. A Loja Girassol, por exemplo, recebe perguntas sobre disponibilidade de produtos nas mensagens do perfil e quer tratá-las na mesma fila das conversas de WhatsApp.

Pré-requisitos

  • Permissão para gerenciar canais e acesso de configuração ao fluxo.
  • Uma conta profissional do Instagram.
  • Acesso de administradora ou administrador ao aplicativo da Meta e à conta que será conectada.
  • O Token de acesso e a Chave secreta do aplicativo, disponíveis na Meta.

Passo a passo

  1. No portal da Gestão, abra o fluxo que atenderá as mensagens do Instagram.
  2. Clique em Canais e abra o cartão Instagram.
  3. Na aba Visão Geral, clique em Conectar Instagram.
  4. Na janela Conectar Instagram, preencha Token de acesso. O campo vem oculto; use o ícone de olho para conferir.
  5. Preencha Chave secreta do aplicativo, que fica nas configurações básicas do aplicativo na Meta.
  6. Se quiser, preencha Nome para identificar o canal.
  7. Clique em Conectar.
  8. Quando aparecer Canal conectado., copie a URL de callback e o Token de verificação e cadastre os dois na configuração de webhook do aplicativo na Meta.
  9. Clique em Concluir.
  10. Volte à aba Visão Geral e confira o nome da conta em Seu chatbot está conectado à conta:.
Página de conexão do Instagram na Gestão

Campos da janela de conexão

CampoObrigatórioO que informar
Token de acessoSimToken do aplicativo para a conta profissional. Fica oculto.
Chave secreta do aplicativoSimDisponível nas configurações básicas do aplicativo na Meta. Fica oculta.
Nome para identificar o canalNãoNome interno do canal.

Usar uma conta já conectada

Se existir uma conta livre no Pipe, ou já ligada a este fluxo, a página também mostra o botão Usar uma conta já conectada. Ele abre Ativação da conta: escolha a conta em Escolher conta e clique em Ativar conta. Contas ligadas a outro fluxo aparecem desabilitadas, com a indicação "em uso por" e o nome do fluxo. Se a conta não está na lista, use Volte e cadastre agora.

Estados da conexão

Depois de conectada, a página consulta a conta e mostra uma destas situações:

Mensagem na páginaO que significa
As mensagens desta conta aparecem no atendimento.Conta ativa e recebendo mensagens.
A autorização desta conta expirou. Atualize as credenciais para voltar a receber mensagens.A autorização precisa ser renovada. O botão Atualizar credenciais abre a janela Atualizar conexão do Instagram.
Esta conta está desligada e não recebe mensagens.O canal foi desligado.
A conta está vinculada a este bot. Não foi possível confirmar o estado da conexão agora.O Pipe não conseguiu consultar o estado naquele momento. Recarregue a página mais tarde.

Desconectar a conta

  1. Na aba Visão Geral, clique em Desconectar canal.
  2. Na janela Quer mesmo desconectar o Instagram?, escreva o motivo.
  3. Marque Eu concordo com os resultados da desconexão.
  4. Clique em Desconectar Instagram.

Resultado esperado

A conta aparece como conectada ao fluxo, o cartão Instagram da lista de canais mostra Conectado e as mensagens recebidas entram no atendimento.

Limitações

  • Um fluxo comum conecta um canal por vez: se ele já usa outro, a página pede que você o desconecte antes.
  • A aba Configurações do canal aparece marcada como em breve e ainda não executa nada.
  • A conexão é manual, com token e chave secreta; não há login guiado.

Problemas comuns

  • A janela mostra um erro ao conectar: confira se o token e a chave pertencem ao mesmo aplicativo e se não há espaços sobrando.
  • A conta não é profissional: altere o tipo da conta no Instagram e repita a conexão.
  • O canal conectou, mas não chegam mensagens: confirme que a URL de callback e o token de verificação foram cadastrados no aplicativo da Meta.
  • Apareceu o aviso de autorização expirada: use Atualizar credenciais e informe de novo o token e a chave.

Próximos passos

Perguntas frequentes

Qual conta do Instagram usar?

Uma conta profissional. A tela pede acesso de administradora ou administrador ao aplicativo e à conta que será conectada.

Onde vejo se a conta está ligada?

Em Canais > Instagram, na aba Visão Geral: a página mostra a conta conectada e uma frase sobre o estado da conexão.

A autorização da conta expirou. E agora?

A página mostra um aviso e o botão Atualizar credenciais. Informe de novo o token de acesso e a chave secreta do aplicativo.

Posso usar uma conta já cadastrada em outro fluxo?

Só se ela estiver livre. Contas ligadas a outro fluxo aparecem desabilitadas na lista, com o nome do fluxo.