Pra atender DMs do Instagram pelo Syncro e configurar automações de comentário, você precisa conectar sua conta Instagram Business ao Syncro via OAuth oficial Meta. Esse artigo cobre os pré-requisitos, o passo a passo de conexão e os erros mais comuns.
Pré-requisitos
Conta no Instagram
- Conta Instagram Business ou Creator (não funciona com conta pessoal).
- Se você ainda tem conta pessoal, faça a migração pelo app:
- Configurações da conta no app Instagram.
- Tipo de conta.
- Selecione Conta comercial ou Conta de criador de conteúdo.
- Idealmente vinculada a uma página do Facebook (alguns recursos exigem).
No Syncro
- Permissão de admin do tenant.
- Acesso à página
/configuracoes/integracoes.
Passo a passo
- Acesse Configurações → Integrações no menu lateral.
- Localize o card Instagram com o subtítulo "Chat de mensagens diretas (DMs)".
- Veja a lista de features prometidas:
- Chat de mensagens diretas (DMs) no CRM
- Agente de IA para atender DMs automaticamente
- Criação automática de leads a partir de DMs
- Histórico completo de conversas
- Se ainda não está conectado, aparece o botão Conectar Instagram.
- Clique em Conectar Instagram.
- Você é redirecionado pro fluxo OAuth do Meta.
- Faça login na sua conta Instagram (use a Business/Creator).
- Confirme as permissões solicitadas:
- Acessar perfil básico
- Gerenciar mensagens (DMs)
- Gerenciar comentários
- Após autorizar, é redirecionado de volta pro Syncro.
- O Syncro:
- Troca o code temporário por um token de acesso de longa duração (60 dias).
- Busca o
usernamee dados da conta via Graph API. - Salva a
InstagramInstancecomstatus='connected'. - Subscreve os webhooks automaticamente (
messages+comments).
- Card mostra Conectado ✅ com seu @username.
O que está disponível depois de conectar
- DMs chegam na caixa unificada
/chatscom badge rosa do Instagram. - Você pode enviar mensagens pra quem mandou DM (respeitando janela 24h da Meta).
- Comentários em posts entram nos webhooks pra disparar automações.
- Conversas novas criam leads automaticamente (se configurado no pipeline).
Renovação automática do token
O token Instagram tem validade de 60 dias. O Syncro:
- Renova automaticamente o token antes da expiração (cron diário).
- Se a renovação falhar (você revogou acesso, mudou senha, etc), o status muda pra Reconectar ou Desconectado.
- Você recebe notificação por email quando a renovação falha.
- Pra resolver, basta clicar Reconectar Instagram no card de Integrações.
Erros comuns
"Não foi possível conectar — Unsupported request"
Solução:
- Aguarde até 72 horas após mudança nas permissões.
- Tente reconectar.
- Se persistir, contate suporte.
"Conta pessoal não permitida"
Causa: você está tentando conectar conta Instagram pessoal, não Business/Creator.
Solução:
- Abra Instagram no celular.
- Configurações → Conta → Tipo de conta.
- Mude pra Conta comercial ou Conta de criador.
- Volte ao Syncro e tente conectar de novo.
"Página Facebook não vinculada"
Causa: alguns recursos exigem que a conta Instagram esteja vinculada a uma página Facebook.
Solução:
- Acesse business.facebook.com.
- Vincule sua conta Instagram a uma página.
- Volte e reconecte.
"Permissão negada"
Causa: você desmarcou alguma permissão crítica durante o OAuth.
Solução:
- Reconecte clicando em Conectar Instagram.
- Na tela de permissões, autorize todas as solicitadas (sem desmarcar).
"Token expirou — Reconectar"
Causa: token venceu (60 dias sem renovação) ou foi revogado.
Solução:
- Card mostra status Reconectar com cor laranja.
- Clique no botão Reconectar Instagram.
- Faça o OAuth de novo.
Conta Business com múltiplas páginas
Se sua conta Business tem várias páginas Facebook vinculadas:
- O OAuth pergunta qual conta Instagram você quer conectar.
- Selecione a desejada.
- Você só pode conectar 1 conta Instagram por vez ao Syncro (por instância).
Múltiplas contas Instagram no mesmo tenant
Hoje o Syncro suporta 1 conta Instagram por tenant (limite operacional). Se você precisa de múltiplas:
- Considere ter múltiplos tenants (separados por marca/empresa).
- Ou contate suporte pra avaliação caso a caso.
Privacidade — o que o Syncro pode acessar
Com os escopos solicitados:
- Pode ler suas DMs (apenas conversas com você).
- Pode enviar DMs em seu nome (respeitando regras Meta — janela 24h, etc).
- Pode ler comentários em posts seus.
- Pode responder a comentários em seu nome.
- Pode buscar seus posts (pra setup de automações de comentário).
O que NÃO pode:
- ❌ Acessar conversas com terceiros (que não te incluam).
- ❌ Postar fotos / vídeos / stories.
- ❌ Mudar bio / foto de perfil.
- ❌ Acessar lista de seguidores.
Você pode revogar o acesso a qualquer momento em accountscenter.facebook.com → Apps and websites.
Verificar status de conexão
A qualquer momento, vá em Configurações → Integrações e veja o badge:
- Conectado ✅ — funcionando normalmente
- Reconectar ⚠️ — token expirando ou inválido
- Desconectado ⛔ — sem conexão
Comandos de diagnóstico
Existem comandos administrativos pra diagnosticar problemas (executados pelo time Syncro):
instagram:repair-instances— verifica estado das instâncias contra a APIinstagram:repair-contacts— atualiza nomes de contatos quando mudou silenciosamente
Se você suspeita de problema, contate suporte com:
- Email da conta
- Tenant ID
- Mensagem de erro exata
- Quando começou o problema
Próximos passos
- Após conectar, configure automações de comentário.
- Atenda DMs no chat unificado.
- Pra entender Private Reply, veja Private Reply explicado.