Conectar Instagram

O UltronChat usa o Instagram Business Login da Meta para acessar comentarios, DMs e stories. Isso exige que sua conta do Instagram esteja configurada como Profissional (Creator ou Business) e vinculada a uma pagina do Facebook.

Pre-requisitos

1. Conta Instagram configurada como Profissional

   • No app do Instagram: Configuracoes > Conta > Mudar para conta profissional.
   • Selecione categoria e tipo (Negocios ou Criador de conteudo).

2. Pagina Facebook vinculada

   • Na conta Instagram: Configuracoes > Privacidade da conta > Contas vinculadas > Facebook.
   • Vincule uma pagina (nao um perfil pessoal).

3. Plano ativo no UltronChat — Essencial ou Pro.

4. Voce e administrador da pagina Facebook vinculada — o OAuth so retorna paginas onde voce tem permissoes administrativas.

Passo a passo

1. Ir para /dashboard/connect

Na sidebar, clique em Conectar conta. Voce vai para a tela com tres cards de plataforma.

Screenshot: /dashboard/connect com card Instagram em destaque.

2. Iniciar OAuth do Instagram

Clique em Conectar Instagram. O dashboard chama /api/oauth/instagram que monta a URL de login da Meta com:

• client_id = INSTAGRAM_APP_ID (app configurado no Meta Developers)
• redirect_uri = {origem}/api/oauth/callback
• Scopes necessarios para ler comentarios, stories e enviar DMs

3. Autenticar na Meta

Voce sera levado para o login do Instagram/Facebook. Faca login com a conta que administra a pagina Facebook vinculada. A Meta pede confirmacao dos escopos solicitados.

Screenshot: dialogo de permissoes da Meta (lista de scopes).

4. Conceder acesso

Autorize todos os scopes solicitados. Se voce desmarcar qualquer item, o UltronChat pode falhar ao enviar DM ou responder comentarios mais tarde.

5. Retorno para o dashboard

Apos autorizar, a Meta redireciona de volta para /api/oauth/callback?code=.... O UltronChat troca o code por um token de longa duracao, criptografa, grava em connections, e redireciona voce para /dashboard com a conexao ja ativa.

Screenshot: overview do dashboard com a conexao Instagram recem-criada.

Proximo passo

Apos conectar, configure seu Agente de IA e crie sua primeira automacao.

Erros comuns

Erro	Causa	Solucao
"Invalid Request: Invalid redirect_uri"	Dominio atual nao esta na whitelist do Meta App	Abrir ticket; veja docs/runbooks/meta-oauth.md#troca-dominio-oauth no repo
"This account doesn't have permission"	Voce nao administra nenhuma pagina vinculada	Vincular pagina Facebook onde voce e admin
OAuth retorna mas conexao nao aparece	Erro silencioso no callback	Abrir ticket com timestamp

O que o UltronChat le e escreve no Instagram

Le:

• Comentarios nos seus posts.
• Mencoes em stories direcionadas a sua conta.
• DMs recebidas.
• Informacoes basicas de quem comenta (username, foto, se e verificado, se segue).
• Lista de posts recentes (para listar em automacoes por post especifico).

Escreve:

• Responde comentarios publicamente (texto curto).
• Envia DMs privadas para quem comentou.
• Envia respostas de DM via IA quando configurado.

Nada alem disso. O UltronChat nao posta no seu feed, nao curte, nao segue outras contas, nao altera biografia.