Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

263902037430900

O target_app_id que a Meta atribui para passar o controlo de uma conversa à caixa de entrada da Página.

2018300

Subcódigo, no erro 10, para uma mensagem que falhou porque outra aplicação controla a conversa.

24 hours

Sem uma mensagem da pessoa durante este período, a conversa fica inativa, e só a aplicação predefinida pode então enviar.

Up to 7 days

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.

Off by default

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 em target_app_id, que recebe um evento messaging_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.
Handing a conversation to the Page Inbox
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.

1AI agentThe app that owns the thread replies to the person
2Hand overpass_thread_control to 263902037430900
3Page inboxPeople answer; a reply there also takes control
4IdleReleased, or 24 hours without a message from the person

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.
Fazer isto com a EasyCoexistence

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