Coexistence numarasını Chatwoot WhatsApp Cloud gelen kutusu olarak kullanın

Coexistence numarası Chatwoot'a nasıl bağlanır?

İki yerde, şu sırayla.

Chatwoot'ta bir gelen kutusu ekleyin, WhatsApp'ı seçin ve manuel kurulumla WhatsApp Cloud sağlayıcısını belirleyin. Numarayı, telefon numarası kimliğini, WhatsApp Business hesabı kimliğini ve erişim token'ını girin. Bunların hepsini EasyCoexistence panelinde bağlantının sayfasında görürsünüz; bir asistan için get_api_credentials aracı da döndürür. Ardından Chatwoot, gelen kutusu için bir webhook URL'si ve bir webhook doğrulama token'ı gösterir.

EasyCoexistence'ta numaranın webhook hedefini bu URL'ye ayarlayın ve aynı doğrulama token'ını girin. Meta doğrulama isteğini Chatwoot'a gönderir, Chatwoot yanıtlar ve bundan sonra numaraya gelen her mesaj gelen kutusuna düşer. Arada hiçbir şey çalışmaz, yani ayakta tutulacak bir iş akışı yoktur.

Telefondan gönderilen yanıtlar Chatwoot'ta görünür mü?

Evet. Coexistence numarasında WhatsApp Business uygulamasında yazılan bir yanıtı Meta, smb_message_echoes olayı olarak bildirir. Chatwoot'un webhook işi bu alanı tanır ve mesajı doğru görüşmeye giden mesaj olarak kaydeder. Kaynak kodu bu durumu doğrudan tarif eder: hem Chatwoot'tan hem uygulamadan yanıt veren işletmeler, mesajlar Chatwoot'a senkronlanır.

Bölüşüm böylece pratikte işler. İşletme sahibi düzenli müşterilere telefondan yanıt vermeyi sürdürebilir, ekip masa başında ortak gelen kutusunu yönetebilir; ekran görüntüsü iletmeye gerek kalmadan herkes diğerinin gönderdiğini görür.

Chatwoot'tan gönderilen mesajlar aynı numara üzerinden Cloud API ile çıkar, dolayısıyla telefonda da görünür.

Chatwoot gelen kutusunda neden uygulama gizli anahtarı olmamalı?

Çünkü teslimatlar sizde olmayan bir anahtarla imzalanır. Meta her webhook'u, aboneliğin sahibi olan uygulamanın, yani EasyCoexistence uygulamasının gizli anahtarıyla imzalar ve bu anahtar asla paylaşılmaz.

Chatwoot'un güncel kaynak kodu, elle yapılandırılmış bir WhatsApp Cloud kanalında X-Hub-Signature-256 başlığını yalnızca kanalda bir uygulama gizli anahtarı saklıysa veya kanal Chatwoot'un kendi Embedded Signup akışıyla oluşturulduysa denetler. Uygulama gizli anahtarı olmayan manuel gelen kutusu teslimatları kabul eder; herhangi bir uygulama gizli anahtarı girilmiş olan ise hepsini yetkisiz diye reddeder.

Burada geçerli koruma doğrulama token'ıdır. Uzun, rastgele bir değer seçin; Chatwoot, Meta'nın doğrulama isteğini başkalarınınkinden bu sayede ayırır.

Chatwoot bu numarada neleri yapamaz?

Aynı anda ikinci bir yerde webhook almak. Meta bir numaranın webhook'larını tek bir hedefe yönlendirir; Chatwoot hedefi tuttuğu sürece bir n8n iş akışı aynı olayları almaz. İkisine de ihtiyacınız varsa hedefi, her teslimatı hem Chatwoot'a hem iş akışına ileten kendi küçük aktarıcınıza yönlendirin.

Coexistence sınırları her yerdeki gibi geçerlidir: API saniyede en fazla 20 mesaj gönderir, serbest metin yalnızca müşterinin son mesajından sonraki 24 saat içinde gider, sonrasındaki her şeyi şablonlar karşılar.

WhatsApp Business uygulamasının en az 14 günde bir açılması gerekir; EasyCoexistence bunu izler.

Yaygın hatalar

• Chatwoot gelen kutusuna uygulama gizli anahtarı girmek. Teslimatlar EasyCoexistence uygulamasının anahtarıyla imzalanır, bu yüzden Chatwoot hepsini yetkisiz diye reddeder.
• EasyCoexistence'ta Chatwoot'un gösterdiğinden farklı bir doğrulama token'ı kullanmak. Meta'nın doğrulaması başarısız olur ve gelen kutusu hiç mesaj almaz.
• Manuel akış yerine Chatwoot'un Embedded Signup'ını seçmek. Bu, numarayı Chatwoot'un kendi Meta uygulaması üzerinden bağlar; ayrı bir bağlantıdır.

Sık sorulan sorular

Okumaya devam edin