Conexoes — visao geral

Uma conexao e um vinculo entre sua conta UltronChat e uma conta profissional do Instagram, pagina do Facebook (Messenger) ou numero WhatsApp Business. Cada conexao tem:

• Um agente de IA dedicado (1 por conexao).
• Automacoes proprias (por exemplo, uma conexao do Instagram pode ter automacao de ebook, enquanto outra do Messenger tem automacao de orcamento).
• Conversas, mensagens e leads isolados por conexao.
• Um token OAuth criptografado (AES-256-GCM) usado para enviar DMs e responder comentarios.

Plataformas suportadas

Plataforma	Disponivel no	Requer
Instagram	Essencial e Pro	Conta Profissional vinculada a uma pagina Facebook
Messenger	Essencial e Pro	Pagina Facebook administrada por voce
WhatsApp	Apenas Pro	WhatsApp Business Account (WABA) + numero registrado

Veja o guia especifico de cada plataforma:

• Conectar Instagram
• Conectar Messenger
• Conectar WhatsApp

Arquitetura da integracao

Dashboard (Next.js)
   │ inicia OAuth
   ▼
Meta Login Dialog (Instagram | Facebook | WhatsApp)
   │ redirect com code
   ▼
Dashboard /api/oauth/[platform]/callback
   │ troca code por access_token
   │ criptografa token (AES-256-GCM)
   │ grava em connections
   ▼
Webhooks da Meta
   │
   ▼
Cloudflare Worker (webhook-gateway)
   │ valida HMAC
   │ enfileira no QStash
   ▼
Supabase Edge Functions
   (automation-engine, ai-responder, lead-collector, messaging-service)
   │ decripta token
   │ responde comentarios, envia DMs, coleta leads

Voce nunca ve ou manipula o token — ele fica criptografado no banco e so e decriptado temporariamente dentro das Edge Functions na hora de chamar a API da Meta.

Conexao multi-conta

Voce pode ter varias conexoes da mesma plataforma. Exemplo (no Pro):

• 2 contas Instagram (marcas diferentes).
• 1 pagina Messenger.
• 2 numeros WhatsApp.

Cada uma com agente e automacoes proprios. O teto total e 5 (Pro) ou 2 (Essencial) — veja Quotas e limites.

Gestao

Todas as conexoes aparecem em dois lugares:

1. Sidebar do dashboard — cada conexao vira um item expansivel com submenus Agente IA, Automacoes, Live Chat, Leads, Insights.
2. /dashboard/connect — lista com status (ativo/inativo), avatar, data de criacao, botao para desativar.

Screenshot: sidebar com 2 conexoes expandidas.

Quando uma conexao "quebra"

• Token expirado ou revogado — pode acontecer se voce retirar o acesso do UltronChat nas configuracoes da Meta. A solucao e reconectar em /dashboard/connect.
• Chave de criptografia mudou — detalhado em docs/runbook-incidents.md no repo. Requer reconexao por ser irreversivel.
• Plano rebaixado (WhatsApp) — se voce faz downgrade de Pro para Essencial, conexoes WhatsApp deixam de enviar mensagens.