Conectar Messenger

O Messenger no UltronChat trabalha com paginas do Facebook. Voce nao conecta seu perfil pessoal — conecta uma pagina administrada por voce. Cada conexao e uma pagina.

Pre-requisitos

1. Ter pelo menos uma pagina Facebook onde voce seja administrador.
2. Plano ativo — Essencial ou Pro.
3. Permissoes OAuth do Facebook (pages_messaging, pages_show_list, etc.) — solicitadas automaticamente no fluxo.

Passo a passo

1. Em /dashboard/connect, clicar em "Conectar Messenger"

O dashboard abre o Facebook Login for Business, que e o OAuth padrao para paginas.

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

2. Autenticar no Facebook

Entre com sua conta Facebook de administrador. A Meta mostra a lista de permissoes — autorize todas.

3. Selecionar a pagina

Voce sera levado para /dashboard/connect/select-page, que lista todas as paginas Facebook onde voce e administrador. Selecione a que quer conectar.

Screenshot: /dashboard/connect/select-page com lista de paginas e radio button.

4. Confirmar

Clique em Conectar esta pagina. O UltronChat:

1. Faz subscribe dos webhooks da pagina (necessario para receber mensagens em tempo real).
2. Cria a conexao em connections com platform = messenger, page_name, platform_page_id.
3. Redireciona para /dashboard com a conexao listada.

Multiplas paginas

Voce pode conectar varias paginas da mesma conta Facebook — cada uma vira uma conexao separada, com agente e automacoes proprias. Ate o limite do seu plano.

Janela de 24 horas

Ao contrario do Instagram, o Messenger impoe a regra das 24 horas: depois que o usuario envia uma mensagem a sua pagina, voce tem 24 horas para responder livremente. Passado isso, o envio comum e bloqueado pela Meta (codigo 10 ou similar) e apenas tags especificas ou template sao aceitas.

O UltronChat envia tudo dentro da janela — se a janela expirou, a mensagem falha e aparece no log. O ideal e sempre responder rapido, o que e precisamente o papel da IA.

Erros comuns

Erro	Causa	Solucao
"Nenhuma pagina disponivel"	Voce nao e admin de nenhuma pagina	Criar ou se tornar admin de uma pagina
Mensagem nao chega na pagina	Subscribe de webhook falhou	Reconectar a pagina em /dashboard/connect
"Assinatura HMAC invalida" em webhooks	Secret errado no Worker	Problema interno do UltronChat — abrir ticket

O que o UltronChat le e escreve

Le:

• Mensagens recebidas pela pagina.
• Comentarios em publicacoes da pagina.

Escreve:

• Responde mensagens com agente IA ou por um operador humano.
• Envia DM quando acionado por automacao de comentario.
• Responde comentarios publicamente.