Messenger ハンドオーバープロトコル:AI エージェントと担当者で Page のインボックスを共有する
Meta は Messenger のハンドオーバープロトコルを Conversation Routing に置き換えました。スレッド制御の呼び出しはそのまま残っています。pass_thread_control は会話を別のアプリ(たとえばアプリ ID 263902037430900 の Page インボックス)に渡し、take_thread_control はそれを引き受け、request_thread_control は制御を求め、release_thread_control は会話をアイドル状態に戻します。ルーティングを有効にすると、会話を制御しているアプリがそのメッセージを受け取り、ほかのアプリは standby チャネルで受け取ります。
easyCoexistence は、1 つの MCP コネクターを通じて、AI エージェントに Page の Messenger 会話を提供します。
会話の制御を Page Inbox に渡すために Meta が指定する target_app_id。
エラー 10 の下位コード。別のアプリが会話を制御しているためにメッセージの送信に失敗したことを示します。
ユーザーからのメッセージがこの期間ないと、スレッドはアイドル状態になり、その後はデフォルトアプリのみ送信できます。
extend_thread_control が、24 時間の応答時間枠を超えてアプリの制御をどこまで延ばせるか。
「Business AI の会話の制御を引き受ける」設定。オフの間は、タグなしで Business AI の会話に送信すると、エラー 10(サブコード 2018300)で失敗します。
ハンドオーバープロトコルはどうなったのですか?
Meta は、これを Conversation Routing に統合しました。同社のガイドによると、Meta はもう Messenger のハンドオーバープロトコルをサポートしておらず、企業はすでに Conversation Routing に移行されています。ルーティングはほとんどのハンドオーバープロトコルの呼び出しと後方互換性があるため、pass_thread_control、take_thread_control、messaging_handovers の Webhook は引き続き動作することが見込まれています。変わったのは、誰が決めるかです。企業は Page の設定で、Conversation Routing の下にデフォルトアプリとルーティングルールを設定します。
会話を制御するのは誰ですか?
一度に 1 つのアプリです。Meta はこれをスレッドオーナーと呼びます。スレッドは、ユーザーと所有アプリがやり取りしている間はアクティブです。ユーザーが 24 時間書き込まない場合、または所有アプリが制御を解放した場合、スレッドはアイドルになります。アイドルのスレッドでは、メッセージングウィンドウ内であればデフォルトアプリだけが送信できます。どのアプリがスレッドを引き受けるかは、ルーティングルールで決まります。
- デフォルトアプリ:ほかのアプリが設定されていない、または応答していないときに応答するアプリ。
- ソーシャルルーティング:ユーザーがアイドルのスレッドを開いたとき、または「Get Started」をタップしたときに制御を引き受けるアプリ。
- リンクルーティング:各 m.me リンクに割り当てられたアプリ。
- キャンペーンルーティング:Click-to-Messenger 広告に選ばれたアプリ。その会話のメッセージングウィンドウの間(最大 7 日間)制御します。
どの呼び出しで制御をアプリ間で移しますか?
いずれも Page の edge への POST で、recipient には相手の PSID を指定します。いずれも success が true を返します。多くは、次のアプリが受け取るメタデータ文字列も受け付けます。
pass_thread_control:target_app_idのアプリにスレッドを渡します。そのアプリはmessaging_handoversイベントを受け取ります。release_thread_control:アプリの制御を終了し、スレッドをアイドルに戻します。take_thread_control:企業が制御の引き受けを許可したアプリについて、呼び出し元のアプリを所有者にします。request_thread_control:会話の制御を求めます。extend_thread_control:24 時間の応答時間枠を超えて制御を維持します。最長 7 日間で、期間は秒単位で指定します。- Send API は、
thread_controlオブジェクトを通じて、メッセージ自体に制御の受け渡しや解放を含めることができます。
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Page インボックスの担当者は、どのように会話に入りますか?
返信することで入ります。Conversation Routing は Meta Business Suite のインボックスを、接続済みのアプリの一つとして扱います。企業はこれをデフォルトに設定することもできます。アプリが制御していない会話に誰かが返信した場合、または会話を Main フォルダに移動した場合、インボックスが制御を引き受けます。アプリは pass_thread_control と target_app_id 263902037430900 を使って、会話を担当者に渡します。24 時間の枠を過ぎた後にユーザーの返信を中継するアプリは、ユーザーの最後のメッセージから 7 日以内であれば、HUMAN_AGENT タグを付けて送信します。
Meta の Business AI が会話を所有しているとき、どうなりますか?
ほかのアプリはユーザーのメッセージを standby チャネルで受け取り、応答すべきではありません。Meta のガイドでは、messaging_handovers イベント(pass_thread_control を含む)を受けてから応答を開始するよう述べています。messages 通知には admin_text や、human_requested、purchase_intent などの handoff_reason が含まれることがありますが、所有権は移りません。「Business AI の会話の制御を引き受ける」設定がオフの場合(デフォルト)、その会話へのタグなしの送信は、コード 10、サブコード 2018300 で失敗します。
アプリはスレッドの所有者をどう確認しますか?
recipient に PSID を指定した GET /{page-id}/thread_owner は、所有アプリの app_id と、その制御の期限を返します。返されるのは、所有アプリ本人、または Page のデフォルトアプリです。Conversations API の is_owner フィールドは、ルーティングを有効にすると、会話ごとに同じ問いに答えます。また、GET /{page-id}?fields=messaging_feature_status は、msgr_multi_app などのフィールドで Page の Conversation Routing の状態を示します。
Conversation Routing がない場合はどうなりますか?
Meta はこれをデフォルトの動作と呼びます。1 つの接続済みアプリがメッセージを受け取り、単独で応答する Page を想定したものです。接続済みのすべてのアプリがメッセージング Webhook を受け取り、同じメッセージに応答できます。デフォルトアプリが設定されるまで take_thread_control はブロックされ、利用できるのはキャンペーンルーティングだけです。この構成について Meta が勧めているのは、同じメッセージに二重に応答しないよう、アプリと Page インボックスを調整することです。
easyCoexistence は共有インボックスで何をしますか?
各 Page の feed、messages、mention を購読しますが、messaging_handovers、standby、message_echoes は購読しません。そのため、ユーザーのメッセージは届いたときに転送されます。ただし、アプリはハンドオーバーイベントも Page インボックスから送られた返信も受け取りません。send_social_dm は thread_control を付けずに RESPONSE として送信します。別のアプリが会話を保持しているために Meta が送信を拒否すると、ツールは Meta のコード 10 とメッセージを AI に返します。スレッド制御の呼び出し、thread_owner、is_owner は、ツールに含まれていません。
よくある間違い
- standby のメッセージに応答してしまうこと。これらはスレッドを所有していないアプリに届きます。返信する前に pass_thread_control を待ってください。
- admin_text をハンドオーバーとして扱うこと。handoff のコンテキストを含む messages 通知では所有権は移らず、移すのは messaging_handovers イベントです。
- ルーティングなしで AI とインボックスを並べて動かすこと。デフォルトの動作では両方がメッセージを受け取り、Meta は二重返信を避けるために調整を求めています。
- 会話が終わった後もスレッドを保持し続けること。Meta は、応答時間の期限切れを待つのではなく、アプリの処理が終わったらすぐに制御を解放することを推奨しています。
send_social_dm は 24 時間のウィンドウ内で返信し、新しいメッセージは届いたときにお使いのエンドポイントへ転送されます。Meta のスレッド制御の呼び出しはツールに含まれておらず、会話の引き継ぎは、人が Page インボックスで返信して行います。料金は接続ごとに月額 US$ 9 から US$ 0.75 までで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
同じ Page に 2 つのアプリがある場合、Conversation Routing は必要ですか?
複数のメッセージングアプリが接続されていて、それぞれが特定の会話に応答すべき場合は、Meta が推奨しています。1 つのアプリがメッセージを受け取って応答するだけなら、デフォルトの動作で十分です。
アプリはどのくらいの間、会話の制御を保持しますか?
制御を解放するか、ユーザーの最後のメッセージから 24 時間が経ってスレッドがアイドルになるまでです。extend_thread_control で時間を延長でき、最長 7 日間です。
Page インボックスからの返信は、ほかのアプリに届きますか?
message_echoes を購読しているアプリは、echo として受け取ります。その app_id は Page インボックスのもので、263902037430900 です。これは、Graph API v12.0 以降について Meta の変更履歴に記載されているとおりです。
ユーザーがインボックスから返信すると、easyCoexistence の返信はどうなりますか?
Conversation Routing を有効にすると、インボックスが制御を引き受けます。制御が戻るまで、ユーザーのメッセージは easyCoexistence のアプリには standby でしか届かず、そのアプリは standby を購読していません。ルーティングがなければ、両方が引き続きメッセージを受け取ります。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日