Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Messenger devir protokolü: Sayfa gelen kutusunu bir yapay zekâ ajanı ile insanlar arasında paylaşma

Meta, Messenger devir protokolünün yerine konuşma kontrolü çağrılarını koruyan Conversation Routing'i koydu: pass_thread_control bir konuşmayı 263902037430900 uygulama kimliğine sahip Sayfa gelen kutusu gibi başka bir uygulamaya devreder, take_thread_control konuşmayı üstlenir, request_thread_control konuşma kontrolünü talep eder ve release_thread_control konuşmayı boşa çıkararak geri verir. Yönlendirme açıkken, bir konuşmanın sahibi olan uygulama mesajlarını alır, diğerleri ise bekleme kanalından alır.

easyCoexistence, yapay zekâ ajanınıza bir Sayfanın Messenger konuşmalarını tek bir MCP bağlayıcısı üzerinden verir: send_social_dm 24 saatlik pencere içinde yanıt verir ve yeni mesajlar geldiği anda uç noktanıza iletilir.

263902037430900

Meta'nın, konuşma kontrolünü Page Inbox'a devretmek için verdiği target_app_id.

2018300

Başka bir uygulamanın konuşmayı kontrol etmesi nedeniyle başarısız olan bir mesaj için, hata 10 altındaki alt kod.

24 hours

Kişiden bu süre boyunca mesaj gelmezse konuşma boşa çıkar ve yalnızca varsayılan uygulama gönderebilir.

Up to 7 days

extend_thread_control'ün, bir uygulamanın kontrolünü 24 saatlik yanıt süresinin ötesine ne kadar uzatabileceği.

Off by default

Business AI'nızla konuşmaların kontrolünü alın; bu kapalıyken, etiketsiz gönderimler Business AI konuşmasına 10, 2018300 hatasıyla başarısız olur.

Devir protokolüne ne oldu?

Meta, devir protokolünü Conversation Routing'in içine kattı. Meta'nın rehberi, Messenger için devir protokolünün artık desteklenmediğini, işletmelerin Conversation Routing'e taşındığını ve yönlendirmenin çoğu devir protokolü çağrısıyla geriye dönük uyumlu olduğunu söylüyor; bu nedenle pass_thread_control, take_thread_control ve messaging_handovers webhook'unun çalışmaya devam etmesi bekleniyor. Değişen, kimin karar verdiği: işletme, Sayfa ayarlarında, Conversation Routing altında varsayılan uygulamayı ve yönlendirme kurallarını belirler.

Bir konuşmayı kim kontrol eder?

Aynı anda yalnızca bir uygulama; Meta buna konuşma sahibi diyor. Kişi ile sahip uygulama konuşurken konuşma aktiftir; kişi 24 saat yazmadığında ya da sahip kontrolü bıraktığında boşta kalır. Boşta kalan konuşmada yalnızca varsayılan uygulama, mesajlaşma penceresi içinde gönderebilir. Yönlendirme kuralları konuşmayı kimin devralacağına karar verir:

  • Varsayılan uygulama: başka uygulama yapılandırılmadığında ya da yanıt vermediğinde yanıt veren uygulama.
  • Sosyal yönlendirme: kişi boşta bir konuşmayı açtığında ya da Get Started'a dokunduğunda kontrolü alan uygulama.
  • Bağlantı yönlendirmesi: her m.me bağlantısına atanan uygulama.
  • Kampanya yönlendirmesi: Click-to-Messenger reklamı için seçilen uygulama; o konuşmanın mesajlaşma penceresi boyunca, en fazla 7 gün kontrolde kalır.

Hangi çağrılar kontrolü uygulamalar arasında taşır?

Her biri, recipient'ı kişinin PSID'sine ayarlanmış bir Sayfa edge'ine POST isteğidir; her biri başarı için true yanıtı verir ve çoğu, bir sonraki uygulamanın alacağı bir metadata dizesi de alır:

  • pass_thread_control: konuşmayı target_app_id'deki uygulamaya devreder; uygulama bir messaging_handovers olayı alır.
  • release_thread_control: uygulamanın kontrolünü sonlandırır ve konuşmayı boşa çıkarır.
  • take_thread_control: çağıran uygulamayı, işletmenin kontrol almasına izin verdiği uygulamalar için sahip yapar.
  • request_thread_control: konuşmanın kontrolünü ister.
  • extend_thread_control: 24 saatlik yanıt süresinin ötesinde, en fazla 7 güne kadar kontrolü sürdürür; süre saniye cinsinden verilir.
  • Send API, kontrolü mesajın kendisiyle birlikte, bir thread_control nesnesi aracılığıyla devredebilir veya bırakabilir.
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 }

İnsanlar Sayfa gelen kutusuna nasıl müdahale eder?

Yanıt vererek. Conversation Routing, Meta Business Suite gelen kutusunu bir bağlı uygulama olarak ele alır; işletme bunu varsayılan yapabilir. Kişi, gelen kutusunun kontrol etmediği bir konuşmada yanıt verdiğinde ya da konuşmayı Ana klasöre taşıdığında, gelen kutusu kontrolü alır. Bir uygulama, konuşmayı pass_thread_control ve target_app_id 263902037430900 ile insanlara devreder; 24 saatlik pencereden sonra kişinin yanıtını ileten bir uygulama, bunu kişinin son mesajından itibaren 7 gün içinde HUMAN_AGENT etiketiyle gönderir.

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

