Botpress botunu Coexistence ile WhatsApp'a bağlayın
Botpress'in WhatsApp entegrasyonunu Manual Configuration ile kullanın. Bağlı numaranın erişim token'ını ve phone number id değerini yapıştırın, bir verify token belirleyin; App ID ile Client Secret alanlarını boş bırakın. Ardından Botpress'in webhook URL'sini ve bu verify token'ı numaranın webhook hedefi olarak ayarlayın; Meta her mesajı bota iletir.
Botpress'in Client Secret alanı: boş bırakılırsa webhook imza doğrulaması atlanır.
Botpress'in kılavuzunun abone olduğu webhook alanları; mesajlar ve şablon durum güncellemeleri dahil.
Bir müşteri mesajının açtığı müşteri hizmetleri penceresi; bu pencerede her hizmet mesajı gönderilebilir.
Botpress'in hangi yapılandırması bir Coexistence numarasıyla çalışır?
Manual Configuration. Diğer seçenekler numarayı Botpress'in kendi Meta uygulaması üzerinden bağlar; bu, zaten bağlı bir numarayı kullanmanın yolu değil, numaranın ayrı bir kez daha kuruluma alınmasıdır.
WhatsApp entegrasyonunda Configuration açılır listesini açın ve Manual Configuration'ı seçin. Sizden Verify Token, Access Token, Default Bot Phone Number ID ve isteğe bağlı olarak App ID, Client Secret ve WABA ID ister.
Erişim token'ı, phone number id ve WABA id bağlantıdan gelir: panel bunları gösterir, get_api_credentials ise bir asistana döndürür. Verify token seçeceğiniz herhangi bir dizedir. App ID ve Client Secret boş kalır. Botpress'in kılavuzu secret'ı doldurulacak bir alan olarak sunar, ancak entegrasyon tanımı onu isteğe bağlı olarak işaretler ve olmadığında imza doğrulamasının atlandığını belirtir. Bu önemlidir, çünkü Meta her teslimatı Tech Provider'ın uygulama secret'ı ile imzalar ve bunu hiçbir müşteri elinde tutmaz.
Botpress webhook'u Meta'nın mesajlarını nasıl alır?
Numaranın webhook hedefi üzerinden. Botpress'in kılavuzu, webhook URL'sini ve verify token'ınızı bir Meta uygulamasının WhatsApp yapılandırmasına yapıştırmanızı ister. Burada size ait bir Meta uygulaması yok: Meta, numaranın olaylarını bağlantının belirttiği hedefe yönlendirir. Bu yüzden Botpress'in entegrasyon için gösterdiği webhook URL'sini kopyalayın ve aynı verify token ile birlikte panelde ya da set_webhook_destination ile hedef olarak ayarlayın.
Meta bir doğrulama GET isteği gönderir, Botpress yanıtlar ve teslimat başlar. Botpress manuel bir yapılandırmayı kaydederken token'ı, onu hangi uygulamanın verdiğini Graph'a sorarak da denetler; böylece geçersiz ya da iptal edilmiş bir token ilk mesajda değil, kayıt sırasında hata verir.
Botpress'in işleyicisi ayrıca smb_message_echoes olayını da işler; Meta bu olayı biri WhatsApp Business uygulamasından yanıt verdiğinde gönderir. Böylece telefondan verilen yanıt bot için görünmez olmaz, bota görünür.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
Bot Coexistence hakkında neyi bilmeli?
Bir insanın zaten konuşuyor olabileceğini. WhatsApp Business uygulaması numarada çalışmaya devam eder; bu yüzden bir müşteri aynı dakika içinde hem telefondan hem bottan yanıt alabilir. Akışta, bir yankı geldiğinde ne olacağına karar verin: çoğu ekip, araya giren kişinin lafı kesilmesin diye botu o kişi için bir süre duraklatır.
İkinci konu zamanlama. Gelen mesajları yanıtlayan bir bot, serbest metne izin verilen 24 saatlik müşteri hizmetleri penceresi içinde çalışır. Bir gün sonra bir şey gönderen akış, yani takip ya da hatırlatma, onaylı bir şablon gerektirir; orada serbest metin 131047 kodlu hatayı döndürür. Botpress'in kılavuzu, tam olarak bu tür proaktif mesajlar için şablon durum alanlarına abone olur.
Ve bir Coexistence numarasında hız saniyede 20 mesajla sabittir; bu, konuşan bir botun gönderdiğinden çok daha yüksektir.
Yaygın hatalar
- Client Secret alanını kendi Meta uygulamanızın secret'ı ile doldurmak. İmza hiçbir zaman eşleşmez ve Botpress her teslimata 401 ile yanıt verir.
- Manual Configuration yerine OAuth ya da sandbox seçeneğini seçmek. Bunlar numarayı zaten bağlı olanla değil, Botpress'in kendi uygulamasıyla bağlar.
- Yankıları yok saymak. Telefondan gönderilen yanıtlar için bir kural yoksa bot, araya girmiş kişinin üstüne konuşur.
Numarayı easycoexistence.com'da bağlayın, token'ını ve phone number id değerini Botpress'in Manual Configuration alanlarına yapıştırın ve Botpress webhook URL'sini hedef olarak ayarlayın. Numara başına aylık US$ 9'dan başlar, numara ekledikçe US$ 1'e düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
İmza kontrolünü atlamak güvenli mi?
Korumayı URL'ye taşır. Botpress webhook URL'sini her entegrasyon için ayrı üretir, bu yüzden gizli tutun. Medya yine de token ile Meta'dan alınmak zorundadır; sahte bir olay bunu taklit edemez.
Aynı numara n8n'i de besleyebilir mi?
Bir numaranın tek bir webhook hedefi vardır. Onu tek bir sisteme yönlendirin; olaylara ikinci bir sistem de gerekiyorsa oradan iletin.
Botpress WABA id'me ihtiyaç duyuyor mu?
Tanımı şimdilik isteğe bağlı olarak işaretliyor ve gelecekteki bir ana sürümde zorunlu olacağını belirtiyor; bu yüzden bağlantıdan alıp doldurun.
Mesajlar EasyCoexistence'tan geçiyor mu?
Hayır. Meta doğrudan Botpress webhook URL'sine iletir ve içerik bizim tarafımızda hiçbir zaman saklanmaz.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi