📡 Canais

Conectar Instagram ao Chatys

Pré-requisitos

Antes de iniciar a conexão, certifique-se de que você tem:

  • Conta Instagram Business ou Creator — perfis pessoais não são suportados pela API do Meta. Para converter, acesse as configurações do seu perfil no Instagram e toque em "Mudar para conta profissional".
  • Facebook Page conectada — sua conta Instagram precisa estar vinculada a uma Página do Facebook. A conexão é feita em Configurações do Instagram → Conta → Página vinculada.
  • Acesso de Administrador ao Meta Business Manager — você precisa ter papel de Admin no Business Manager que gerencia a Página e o perfil Instagram. Acesse business.facebook.com para verificar.
  • App Meta for Developers — você precisará criar (ou ter acesso a) um aplicativo no painel de desenvolvedores do Meta com a permissão instagram_manage_messages.
  • Conta Chatys ativa com plano que inclui o canal Instagram.
Atenção: A API de Mensagens do Instagram só permite responder Direct Messages (DMs). Comentários em posts e Stories não são entregues via API. Certifique-se de alinhar as expectativas da equipe sobre essa limitação antes de conectar.

Passo 1 — Vincular Instagram ao Meta Business Manager

1
Acesse business.facebook.com e faça login com sua conta Facebook que é Admin do Business Manager.
2
No menu lateral, clique em Configurações (ícone de engrenagem) → Contas → Contas do Instagram.
3
Clique em Adicionar e faça login com as credenciais do Instagram Business que deseja conectar.
4
Confirme que a conta aparece na lista com status Ativo. Se aparecer "Pendente de revisão", aguarde até 24h para liberação.
5
Vá em Contas → Páginas e confirme que a Página do Facebook está conectada ao mesmo Business Manager.

Passo 2 — Criar App no Meta for Developers

1
Acesse developers.facebook.com e clique em Meus Apps → Criar App.
2
Selecione o tipo Business e clique em Avançar. Preencha o nome do app (ex: "Chatys Integration") e o email de contato.
3
Dentro do App criado, clique em Adicionar Produto e selecione Instagram Graph API. Clique em "Configurar".
4
Vá em Configurações do App → Básico e copie o ID do App e o Chave Secreta do App — você usará esses valores no Chatys.
5
No menu Instagram Graph API → Configuração, adicione sua Página do Facebook e autorize o escopo instagram_manage_messages e pages_messaging.
6
Solicite a permissão instagram_manage_messages em modo Live (produção). O Meta pode exigir uma revisão de app — responda com clareza que o uso é para gerenciamento de DMs via plataforma de atendimento.
Dica: Para ambientes de teste, você pode usar o modo Desenvolvimento do App sem precisar da revisão do Meta. Contas de testes adicionadas no painel de desenvolvedores conseguem enviar e receber mensagens sem aprovação formal.

Passo 3 — Adicionar canal Instagram no Chatys

Lista de canais conectados no Chatys

Tela de Canais do Chatys mostrando canais já conectados e o botão para adicionar novo

1
No painel do Chatys, acesse o menu Canais na barra lateral esquerda.
2
Clique em + Adicionar Canal no canto superior direito.
3
Na lista de tipos de canal, selecione Instagram.
Formulário para adicionar novo canal Instagram

Formulário de configuração do canal Instagram — insira as credenciais do seu App Meta

4
Preencha o formulário com o ID do App, a Chave Secreta e o Token de Acesso de Página gerado no Meta for Developers.
5
Dê um nome identificável ao canal (ex: "Instagram @suamarca") — esse nome aparecerá nas conversas e relatórios.
6
Clique em Salvar e Conectar. O Chatys verificará as credenciais e, se tudo estiver correto, o canal aparecerá como Ativo na lista.

Passo 4 — Autenticar com OAuth do Meta

1
Após salvar o canal, clique em Autenticar com Meta. Uma janela pop-up será aberta redirecionando para o login do Facebook.
2
Faça login com a conta Facebook que é Admin da Página conectada ao Instagram Business.
3
Revise as permissões solicitadas — o Chatys precisará de acesso a Gerenciar mensagens do Instagram e Gerenciar mensagens da Página. Clique em Permitir.
4
Selecione a Página do Facebook vinculada ao Instagram e confirme. Você será redirecionado de volta ao Chatys com a mensagem de autenticação bem-sucedida.
Dica: O token de acesso gerado pelo OAuth tem validade longa (60 dias), mas o Chatys renova automaticamente antes do vencimento. Você só precisará reautenticar se revogar o acesso manualmente no Meta.

Passo 5 — Configurar Webhook para receber DMs

1
No painel do Meta for Developers, acesse seu App → Instagram Graph API → Webhooks.
2
Clique em Adicionar Webhook e no campo URL de Callback cole a URL exibida pelo Chatys na tela de configuração do canal (formato: https://app.chatys.com.br/webhooks/instagram/SEU-ID).
3
No campo Token de Verificação, copie o token exibido no Chatys e cole aqui. Clique em Verificar e Salvar.
4
Após a verificação, ative os campos de assinatura: messages e messaging_postbacks. Esses são os eventos que entregam DMs ao Chatys.
5
Envie uma DM para o perfil Instagram a partir de uma conta diferente. Acesse o Chatys e verifique se a conversa apareceu na caixa de entrada em tempo real.

Limitações do canal Instagram

A API de Mensagens do Instagram possui restrições impostas pelo Meta que é importante conhecer:

  • Somente DMs: o Chatys recebe e responde apenas Direct Messages. Comentários em posts, reações e mensagens de Stories não chegam via API.
  • Janela de 24h: você só pode enviar mensagens de forma livre dentro de 24 horas após a última mensagem do usuário. Após esse prazo, só é possível enviar usando Modelos de Mensagem aprovados pelo Meta (disponível em planos avançados).
  • O usuário precisa iniciar a conversa: diferente do WhatsApp com API, o Instagram não permite contato ativo com quem nunca enviou DM para sua conta.
  • Sem envio de áudio/vídeo via API: é possível enviar imagens e links, mas vídeos e áudios não são suportados na resposta via API atualmente.
  • Conta Business ou Creator obrigatória: perfis pessoais não recebem acesso à API de mensagens.

O que é possível fazer com o Instagram no Chatys

  • Receber e responder DMs de clientes diretamente pelo painel de atendimento
  • Distribuir DMs automaticamente para agentes do time responsável
  • Usar o Agente IA para responder DMs automaticamente 24/7
  • Enviar imagens e links nas respostas
  • Aplicar tags e criar contatos no CRM a partir de DMs
  • Ver histórico unificado de conversas do cliente (WhatsApp + Instagram no mesmo perfil)
  • Gerar relatórios de atendimento separados por canal

Casos de uso — como aplicar no seu negócio

Veja como empresas de diferentes segmentos utilizam o Instagram Direct conectado ao Chatys na prática:

🛍️ E-commerce e lojas online

Loja que recebe 200 DMs por dia no Instagram não conseguia atender tudo pelo celular. Com o Chatys, a equipe de 3 atendentes divide as DMs igualmente via distribuição automática. A taxa de resposta subiu de 40% para 100% sem aumentar a equipe.

🏥 Clínicas e profissionais de saúde

Clínica estética com conteúdo forte no Instagram recebe pacientes que comentam nos Reels e mandam DM perguntando sobre procedimentos. A IA responde automaticamente com informações e convida para agendar consulta — a clínica converte 3 vezes mais DMs em agendamentos do que antes.

🏠 Imobiliárias e construtoras

Cada imóvel anunciado no Instagram gera DMs com perguntas. Um fluxo automático responde com fotos e valores e pergunta se o cliente deseja agendar visita. O corretor humano só entra quando há intenção real — tempo do profissional focado onde gera resultado.

🍕 Restaurantes e food service

Marca de moda ou lifestyle usa Stories com "Responda aqui para saber o preço" — automaticamente abre conversa no inbox do Chatys, o fluxo envia tabela de preços e link da loja, e converte sem esforço humano. A automação de Stories transforma engajamento em venda.

💼 Serviços, consultoria e SaaS

Creator com 500 mil seguidores recebe DMs de marcas para parcerias comerciais. O time de assessoria usa o Chatys para gerenciar essas DMs centralizadas e nunca perder uma oportunidade — inbox único em vez de vários celulares com acesso ao mesmo Instagram.

Melhores práticas:
  • Criar fluxo específico para respostas de Stories (diferente do DM direto) — o contexto e a intenção do cliente são diferentes em cada caso.
  • Não usar broadcast no Instagram como no WhatsApp — o canal Instagram não tem templates de mensagem ativa, respeite as limitações da API.
  • Medir taxa de conversão de DM para venda mensalmente para quantificar o ROI do Instagram conectado ao Chatys.

Problemas comuns e soluções

Mensagem: "Permissão negada ao verificar webhook" — Verifique se o Token de Verificação no Meta for Developers é idêntico (incluindo maiúsculas/minúsculas) ao token exibido no Chatys. Qualquer diferença causa falha na verificação.
Canal aparece como "Desconectado" após alguns dias — Isso ocorre quando o token de acesso é revogado no Meta. Acesse Canais no Chatys, clique no canal Instagram e selecione "Reautenticar". Repita o fluxo OAuth do Passo 4.
DMs não aparecem no Chatys — Confirme que os campos messages e messaging_postbacks estão ativos nos Webhooks do Meta for Developers. Verifique também se o App está em modo Live (não Desenvolvimento), pois no modo Desenvolvimento só contas de teste conseguem enviar mensagens.
Erro "App não tem permissão instagram_manage_messages" — A permissão foi solicitada mas ainda não aprovada pelo Meta. Verifique o status em App → Análise do App. Se rejeitada, ajuste a descrição de uso e reenvie.

Este artigo foi útil?