# Conectar o Messenger

> Como ligar uma Página do Facebook para conversar pelo Messenger.

## 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 (`MESSAGING` ou `MANAGE`).

## 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`](/errors#signup_scope_mismatch)).

## Passo a passo

1. Abra **Conexões → Conectar Messenger**. O painel navega para o [Login do Facebook para Empresas](https://developers.facebook.com/documentation/facebook-login/facebook-login-for-business) (sem popup, funciona no celular).
2. Entre no Facebook, escolha as Páginas que o Messajo pode acessar e aceite as permissões.
3. 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.
4. Pronto: cada Página aparece como **Ativa**.

Sem nenhuma Página que dê para conectar, a tentativa termina com [`messenger_no_pages`](/errors#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](/connect/whatsapp/#convidar-o-cliente-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

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

O Messenger usa o mesmo motor e a mesma [matriz de tipos](/connect/instagram/#tipos-de-mensagem) do Instagram, com estas diferenças:

- `to` é o PSID do contato (ou o `ctc_…` do Messajo);
- texto até 2.000 caracteres; anexos até 25 MB;
- uma imagem por mensagem (sem `images`), sem `like` e sem `share`;
- o recibo de leitura da Meta (`watermark`) vira `message.status` com `read` para todas as mensagens até aquele momento.

## 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`](/errors#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`](/errors#outside_service_window).

Veja a [política do Messenger da Meta](https://developers.facebook.com/documentation/business-messaging/messenger-platform/policy).

## 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 `payload` que ele manda. O Messajo grava o "Começar" antes do menu (a Meta exige) e não deixa apagá-lo enquanto houver menu.

![Tela do perfil de mensagens de uma Página, com menu fixo e saudação](../../../assets/screenshots/messenger-profile-pt-BR.png)

## 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`](/errors#mirror_path_blocked)), e `pass_thread_control`/`take_thread_control` exigem chave com permissão `admin`.