Meta'nın Business AI'ı bir konuşmaya sahip olduğunda ne olur?

Diğer uygulamalar kişinin mesajlarını standby kanalında alır ve bunlara yanıt vermemelidir. Meta'nın rehberi, pass_thread_control içeren bir messaging_handovers olayından sonra yanıtlamaya başlamanızı söylüyor; messages bildirimi admin_text ve human_requested ya da purchase_intent gibi bir handoff_reason taşıyabilir, ama sahipliği devretmez. Varsayılan olan Business AI ile konuşmaların kontrolünü alın seçeneği kapalıyken, o konuşmaya etiketsiz bir gönderim 10 kodu ve 2018300 alt koduyla başarısız olur.

Bir uygulama, bir konuşmanın sahibini nasıl kontrol eder?

GET /{page-id}/thread_owner isteği, recipient'ı PSID'ye ayarlanmış olarak, sahip uygulamanın app_id'sini ve kontrolünün ne zaman sona ereceğini döndürür; bu yanıt sahibin kendisine ya da Sayfanın varsayılan uygulamasına verilir. Yönlendirme açık olduğunda Conversations API'nin is_owner alanı aynı soruyu konuşma bazında yanıtlar; GET /{page-id}?fields=messaging_feature_status ise Sayfanın Conversation Routing durumunu msgr_multi_app gibi alanlarda gösterir.

Conversation Routing olmadan ne olur?

Meta buna varsayılan davranış diyor; tek bağlı uygulamanın kendi başına mesajları alıp yanıtladığı bir Sayfa için tasarlanmıştır. Bağlı tüm uygulamalar messaging webhook'larını alır ve aynı mesaja yanıt verebilir; varsayılan bir uygulama ayarlanana kadar take_thread_control engellenir ve yalnızca kampanya yönlendirmesi kullanılabilir. Meta'nın bu kurulum için tavsiyesi, aynı mesaja iki kez yanıt verilmemesi için uygulama ile Sayfa gelen kutusunun koordine edilmesidir.

easyCoexistence paylaşılan bir gelen kutusunda ne yapar?

Her Sayfayı feed, messages ve mention'a abone eder; messaging_handovers, standby veya message_echoes'a etmez. Böylece kişinin mesajlarını, uygulaması onları alırken iletir; ama devir olaylarını ve Sayfa gelen kutusundan gönderilen yanıtları görmez. send_social_dm, konuşma kontrolü olmadan bir RESPONSE gönderir; Meta, konuşmayı başka bir uygulamanın tuttuğu için bir gönderimi reddederse araç, Meta'nın 10 kodunu ve mesajını yapay zekâ asistanınıza döndürür. Konuşma kontrolü çağrıları, thread_owner ve is_owner araçları arasında yer almaz.

Yaygın hatalar

  • Bekleme kanalındaki mesajları yanıtlamak. Bunlar konuşmanın sahibi olmayan bir uygulamaya ulaşır; yanıtlamadan önce pass_thread_control'ü bekleyin.
  • admin_text'i devir sanmak. Devir bağlamı içeren bir messages bildirimi sahipliği devretmez; devreden messaging_handovers olayıdır.
  • Yönlendirme olmadan bir yapay zekâyı ve gelen kutusunu yan yana çalıştırmak. Varsayılan davranışta ikisi de mesajı alır; Meta, iki yanıtı önlemek için koordinasyon ister.
  • Akış bittikten sonra konuşmada kalmak. Meta, yanıt süresinin dolmasını beklemek yerine uygulama işini bitirir bitirmez kontrolü bırakmayı önerir.
Bunu EasyCoexistence'la yapmak

Meta'nın konuşma kontrolü çağrıları araçları arasında yer almaz; bir kişi, Sayfa gelen kutusunda yanıt vererek konuşmayı devralır. Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşen bir fiyatla; ilk 3 gün ücretsiz.

Sık sorulan sorular

İki uygulama aynı Sayfada Conversation Routing'e ihtiyaç duyar mı?

Meta, birden çok mesajlaşma uygulaması bağlı olduğunda ve her birinin belirli konuşmalara yanıt vermesi gerektiğinde bunu önerir. Tek bir uygulama alıp yanıtlıyorsa varsayılan davranış yeterlidir.

Bir uygulama bir konuşmanın kontrolünü ne kadar tutar?

Kontrolü bırakana ya da konuşma boşa çıkana kadar; konuşma, kişinin son mesajından 24 saat sonra boşa çıkar. extend_thread_control süre ekler, en fazla 7 güne kadar.

Sayfa gelen kutusundan gelen bir yanıt diğer uygulamalara ulaşır mı?

message_echoes'a abone olan uygulamalar bunu, app_id'si Sayfa gelen kutusunun kimliği olan 263902037430900 olan bir echo olarak alır; Meta'nın değişiklik günlüğünde Graph API v12.0 ve sonrası için anlatıldığı gibi.

Bir kişi gelen kutusundan yanıt verdiğinde easyCoexistence'ın yanıtlarına ne olur?

Conversation Routing açıkken gelen kutusu kontrolü alır; kontrol geri dönene kadar kişinin mesajları easyCoexistence'ın uygulamasına yalnızca standby üzerinden ulaşır, ki uygulama buna abone değildir. Yönlendirme olmadan ikisi de mesajları almaya devam eder.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi