Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Protocole de transfert Messenger : partager la boîte de réception d'une Page entre un agent IA et des personnes

Meta a remplacé le protocole de transfert Messenger par Conversation Routing, qui conserve ses appels de contrôle de fil : pass_thread_control transfère une conversation à une autre application, comme la boîte de réception de la Page avec l'ID d'application 263902037430900, take_thread_control s'en empare, request_thread_control en demande le contrôle et release_thread_control la rend à l'état inactif. Avec le routage activé, l'application qui contrôle un fil reçoit ses messages, et les autres les reçoivent sur le canal standby.

easyCoexistence donne à votre agent IA les conversations Messenger d'une Page via un seul connecteur MCP : send_social_dm répond dans la fenêtre de 24 heures et les nouveaux messages sont transmis à votre endpoint dès leur arrivée.

263902037430900

Le target_app_id que Meta attribue pour transférer le contrôle d'une conversation à la boîte de réception de la Page.

2018300

Sous-code, sous l'erreur 10, pour un message qui a échoué parce qu'une autre application contrôle la conversation.

24 hours

Sans message de la personne pendant ce délai, un fil passe à l'état inactif, et seule l'application par défaut peut alors envoyer.

Up to 7 days

Jusqu'où extend_thread_control peut prolonger le contrôle d'une application au-delà de la fenêtre de temps de réponse de 24 heures.

Off by default

« Prendre le contrôle des conversations avec votre Business AI » ; désactivé, un envoi sans tag vers une conversation Business AI échoue avec le code d'erreur 10, 2018300.

Qu'est-il arrivé au protocole de transfert ?

Meta l'a intégré à Conversation Routing. Son guide indique que Meta ne prend plus en charge le protocole de transfert pour Messenger, que les entreprises ont été migrées vers Conversation Routing, et que le routage est compatible avec la plupart des appels du protocole de transfert ; pass_thread_control, take_thread_control et le webhook messaging_handovers devraient donc continuer à fonctionner. Ce qui a changé, c'est qui décide : l'entreprise définit une application par défaut et des règles de routage dans les paramètres de sa Page, sous Conversation Routing.

Qui contrôle une conversation ?

Une seule application à la fois, que Meta appelle le propriétaire du fil. Un fil est actif lorsque la personne et l'application propriétaire échangent, et inactif lorsque la personne n'a pas écrit depuis 24 heures ou que le propriétaire a libéré le contrôle ; dans un fil inactif, seule l'application par défaut peut envoyer, dans la fenêtre de messagerie. Les règles de routage déterminent qui prend un fil :

  • Application par défaut : celle qui répond lorsqu'aucune autre n'est configurée ou ne répond.
  • Routage social : l'application qui prend le contrôle lorsque la personne ouvre un fil inactif ou appuie sur « Get Started ».
  • Routage par lien : une application attribuée à chaque lien m.me.
  • Routage par campagne : l'application choisie pour une annonce Click-to-Messenger, qui contrôle la conversation pendant la fenêtre de messagerie de cette conversation, jusqu'à 7 jours.

Quels appels transfèrent le contrôle d'une application à l'autre ?

Chacun est une requête POST vers un edge de la Page, avec recipient défini sur le PSID de la personne, et chacun répond success true ; la plupart acceptent aussi une chaîne metadata que l'application suivante reçoit :

  • pass_thread_control : transfère le fil à l'application indiquée dans target_app_id, qui reçoit un événement messaging_handovers.
  • release_thread_control : met fin au contrôle de l'application et remet le fil à l'état inactif.
  • take_thread_control : fait de l'application appelante le propriétaire, pour les applications que l'entreprise autorise à prendre le contrôle.
  • request_thread_control : demande le contrôle de la conversation.
  • extend_thread_control : conserve le contrôle au-delà de la fenêtre de temps de réponse de 24 heures, jusqu'à 7 jours, avec une durée en secondes.
  • L'API Send peut transférer ou rendre le contrôle avec le message lui-même, via un objet 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 }

Comment les personnes interviennent-elles dans la boîte de réception de la Page ?

En répondant. Conversation Routing traite la boîte de réception de Meta Business Suite comme une application connectée de plus, qu'une entreprise peut même définir comme application par défaut ; lorsqu'une personne y répond dans une conversation que la boîte de réception ne contrôle pas, ou la déplace dans le dossier « Principal », la boîte de réception en prend le contrôle. Une application transfère une conversation aux personnes avec pass_thread_control et target_app_id 263902037430900, et une application qui relaie la réponse d'une personne après la fenêtre de 24 heures l'envoie avec le tag HUMAN_AGENT, dans les 7 jours suivant le dernier message de la personne.

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

Que se passe-t-il quand la Business AI de Meta contrôle une conversation ?

Les autres applications reçoivent les messages de la personne sur le canal standby et ne doivent pas y répondre. Le guide de Meta indique de commencer à répondre après un événement messaging_handovers avec pass_thread_control ; une notification messages peut contenir admin_text et un handoff_reason tel que human_requested ou purchase_intent, mais elle ne transfère pas la propriété. Avec l'option « Prendre le contrôle des conversations avec votre Business AI » désactivée, valeur par défaut, un envoi sans tag vers cette conversation échoue avec le code d'erreur 10, sous-code 2018300.

Comment une application vérifie-t-elle qui possède un fil ?

GET /{page-id}/thread_owner avec recipient défini sur le PSID renvoie l'app_id de l'application propriétaire et l'heure d'expiration de son contrôle, au propriétaire lui-même ou à l'application par défaut de la Page. Le champ is_owner de l'API Conversations répond à la même question pour chaque conversation une fois le routage activé, et GET /{page-id}?fields=messaging_feature_status indique le statut de Conversation Routing de la Page dans des champs tels que msgr_multi_app.

Que se passe-t-il sans Conversation Routing ?

Meta parle de comportement par défaut, prévu pour une Page avec une seule application connectée qui reçoit et répond aux messages de manière autonome. Toutes les applications connectées reçoivent les webhooks de messagerie et peuvent répondre au même message, take_thread_control est bloqué tant qu'aucune application par défaut n'est définie, et seul le routage par campagne est disponible. Le conseil de Meta pour cette configuration est de coordonner l'application et la boîte de réception de la Page pour que personne ne réponde deux fois au même message.

Que fait easyCoexistence dans une boîte de réception partagée ?

Elle abonne chaque Page à feed, messages et mention, et non à messaging_handovers, standby ou message_echoes ; elle transmet donc les messages de la personne pendant que son application les reçoit, et elle ne voit ni événements de transfert ni réponses envoyées depuis la boîte de réception de la Page. send_social_dm envoie une RESPONSE sans thread_control, et lorsque Meta refuse un envoi parce qu'une autre application détient la conversation, l'outil renvoie à votre IA le code d'erreur 10 et le message de Meta. Les appels de contrôle de fil, thread_owner et is_owner ne font pas partie de ses outils.

Erreurs courantes

  • Répondre aux messages standby. Ils parviennent à une application qui ne possède pas le fil ; attendez pass_thread_control avant de répondre.
  • Lire admin_text comme un transfert. Une notification messages avec un contexte de transfert ne transfère pas la propriété ; seul l'événement messaging_handovers le fait.
  • Faire tourner une IA et la boîte de réception côte à côte sans routage. Avec le comportement par défaut, les deux reçoivent le message, et Meta demande une coordination pour éviter deux réponses.
  • Garder un fil après la fin du parcours. Meta recommande de rendre le contrôle dès que l'application a fini, au lieu d'attendre l'expiration du délai de réponse.
Faire cela avec EasyCoexistence

Les appels de contrôle de fil de Meta ne font pas partie de ses outils ; une personne reprend une conversation en répondant dans la boîte de réception de la Page. De US$ 9 à US$ 0.75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.

Questions fréquemment posées

Deux applications sur une même Page ont-elles besoin de Conversation Routing ?

Meta le recommande lorsque plusieurs applications de messagerie sont connectées et que chacune doit répondre à certaines conversations. Avec une seule application qui reçoit et répond, le comportement par défaut suffit.

Combien de temps une application garde-t-elle le contrôle d'une conversation ?

Jusqu'à ce qu'elle libère le contrôle ou que le fil devienne inactif, 24 heures après le dernier message de la personne. extend_thread_control ajoute du temps, jusqu'à 7 jours.

Une réponse envoyée depuis la boîte de réception parvient-elle aux autres applications ?

Les applications abonnées à message_echoes la reçoivent comme un écho dont l'app_id est celui de la boîte de réception de la Page, 263902037430900, comme le décrit le changelog de Meta pour Graph API v12.0 et versions ultérieures.

Que se passe-t-il pour les réponses d'easyCoexistence lorsqu'une personne répond depuis la boîte de réception ?

Avec Conversation Routing activé, la boîte de réception prend le contrôle, et jusqu'à son retour, les messages de la personne n'atteignent l'application d'easyCoexistence que sur le canal standby, auquel elle ne s'abonne pas. Sans routage, les deux continuent de les recevoir.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le