Protocolo de transferência do Messenger: partilhar a caixa de entrada de uma Página entre um agente de IA e pessoas
A Meta substituiu o protocolo de transferência do Messenger pelo Conversation Routing, que mantém as chamadas de controlo de conversas: pass_thread_control passa uma conversa a outra aplicação, como a caixa de entrada da Página com o ID de aplicação 263902037430900, take_thread_control assume-a, request_thread_control pede-a e release_thread_control devolve-a ao estado inativo. Com o Conversation Routing ativo, a aplicação que controla uma conversa recebe as suas mensagens, e as restantes recebem-nas no canal standby.
O easyCoexistence dá ao seu agente de IA as conversas do Messenger de uma Página através de um único conector MCP: send_social_dm responde dentro da janela de 24 horas e as novas mensagens são encaminhadas para o seu endpoint à medida que chegam.
O target_app_id que a Meta atribui para passar o controlo de uma conversa à caixa de entrada da Página.
Subcódigo, no erro 10, para uma mensagem que falhou porque outra aplicação controla a conversa.
Sem uma mensagem da pessoa durante este período, a conversa fica inativa, e só a aplicação predefinida pode então enviar.
Até onde extend_thread_control consegue prolongar o controlo de uma aplicação para além da janela de tempo de resposta de 24 horas.
Assumir o controlo das conversas com o seu Business AI. Com a opção desligada, os envios sem etiqueta para uma conversa do Business AI falham com 10, 2018300.
O que aconteceu ao protocolo de transferência?
A Meta integrou-o no Conversation Routing. O guia da Meta diz que a Meta deixou de suportar o protocolo de transferência do Messenger, que as empresas já foram migradas para o Conversation Routing e que o encaminhamento é compatível com a maioria das chamadas do protocolo anterior, pelo que pass_thread_control, take_thread_control e o webhook messaging_handovers devem continuar a funcionar. O que mudou foi quem decide: a empresa define uma aplicação predefinida e as regras de encaminhamento nas definições da sua Página, em Conversation Routing.
Quem controla uma conversa?
Uma aplicação de cada vez, a que a Meta chama o proprietário da conversa. Uma conversa está ativa enquanto a pessoa e a aplicação proprietária estão a falar, e inativa quando a pessoa não escreve há 24 horas ou o proprietário libertou o controlo; numa conversa inativa só a aplicação predefinida pode enviar, dentro da janela de envio. As regras de encaminhamento decidem quem assume uma conversa:
- Aplicação predefinida: a que responde quando nenhuma outra aplicação está configurada ou a responder.
- Encaminhamento social: a aplicação que assume o controlo quando a pessoa abre uma conversa inativa ou toca em Get Started.
- Encaminhamento por ligação: uma aplicação atribuída a cada ligação m.me.
- Encaminhamento por campanha: a aplicação escolhida para um anúncio Click-to-Messenger, que controla essa conversa durante a janela de mensagens dessa conversa, até 7 dias.
Que chamadas mudam o controlo entre aplicações?
Cada uma é um POST para um edge da Página com recipient definido como o PSID da pessoa, e cada uma responde com success true; a maioria também aceita uma string de metadados que a aplicação seguinte recebe:
pass_thread_control: passa a conversa à aplicação indicada emtarget_app_id, que recebe um eventomessaging_handovers.release_thread_control: termina o controlo da aplicação e devolve a conversa ao estado inativo.take_thread_control: torna a aplicação que faz a chamada proprietária, para as aplicações que a empresa autoriza a assumir o controlo.request_thread_control: pede o controlo da conversa.extend_thread_control: mantém o controlo para além da janela de tempo de resposta de 24 horas, até 7 dias, com a duração em segundos.- A Send API pode passar ou libertar o controlo com a própria mensagem, através de um objeto
thread_control.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Como é que as pessoas intervêm na caixa de entrada da Página?
Ao responder. O Conversation Routing trata a caixa de entrada do Meta Business Suite como mais uma aplicação ligada, que a empresa pode até tornar predefinida; quando alguém responde ali numa conversa que a caixa de entrada não controla, ou a move para a pasta Principal, a caixa de entrada assume o controlo. Uma aplicação entrega uma conversa às pessoas com pass_thread_control e target_app_id 263902037430900, e uma aplicação que transmite a resposta de uma pessoa depois da janela de 24 horas envia-a com a etiqueta HUMAN_AGENT, dentro de 7 dias da última mensagem da pessoa.
O que acontece quando o Business AI da Meta é proprietário de uma conversa?
As outras aplicações recebem as mensagens da pessoa no canal standby e não as devem responder. O guia da Meta diz para começar a responder depois de um evento messaging_handovers com pass_thread_control; uma notificação messages pode trazer admin_text e um handoff_reason, como human_requested ou purchase_intent, mas não transfere o controlo. Com a opção Assumir o controlo das conversas com o seu Business AI desligada, que é a predefinida, um envio sem etiqueta para essa conversa falha com o código 10, subcódigo 2018300.
Como é que uma aplicação verifica quem é proprietária de uma conversa?
GET /{page-id}/thread_owner com recipient definido como o PSID devolve o app_id da aplicação proprietária e a data em que o seu controlo expira, à própria proprietária ou à aplicação predefinida da Página. O campo is_owner da Conversations API responde à mesma pergunta por conversa, quando o Conversation Routing estiver ativo, e GET /{page-id}?fields=messaging_feature_status mostra o estado do Conversation Routing da Página em campos como msgr_multi_app.
O que acontece sem o Conversation Routing?
A Meta chama-lhe comportamento predefinido, pensado para uma Página com uma aplicação ligada que recebe e responde às mensagens por conta própria. Todas as aplicações ligadas recebem os webhooks de mensagens e podem responder à mesma mensagem, take_thread_control fica bloqueado até ser definida uma aplicação predefinida, e só o encaminhamento por campanha está disponível. A orientação da Meta para esta configuração é coordenar a aplicação e a caixa de entrada da Página para que ninguém responda duas vezes à mesma mensagem.
O que faz o easyCoexistence numa caixa de entrada partilhada?
Subscreve cada Página a feed, messages e mention, e não a messaging_handovers, standby ou message_echoes; assim encaminha as mensagens da pessoa, que a sua aplicação recebe, mas não vê eventos de transferência nem as respostas enviadas a partir da caixa de entrada da Página. send_social_dm envia uma RESPONSE sem thread_control e, quando a Meta recusa um envio porque outra aplicação detém a conversa, a ferramenta devolve ao seu AI o código 10 e a mensagem da Meta. As chamadas de controlo de conversa, thread_owner e is_owner não estão entre as suas ferramentas.
Erros comuns
- Responder a mensagens em standby. Chegam a uma aplicação que não é proprietária da conversa; aguarde por pass_thread_control antes de responder.
- Ler admin_text como uma transferência. Uma notificação messages com contexto de transferência não transfere o controlo; quem o faz é o evento messaging_handovers.
- Manter uma IA e a caixa de entrada em paralelo sem encaminhamento. Com o comportamento predefinido, ambas recebem a mensagem, e a Meta pede coordenação para evitar duas respostas.
- Manter uma conversa depois de o fluxo terminar. A Meta recomenda libertar o controlo assim que a aplicação terminar, em vez de esperar que o tempo de resposta expire.
As chamadas de controlo de conversa da Meta não estão entre as suas ferramentas; uma pessoa assume uma conversa respondendo na caixa de entrada da Página. De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Duas aplicações numa mesma Página precisam do Conversation Routing?
A Meta recomenda-o quando várias aplicações de mensagens estão ligadas e cada uma deve responder a certas conversas. Com uma só aplicação a receber e a responder, o comportamento predefinido basta.
Durante quanto tempo uma aplicação mantém o controlo de uma conversa?
Até libertar o controlo ou até a conversa ficar inativa, 24 horas depois da última mensagem da pessoa. extend_thread_control acrescenta tempo, até 7 dias.
Uma resposta enviada a partir da caixa de entrada chega a outras aplicações?
Chega às aplicações subscritas a message_echoes, como eco cujo app_id é o da caixa de entrada da Página, 263902037430900, tal como descreve o registo de alterações da Meta para a Graph API v12.0 e posteriores.
O que acontece às respostas do easyCoexistence quando uma pessoa responde a partir da caixa de entrada?
Com o Conversation Routing ativo, a caixa de entrada assume o controlo; até o controlo voltar, as mensagens da pessoa chegam à aplicação do easyCoexistence apenas no standby, canal que não subscreve. Sem encaminhamento, ambas continuam a recebê-las.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em