Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Protokol serah terima Messenger: berkongsi peti masuk Halaman antara ejen AI dan orang

Meta menggantikan protokol serah terima Messenger dengan Conversation Routing, yang mengekalkan panggilan kawalan utas. pass_thread_control menyerahkan perbualan kepada aplikasi lain, seperti peti masuk Halaman dengan ID aplikasi 263902037430900, take_thread_control menuntutnya, request_thread_control memintanya, dan release_thread_control memulangkannya ke keadaan tidak aktif. Dengan Conversation Routing dihidupkan, aplikasi yang mengawal utas menerima mesejnya, manakala aplikasi lain menerimanya pada saluran standby.

easyCoexistence memberikan ejen AI anda perbualan Messenger sebuah Halaman melalui satu penyambung MCP: send_social_dm membalas dalam tetingkap 24 jam dan mesej baharu dihantar ke endpoint anda sebaik sahaja tiba.

263902037430900

target_app_id yang diberikan Meta untuk menyerahkan kawalan perbualan kepada Page Inbox.

2018300

Subkod, di bawah ralat 10, bagi mesej yang gagal kerana aplikasi lain mengawal perbualan.

24 hours

Tanpa mesej daripada orang ini selama tempoh ini, utas menjadi tidak aktif, dan hanya aplikasi lalai boleh menghantar selepas itu.

Up to 7 days

Sejauh mana extend_thread_control boleh memanjangkan kawalan aplikasi melebihi tempoh masa respons 24 jam.

Off by default

Ambil kawalan perbualan dengan Business AI anda; apabila dimatikan, penghantaran tanpa tag ke perbualan Business AI gagal dengan 10, 2018300.

Apa yang berlaku kepada protokol serah terima?

Meta menggabungkannya ke dalam Conversation Routing. Panduannya menyatakan Meta tidak lagi menyokong protokol serah terima untuk Messenger, bahawa perniagaan telah dipindahkan ke Conversation Routing, dan routing serasi ke belakang dengan kebanyakan panggilan protokol serah terima, jadi pass_thread_control, take_thread_control dan webhook messaging_handovers dijangka terus berfungsi. Yang berubah ialah siapa yang membuat keputusan: perniagaan menetapkan aplikasi lalai dan peraturan routing dalam tetapan Halamannya, di bawah Conversation Routing.

Siapa yang mengawal perbualan?

Satu aplikasi pada satu-satu masa, yang dipanggil Meta sebagai pemilik utas. Utas aktif semasa orang itu dan aplikasi pemilik sedang berbual, dan tidak aktif apabila orang itu tidak menulis selama 24 jam atau pemilik telah melepaskan kawalan; dalam utas tidak aktif hanya aplikasi lalai boleh menghantar, dalam tetingkap mesej. Peraturan routing menentukan siapa yang mengambil utas:

  • Aplikasi lalai: yang menjawab apabila tiada aplikasi lain dikonfigurasi atau memberi respons.
  • Routing sosial: aplikasi yang mengambil kawalan apabila orang itu membuka utas tidak aktif atau menekan Get Started.
  • Routing pautan: aplikasi yang diberikan kepada setiap pautan m.me.
  • Routing kempen: aplikasi yang dipilih untuk iklan Click-to-Messenger, yang mengawal perbualan itu dalam tetingkap mesej perbualan tersebut, sehingga 7 hari.

Panggilan mana yang memindahkan kawalan antara aplikasi?

Setiap satu ialah POST ke edge Halaman dengan recipient ditetapkan kepada PSID orang itu, dan setiap satu memulangkan success true; kebanyakannya juga menerima rentetan metadata yang diterima oleh aplikasi seterusnya:

  • pass_thread_control: menyerahkan utas kepada aplikasi dalam target_app_id, yang menerima peristiwa messaging_handovers.
  • release_thread_control: menamatkan kawalan aplikasi dan memulangkan utas kepada keadaan tidak aktif.
  • take_thread_control: menjadikan aplikasi yang memanggil sebagai pemilik, bagi aplikasi yang dibenarkan perniagaan untuk mengambil kawalan.
  • request_thread_control: meminta kawalan perbualan.
  • extend_thread_control: mengekalkan kawalan melepasi tempoh masa respons 24 jam, sehingga 7 hari, dengan tempoh dalam saat.
  • Send API boleh menyerahkan atau melepaskan kawalan bersama mesej 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 peti masuk Halaman mengambil alih?

Dengan menjawab. Conversation Routing menganggap peti masuk Meta Business Suite sebagai satu lagi aplikasi yang disambungkan, yang malah boleh dijadikan lalai oleh perniagaan; apabila seseorang membalas di sana dalam perbualan yang tidak dikawal peti masuk, atau memindahkannya ke folder Main, peti masuk mengambil kawalan. Aplikasi menyerahkan perbualan kepada orang dengan pass_thread_control dan target_app_id 263902037430900, dan aplikasi yang menyampaikan balasan orang selepas tetingkap 24 jam menghantarnya dengan tag HUMAN_AGENT, dalam tempoh 7 hari dari mesej terakhir orang itu.

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 berlaku apabila Business AI Meta memiliki perbualan?

