MasukMulai uji coba gratis
easyCoexistence API resmi

Protokol serah terima Messenger: berbagi kotak masuk Page antara agen AI dan orang

Meta mengganti protokol serah terima Messenger dengan Conversation Routing, yang tetap mempertahankan panggilan kontrol thread-nya: pass_thread_control menyerahkan percakapan ke aplikasi lain, misalnya kotak masuk Page dengan app ID 263902037430900, take_thread_control mengklaimnya, request_thread_control memintanya, dan release_thread_control mengembalikannya ke status tidak aktif. Saat routing aktif, aplikasi yang mengendalikan thread menerima pesannya, sementara aplikasi lain menerimanya lewat saluran standby.

easyCoexistence memberikan agen AI Anda percakapan Messenger sebuah Page lewat satu konektor MCP: send_social_dm membalas dalam jendela layanan pelanggan 24 jam dan pesan baru diteruskan ke endpoint Anda saat tiba.

263902037430900

target_app_id yang diberikan Meta untuk menyerahkan kontrol percakapan ke kotak masuk Page.

2018300

Subkode di bawah kesalahan 10, untuk pesan yang gagal karena aplikasi lain mengendalikan percakapan.

24 hours

Tanpa pesan dari orang tersebut selama jangka waktu ini, thread menjadi tidak aktif, dan hanya aplikasi default yang dapat mengirim.

Up to 7 days

Seberapa jauh extend_thread_control dapat memperpanjang kontrol aplikasi melampaui jangka waktu respons 24 jam.

Off by default

Ambil alih percakapan dengan Business AI Anda; saat dimatikan, pengiriman tanpa tag ke percakapan Business AI gagal dengan 10, 2018300.

Apa yang terjadi pada protokol serah terima?

Meta menggabungkannya ke dalam Conversation Routing. Panduannya menyatakan bahwa Meta tidak lagi mendukung protokol serah terima untuk Messenger, bisnis sudah dimigrasikan ke Conversation Routing, dan routing kompatibel mundur dengan sebagian besar panggilan protokol serah terima, sehingga pass_thread_control, take_thread_control, dan webhook messaging_handovers diharapkan tetap berfungsi. Yang berubah adalah siapa yang memutuskan: bisnis menetapkan aplikasi default dan aturan routing di pengaturan Page, di bawah Conversation Routing.

Siapa yang mengendalikan percakapan?

Satu aplikasi dalam satu waktu, yang oleh Meta disebut pemilik thread. Thread aktif selama orang dan aplikasi pemilik sedang berkomunikasi, dan tidak aktif saat orang tersebut tidak menulis selama 24 jam atau pemilik telah melepaskan kontrol; dalam thread yang tidak aktif hanya aplikasi default yang dapat mengirim, di dalam jendela layanan pelanggan. Aturan routing menentukan siapa yang mengambil thread:

  • Aplikasi default: aplikasi yang membalas saat tidak ada aplikasi lain yang dikonfigurasi atau merespons.
  • Social routing: aplikasi yang mengambil kontrol saat orang membuka thread yang tidak aktif atau menekan Get Started.
  • Link routing: aplikasi yang ditetapkan untuk setiap tautan m.me.
  • Campaign routing: aplikasi yang dipilih untuk iklan Click-to-Messenger, memegang kontrol untuk jendela layanan pelanggan percakapan tersebut, hingga 7 hari.

Panggilan mana yang memindahkan kontrol antar aplikasi?

Masing-masing adalah POST ke edge Page dengan recipient diisi PSID orang tersebut, dan masing-masing mengembalikan success true; sebagian besar juga menerima string metadata yang diterima aplikasi berikutnya:

  • pass_thread_control: menyerahkan thread ke aplikasi di target_app_id, yang menerima event messaging_handovers.
  • release_thread_control: mengakhiri kontrol aplikasi dan mengembalikan thread ke status tidak aktif.
  • take_thread_control: menjadikan aplikasi pemanggil sebagai pemilik, untuk aplikasi yang diizinkan bisnis mengambil kontrol.
  • request_thread_control: meminta kontrol atas percakapan.
  • extend_thread_control: mempertahankan kontrol melampaui jangka waktu respons 24 jam, hingga 7 hari, dengan durasi dalam detik.
  • Send API dapat menyerahkan atau melepaskan kontrol bersama pesan itu sendiri, melalui objek 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 }

Bagaimana orang di kotak masuk Page ikut turun tangan?

Dengan membalas. Conversation Routing memperlakukan kotak masuk Meta Business Suite sebagai satu aplikasi tambahan yang terhubung, yang bahkan bisa dijadikan default oleh bisnis; saat seseorang membalas di sana pada percakapan yang tidak dikendalikan kotak masuk, atau memindahkannya ke folder Main, kotak masuk mengambil kontrol. Aplikasi menyerahkan percakapan kepada orang dengan pass_thread_control dan target_app_id 263902037430900, dan aplikasi yang meneruskan balasan orang setelah jendela 24 jam mengirimkannya dengan tag HUMAN_AGENT, dalam 7 hari sejak pesan terakhir orang tersebut.

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

