Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Protocolo de traspaso de Messenger: compartir la bandeja de una Página entre un agente de IA y personas

Meta reemplazó el protocolo de traspaso de Messenger por Conversation Routing, que mantiene sus llamadas de control de conversación: pass_thread_control pasa una conversación a otra app, como la bandeja de la Página con el app ID 263902037430900, take_thread_control la reclama, request_thread_control pide el control y release_thread_control la deja en estado inactivo. Con Conversation Routing activado, la app que controla una conversación recibe sus mensajes y las demás los reciben por el canal standby.

easyCoexistence da a tu agente de IA las conversaciones de Messenger de una Página mediante un solo conector MCP: send_social_dm responde dentro de la ventana de atención de 24 horas y los mensajes nuevos se reenvían a tu endpoint al llegar.

263902037430900

El target_app_id que Meta asigna para pasar el control de una conversación a la bandeja de la Página.

2018300

Subcódigo, bajo el error 10, para un mensaje que falló porque otra app controla la conversación.

24 hours

Sin un mensaje de la persona durante este tiempo, la conversación pasa a inactiva y solo la app predeterminada puede enviar.

Up to 7 days

Hasta dónde puede extender extend_thread_control el control de una app más allá del plazo de respuesta de 24 horas.

Off by default

Toma el control de conversaciones con tu Business AI; mientras está desactivado, los envíos sin etiqueta a una conversación de Business AI fallan con 10, 2018300.

¿Qué pasó con el protocolo de traspaso?

Meta lo integró en Conversation Routing. Su guía dice que Meta ya no admite el protocolo de traspaso para Messenger, que los negocios han migrado a Conversation Routing y que el enrutamiento es compatible con la mayoría de las llamadas del protocolo, así que se espera que pass_thread_control, take_thread_control y el webhook messaging_handovers sigan funcionando. Lo que cambió es quién decide: el negocio define una app predeterminada y reglas de enrutamiento en la configuración de su Página, en Conversation Routing.

¿Quién controla una conversación?

Una sola app a la vez, a la que Meta llama propietario de la conversación. Una conversación está activa mientras la persona y la app propietaria se comunican, e inactiva cuando la persona no ha escrito durante 24 horas o el propietario liberó el control; en una conversación inactiva solo la app predeterminada puede enviar, dentro de la ventana de atención. Las reglas de enrutamiento deciden quién toma una conversación:

  • App predeterminada: la que responde cuando no hay otra app configurada o cuando la otra no responde.
  • Enrutamiento social: la app que toma el control cuando la persona abre una conversación inactiva o pulsa Get Started.
  • Enrutamiento por enlace: una app asignada a cada enlace m.me.
  • Enrutamiento por campaña: la app elegida para un anuncio Click-to-Messenger, que controla esa conversación durante la ventana de atención, hasta 7 días.

¿Qué llamadas mueven el control entre apps?

Cada una es un POST a un edge de la Página, con recipient configurado al PSID de la persona, y cada una responde success true; la mayoría también acepta una cadena metadata que recibe la siguiente app:

  • pass_thread_control: pasa la conversación a la app en target_app_id, que recibe un evento messaging_handovers.
  • release_thread_control: termina el control de la app y devuelve la conversación al estado inactivo.
  • take_thread_control: hace que la app que llama sea la propietaria, para las apps que el negocio permite tomar el control.
  • request_thread_control: pide el control de la conversación.
  • extend_thread_control: mantiene el control más allá del plazo de respuesta de 24 horas, hasta 7 días, con duration en segundos.
  • La Send API puede pasar o liberar el control junto con el mensaje, mediante un 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 }

¿Cómo intervienen las personas en la bandeja de la Página?

Respondiendo. Conversation Routing trata la bandeja de Meta Business Suite como una app conectada más, que incluso un negocio puede hacer predeterminada; cuando alguien responde allí en una conversación que la bandeja no controla, o la mueve a la carpeta Principal, la bandeja toma el control. Una app entrega una conversación a personas con pass_thread_control y target_app_id 263902037430900, y una app que reenvía la respuesta de una persona después de la ventana de 24 horas la envía con la etiqueta HUMAN_AGENT, dentro de los 7 días posteriores al último mensaje de la persona.

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

¿Qué pasa cuando Business AI de Meta es propietario de una conversación?

Las demás apps reciben los mensajes de la persona por el canal standby y no deberían responderlos. La guía de Meta indica empezar a responder tras un evento messaging_handovers con pass_thread_control; una notificación messages puede traer admin_text y un handoff_reason como human_requested o purchase_intent, pero no transfiere la propiedad. Con Tomar el control de conversaciones con tu Business AI desactivado, que es la opción predeterminada, un envío sin etiqueta a esa conversación falla con código 10, subcódigo 2018300.

¿Cómo comprueba una app quién es propietario de una conversación?

GET /{page-id}/thread_owner con recipient configurado al PSID devuelve el app_id de la app propietaria y cuándo expira su control, al propio propietario o a la app predeterminada de la Página. El campo is_owner de la Conversations API responde lo mismo por conversación una vez activado el enrutamiento, y GET /{page-id}?fields=messaging_feature_status muestra el estado de Conversation Routing de la Página en campos como msgr_multi_app.

¿Qué pasa sin Conversation Routing?

Meta lo llama comportamiento predeterminado, pensado para una Página con una sola app conectada que recibe y responde mensajes por sí sola. Todas las apps conectadas reciben los webhooks de mensajes y pueden responder al mismo mensaje, take_thread_control queda bloqueada hasta que se configura una app predeterminada, y solo está disponible el enrutamiento por campaña. La recomendación de Meta para esta configuración es coordinar la app y la bandeja de la Página para que nadie responda dos veces al mismo mensaje.

¿Qué hace easyCoexistence en una bandeja compartida?

Se suscribe a cada Página a feed, messages y mention, no a messaging_handovers, standby ni message_echoes, así que reenvía los mensajes de la persona mientras su app los recibe, y no ve ni eventos de traspaso ni respuestas enviadas desde la bandeja de la Página. send_social_dm envía una RESPONSE sin thread_control, y cuando Meta rechaza un envío porque otra app tiene la conversación, la herramienta devuelve a tu IA el código 10 de Meta y su mensaje. Las llamadas de control de conversación, thread_owner e is_owner no están entre sus herramientas.

Errores comunes

  • Responder mensajes en standby. Llegan a una app que no es propietaria de la conversación; espera a pass_thread_control antes de responder.
  • Leer admin_text como traspaso. Una notificación messages con contexto de traspaso no transfiere la propiedad; eso lo hace el evento messaging_handovers.
  • Ejecutar una IA y la bandeja en paralelo sin enrutamiento. Con el comportamiento predeterminado ambas reciben el mensaje, y Meta pide coordinarlas para evitar dos respuestas.
  • Retener una conversación después de terminar el flujo. Meta recomienda liberar el control en cuanto la app termina, en lugar de esperar a que venza el plazo de respuesta.
Hacerlo con EasyCoexistence

Las llamadas de control de conversación de Meta no están entre sus herramientas; una persona toma una conversación respondiendo en la bandeja de la Página. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Necesitan Conversation Routing dos apps en una misma Página?

Meta lo recomienda cuando hay varias apps de mensajería conectadas y cada una debe responder a ciertas conversaciones. Con una sola app que recibe y responde, el comportamiento predeterminado basta.

¿Cuánto tiempo mantiene una app el control de una conversación?

Hasta que lo libera o la conversación pasa a inactiva, 24 horas después del último mensaje de la persona. extend_thread_control añade tiempo, hasta 7 días.

¿Llega a otras apps una respuesta enviada desde la bandeja de la Página?

Las apps suscritas a message_echoes la reciben como un echo cuyo app_id es el de la bandeja de la Página, 263902037430900, tal como describe el changelog de Meta para Graph API v12.0 y posteriores.

¿Qué pasa con las respuestas de easyCoexistence cuando una persona responde desde la bandeja?

Con Conversation Routing activado, la bandeja toma el control, y hasta que el control vuelva, los mensajes de la persona solo llegan a la app de easyCoexistence por standby, canal al que no está suscrita. Sin enrutamiento, ambas siguen recibiéndolos.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el