Aplikasi lain menerima mesej orang itu pada saluran standby dan tidak sepatutnya menjawabnya. Panduan Meta menyatakan untuk mula memberi respons selepas peristiwa messaging_handovers dengan pass_thread_control; notifikasi messages mungkin membawa admin_text dan handoff_reason seperti human_requested atau purchase_intent, tetapi ia tidak memindahkan pemilikan. Dengan Ambil kawalan perbualan dengan Business AI anda dimatikan, iaitu lalai, penghantaran tanpa tag ke perbualan itu gagal dengan kod 10, subkod 2018300.

Bagaimana aplikasi menyemak siapa yang memiliki utas?

GET /{page-id}/thread_owner dengan recipient ditetapkan kepada PSID memulangkan app_id aplikasi pemilik dan bila kawalannya tamat, kepada pemilik itu sendiri atau kepada aplikasi lalai Halaman. Medan is_owner dalam Conversations API menjawab soalan yang sama bagi setiap perbualan apabila routing dihidupkan, dan GET /{page-id}?fields=messaging_feature_status menunjukkan status Conversation Routing Halaman dalam medan seperti msgr_multi_app.

Apa yang berlaku tanpa Conversation Routing?

Meta memanggilnya tingkah laku lalai, yang bertujuan untuk Halaman dengan satu aplikasi yang disambungkan dan menerima serta menjawab mesej sendiri. Semua aplikasi yang disambungkan menerima webhook mesej dan boleh menjawab mesej yang sama, take_thread_control disekat sehingga aplikasi lalai ditetapkan, dan hanya routing kempen tersedia. Panduan Meta untuk persediaan ini ialah menyelaraskan aplikasi dan peti masuk Halaman supaya tiada siapa menjawab mesej yang sama dua kali.

Apa yang dilakukan easyCoexistence dalam peti masuk kongsi?

Ia melanggan setiap Halaman kepada feed, messages dan mention, bukan kepada messaging_handovers, standby atau message_echoes, jadi ia menyampaikan mesej orang itu semasa aplikasinya menerimanya dan tidak nampak peristiwa serah terima mahupun balasan yang dihantar dari peti masuk Halaman. send_social_dm menghantar RESPONSE tanpa thread_control, dan apabila Meta menolak penghantaran kerana aplikasi lain memegang perbualan, alat itu memulangkan kod 10 dan mesej Meta kepada AI anda. Panggilan kawalan utas, thread_owner dan is_owner tidak termasuk dalam alatnya.

Kesilapan biasa

  • Menjawab mesej standby. Mesej ini sampai kepada aplikasi yang tidak memiliki utas; tunggu pass_thread_control sebelum membalas.
  • Membaca admin_text sebagai serah terima. Notifikasi messages dengan konteks serah terima tidak memindahkan pemilikan; peristiwa messaging_handovers yang melakukannya.
  • Menjalankan AI dan peti masuk secara serentak tanpa routing. Dengan tingkah laku lalai kedua-duanya menerima mesej, dan Meta meminta penyelarasan untuk mengelak dua balasan.
  • Mengekalkan utas selepas aliran tamat. Meta mengesyorkan melepaskan kawalan sebaik sahaja aplikasi selesai, bukannya menunggu tempoh respons tamat.
Menggunakan EasyCoexistence untuk ini

Panggilan kawalan utas Meta tidak termasuk dalam alatnya; seseorang mengambil alih perbualan dengan membalas dalam peti masuk Halaman. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah dua aplikasi pada satu Halaman memerlukan Conversation Routing?

Meta mengesyorkannya apabila beberapa aplikasi pemesejan disambungkan dan setiap satu harus menjawab perbualan tertentu. Dengan satu aplikasi yang menerima dan menjawab, tingkah laku lalai sudah memadai.

Berapa lama sesebuah aplikasi mengekalkan kawalan perbualan?

Sehingga ia melepaskan kawalan atau utas menjadi tidak aktif, 24 jam selepas mesej terakhir orang itu. extend_thread_control menambah masa, sehingga 7 hari.

Adakah balasan dari peti masuk Halaman sampai ke aplikasi lain?

Aplikasi yang melanggan message_echoes menerimanya sebagai echo yang app_id-nya ialah peti masuk Halaman, 263902037430900, seperti yang diterangkan dalam changelog Meta untuk Graph API v12.0 dan ke atas.

Apa yang berlaku kepada balasan easyCoexistence apabila seseorang menjawab dari peti masuk?

Dengan Conversation Routing dihidupkan, peti masuk mengambil kawalan, dan sehingga kawalan dipulangkan, mesej orang itu hanya sampai kepada aplikasi easyCoexistence pada saluran standby, yang tidak dilanggannya. Tanpa routing, kedua-duanya terus menerimanya.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada