Pular para o conteúdo

Conectar canais

Conectar o Messenger

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

  • 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ã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).

  1. Abra Conexões → Conectar Messenger. O painel navega para o Login do Facebook para Empresas (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. 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.

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.

O Messenger usa o mesmo motor e a mesma matriz de tipos 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.
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.

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

/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.