Conectar canais
Conectar o Messenger
Como ligar uma Página do Facebook para conversar pelo Messenger.
Requisitos
Seção intitulada “Requisitos”- Uma Página do Facebook.
- Ser admin da Página (ou ter controle total dela pelo portfólio de negócios), com uma função que permita mensagens (
MESSAGINGouMANAGE).
Permissões
Seção intitulada “Permissões”| Permissão | Para quê |
|---|---|
pages_show_list |
Listar as Páginas que você administra, para escolher qual conectar |
pages_manage_metadata |
Inscrever o app nos webhooks da Página |
pages_messaging |
Receber e enviar mensagens pelo Messenger |
pages_read_engagement |
Ler dados básicos da Página e das conversas |
business_management |
Acessar Páginas que pertencem a um portfólio de negócios |
Sem pages_messaging ou pages_manage_metadata a conexão não é criada (signup_scope_mismatch).
Passo a passo
Seção intitulada “Passo a passo”- Abra Conexões → Conectar Messenger. O painel navega para o Login do Facebook para Empresas (sem popup, funciona no celular).
- Entre no Facebook, escolha as Páginas que o Messajo pode acessar e aceite as permissões.
- De volta ao painel, se houver mais de uma Página disponível, marque em Escolha as Páginas quais conectar e toque em Conectar Páginas. Cada Página escolhida vira uma conexão. Página já conectada em outra organização ou sem função de mensagens aparece desabilitada, com o motivo.
- Pronto: cada Página aparece como Ativa.
Sem nenhuma Página que dê para conectar, a tentativa termina com messenger_no_pages. Uma falha numa Página não desfaz as outras.
Para conectar a Página de um cliente, mande um convite por link com o canal Messenger: a pessoa autoriza e escolhe as Páginas pela página pública do convite.
Token da Página
Seção intitulada “Token da Página”O token da Página não expira: não há renovação. Ao conectar, o Messajo inscreve o app na Página (subscribed_apps) para receber os webhooks; a cada 15 min confere a inscrição e, se o app sumiu da lista, inscreve de novo (connection.updated com reason: "resubscribed"). Se alguém tirar as permissões, a conexão passa para needs_reconnect (token_invalid) e o dono recebe o link de reconexão.
Mensagens
Seção intitulada “Mensagens”O Messenger usa o mesmo motor e a mesma matriz de tipos do Instagram, com estas diferenças:
toé o PSID do contato (ou octc_…do Messajo);- texto até 2.000 caracteres; anexos até 25 MB;
- uma imagem por mensagem (sem
images), semlikee semshare; - o recibo de leitura da Meta (
watermark) viramessage.statuscomreadpara todas as mensagens até aquele momento.
Janelas
Seção intitulada “Janelas”| Janela | Quando vale |
|---|---|
| 24 horas | Qualquer resposta, contada da última mensagem do contato |
| 7 dias | Depois de o contato responder a um anúncio |
| 7 dias | Com tag: "human_agent" |
tag: "human_agent" é só para resposta escrita por uma pessoa, nunca para automação, e exige o recurso Human Agent aprovado no App Review (sem ele: 403 human_agent_not_approved). As outras tags do Messenger foram descontinuadas pela Meta e não são aceitas. Fora da janela: 422 outside_service_window.
Veja a política do Messenger da Meta.
Perfil de mensagens
Seção intitulada “Perfil de mensagens”Em Conexões → (Página) → Perfil de mensagens, ou por GET/PUT /v1/connections/{id}/messaging-profile:
- Perguntas frequentes (ice breakers): até 4 por idioma;
- Menu fixo: até 20 itens, com a opção de desativar a caixa de texto;
- Saudação: até 160 caracteres, aceita
{{user_first_name}}; - Começar: o botão “Começar” e o
payloadque ele manda. O Messajo grava o “Começar” antes do menu (a Meta exige) e não deixa apagá-lo enquanto houver menu.

Camada espelho
Seção intitulada “Camada espelho”/v1/messenger/{page_id}/... repassa para a Graph com o token da Página, com corpo e resposta da Meta intactos; nós avulsos em /v1/messenger/{page_id}/nodes/{node_id}. POST …/messages grava a mensagem nos logs; subscribed_apps e as rotas de token são bloqueadas (403 mirror_path_blocked), e pass_thread_control/take_thread_control exigem chave com permissão admin.