Apa yang terjadi saat Business AI Meta memiliki sebuah percakapan?

Aplikasi lain menerima pesan orang tersebut lewat saluran standby dan sebaiknya tidak membalasnya. Panduan Meta menyarankan mulai membalas setelah event messaging_handovers dengan pass_thread_control; notifikasi messages dapat membawa admin_text dan handoff_reason seperti human_requested atau purchase_intent, tetapi tidak memindahkan kepemilikan. Saat opsi Ambil alih percakapan dengan Business AI Anda dimatikan, yang merupakan default, pengiriman tanpa tag ke percakapan itu gagal dengan kode 10, subkode 2018300.

Bagaimana aplikasi memeriksa siapa pemilik thread?

GET /{page-id}/thread_owner dengan recipient diisi PSID mengembalikan app_id aplikasi pemilik dan kapan kontrolnya berakhir, kepada pemilik itu sendiri atau kepada aplikasi default Page. Field is_owner pada Conversations API menjawab pertanyaan yang sama per percakapan setelah routing aktif, dan GET /{page-id}?fields=messaging_feature_status menampilkan status Conversation Routing Page dalam field seperti msgr_multi_app.

Apa yang terjadi tanpa Conversation Routing?

Meta menyebutnya perilaku default, dimaksudkan untuk Page dengan satu aplikasi terhubung yang menerima dan membalas pesan sendiri. Semua aplikasi terhubung menerima webhook messaging dan dapat membalas pesan yang sama, take_thread_control diblokir sampai aplikasi default ditetapkan, dan hanya campaign routing yang tersedia. Saran Meta untuk pengaturan ini adalah mengoordinasikan aplikasi dan kotak masuk Page agar tidak ada yang membalas pesan yang sama dua kali.

Apa yang dilakukan easyCoexistence di kotak masuk bersama?

Ia berlangganan setiap Page ke feed, messages, dan mention, bukan ke messaging_handovers, standby, atau message_echoes, sehingga ia meneruskan pesan orang sementara aplikasinya menerimanya, dan tidak melihat event serah terima maupun balasan yang dikirim dari kotak masuk Page. send_social_dm mengirim RESPONSE tanpa thread_control, dan saat Meta menolak pengiriman karena aplikasi lain memegang percakapan, alat itu mengembalikan kode 10 dan pesan Meta kepada AI Anda. Panggilan kontrol thread, thread_owner, dan is_owner tidak termasuk dalam alatnya.

Kesalahan umum

  • Membalas pesan standby. Pesan itu sampai ke aplikasi yang bukan pemilik thread; tunggu pass_thread_control sebelum membalas.
  • Menganggap admin_text sebagai serah terima. Notifikasi messages dengan konteks handoff tidak memindahkan kepemilikan; event messaging_handovers yang melakukannya.
  • Menjalankan AI dan kotak masuk berdampingan tanpa routing. Dengan perilaku default keduanya menerima pesan, dan Meta meminta koordinasi untuk menghindari dua balasan.
  • Menahan thread setelah alur berakhir. Meta menyarankan melepaskan kontrol segera setelah aplikasi selesai, alih-alih menunggu jangka waktu respons habis.
Melakukan ini dengan EasyCoexistence

Panggilan kontrol thread Meta tidak termasuk dalam alatnya; seseorang mengambil alih percakapan dengan membalas di kotak masuk Page. Dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah dua aplikasi pada satu Page memerlukan Conversation Routing?

Meta merekomendasikannya saat beberapa aplikasi pesan terhubung dan masing-masing harus membalas percakapan tertentu. Dengan satu aplikasi yang menerima dan membalas, perilaku default sudah cukup.

Berapa lama sebuah aplikasi memegang kontrol percakapan?

Sampai ia melepaskan kontrol atau thread menjadi tidak aktif, 24 jam setelah pesan terakhir orang tersebut. extend_thread_control menambah waktu, hingga 7 hari.

Apakah balasan dari kotak masuk Page sampai ke aplikasi lain?

Aplikasi yang berlangganan message_echoes menerimanya sebagai echo dengan app_id milik kotak masuk Page, 263902037430900, sebagaimana dijelaskan changelog Meta untuk Graph API v12.0 dan yang lebih baru.

Apa yang terjadi pada balasan easyCoexistence saat orang membalas dari kotak masuk?

Dengan Conversation Routing aktif, kotak masuk mengambil kontrol, dan hingga kontrol kembali, pesan orang hanya sampai ke aplikasi easyCoexistence lewat standby, yang tidak dilangganinya. Tanpa routing, keduanya tetap menerima pesan tersebut.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada