Embedded Signup ve Coexistence ile SaaS ürününüze WhatsApp nasıl eklenir
Bir SaaS, her müşterinin mevcut numarasını Meta'nın Coexistence'lı Embedded Signup akışıyla bağlayarak WhatsApp ekler; böylece numara WhatsApp Business uygulamasında çalışmaya devam eder. easyCoexistence'ın Partner API'siyle, müşteri başına bir bağlantı oturumu bu akışı barındırılan bir sayfada çalıştırır, Meta numaranın mesajlarını webhook_url adresine iletir ve arka ucunuz müşterinin kendi token'ıyla Cloud API üzerinden yanıt verir.
Hem WhatsApp Business uygulamasıyla hem de Cloud API ile kullanılan bir numaranın sabit işlem hızı.
Müşterinin numarasının Coexistence üzerinden bağlanabileceği en eski WhatsApp Business uygulama sürümü.
Meta'nın katılım sırasında paylaşabileceği sohbet geçmişinin ne kadar geriye gittiği; 24 saat içinde senkronize edilmelidir.
WhatsApp'ın, kullanıcının bir mesajı ya da araması sonrasındaki müşteri hizmetleri penceresi; her yeni mesaj pencereyi sıfırlar.
Embedded Signup v2 ve v3'ün Meta tarafından kullanımdan kaldırıldığı tarih; entegrasyonlar v4'e taşındı.
WhatsApp entegrasyonunun parçaları nelerdir?
Beş parça var; easyCoexistence ilk ve son parçayı üstlenir. Ürününüz konuşma mantığını, gelen kutusunu ve modelinizin ya da müşterilerinizin personelinin yazdığı her şeyi elinde tutar; Meta ise numara ile sunucunuz arasında mesajları taşır:
Coexistence müşterileriniz için neyi değiştirir?
Numaralarını ve telefonlarını korurlar. WhatsApp Business uygulaması Cloud API'nin yanında çalışmaya devam eder; böylece personel telefondan yanıt verirken ürününüz API üzerinden yanıt verir ve uygulamadan gönderdikleri webhook'unuza smb_message_echoes olarak ulaşır. Bununla birlikte üç sınır gelir: numara saniyede 20 mesaj gönderir, şablonları yalnızca API gönderebilir ve telefon yaklaşık 14 gün hareketsiz kalırsa Meta numarayı bağlantıdan keser.
Ürününüzde bağlantı adımı nasıl görünür?
Arka ucunuzdan redirect_url ile POST /connect-sessions çağıran bir Connect WhatsApp düğmesi vardır; müşterinizin kimliği external_ref olarak, webhook_url ve webhook_verify_token ile birlikte gönderilir, böylece Meta numarayı ilk dakikasından itibaren size yönlendirir. Müşteri barındırılan sayfada kısa bir kontrol listesini onaylar, Meta'nın açılır penceresini çalıştırır, WhatsApp Business uygulamasıyla bir QR kodu tarar ve connection_id ile size geri döner. Embedded Signup'ı kendi Tech Provider uygulamanızdan çalıştırmanın uygunluğu Embedded Signup kılavuzunda ele alınır.
Mesajlar arka ucunuza nasıl ulaşır?
Meta'dan doğrudan webhook_url adresine, easyCoexistence'a uğramadan ve hiçbir kopya tutulmadan. messages alanı müşterilerin gönderdiklerini ve sizin gönderdiklerinizin durumunu taşır; smb_message_echoes ise personelin uygulamadan gönderdiklerini taşır. Meta her teslimatı easyCoexistence'ın uygulama gizli anahtarıyla imzalar; bu anahtar asla paylaşılmaz, bu nedenle URL yolundaki uzun ve rastgele bir değer teslimatı doğrular. Bir WhatsApp Business Hesabındaki iki numara bir hedefi paylaşır; yönlendirmeyi value.metadata.phone_number_id alanına göre yapın.
Arka ucunuz nasıl yanıt verir ve şablon gönderir?
Meta'nın Graph API'si ve GET /connections/{id}?credentials=1 çağrısından alınan müşteri token'ıyla; bu çağrı send_endpoint alanını da döndürür. Serbest metin, kişinin son mesajından itibaren 24 saat içinde gönderilir; bundan sonra yalnızca Meta'nın onayladığı bir şablon gönderilebilir:
- Yanıt: pencere içinde type text ile POST /<
PHONE_NUMBER_ID>/messages. - Şablon: aynı çağrı, type template ile, şablon adı ve dil koduyla.
- Şablon oluşturma: POST /<
WABA_ID>/message_templates, ardından durumunu sorgulayın; inceleme sonuçlarıwebhook_urladresine ulaşmadığı için. - Medya: yüklemek için POST /<
PHONE_NUMBER_ID>/media; gelen medya, aynı token ile alınacak bir kimlik olarak gelir.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'Müşterinin mevcut sohbetleri ürününüze aktarılabilir mi?
Evet, ancak bağlantı sırasında bir kez. Oturumda webhook_url ayarlıysa easyCoexistence, Meta'dan numaranın kişilerini ve müşteri uygulamada kabul ederse 180 güne kadar sohbet geçmişini ister; bunlar smb_app_state_sync ve history webhook'ları olarak gelir. Meta bunu yalnızca bağlantıdan sonraki 24 saat içinde izin verir; bu nedenle bağlantı linki gönderilmeden önce uç noktanız yanıt verir durumda olmalıdır. Payload'ların ayrıntıları sohbet geçmişi kılavuzunda anlatılır.
Mesajların ücretini kim öder?
Müşteriniz. Meta, backend'inizin API ile gönderdiği mesajları müşterinin kendi WhatsApp Business Hesabına, müşterinin orada eklediği bir ödeme yöntemiyle faturalandırır; ödeme yöntemi olmayan bir işletme pazarlama şablonu gönderemez. easyCoexistence, hesabınızdan bağlı numara başına ücretlendirir; mesajlardan asla ücret almaz ve Meta'nın fiyatlarına zam yapmaz.
Bir numara bağlantıdan düştüğünde ne olur?
Olay URL'niz, bilindiğinde Meta'nın nedeniyle birlikte connection.disconnected olayını alır. PRIMARY_INACTIVITY, 14 günlük kuraldır; o müşteri için yeni bir bağlantı oturumu aynı numarayı geri getirir. connection.token_missing, numaranın müşterinin token'ı olmadan bağlandığı anlamına gelir; bu numara mesaj alır ancak yeni bir oturum onu yeniden bağlayana kadar mesaj gönderemez.
Yaygın hatalar
- Bağlantı linkini, webhook uç noktanız yanıt vermeden göndermek. Geçmiş içe aktarımı bağlantıdan sonraki 24 saat içinde bir kez çalışır; URL'niz çalışmadan önce gönderilen içerik kaybolur.
- Pencere kapandıktan sonra serbest metinle yanıt vermek. Kişinin son mesajından 24 saat geçtikten sonra yalnızca onaylı bir şablon iletilir.
- Bir kampanyayı tek bir numaradan tam hızda göndermek. Coexistence numarası saniyede 20 mesaj gönderir; bu nedenle her numaranın gönderimlerini bu hızda kuyruğa alın.
- Personelin şablonları telefondan göndermesini beklemek. Coexistence'ta yalnızca API şablon gönderir; bu nedenle şablon gönderimlerini ürününüzde yapılandırın.
easyCoexistence, Meta'nın Embedded Signup ve Coexistence akışını adınızı gösteren barındırılan bir sayfada SaaS ürününüze WhatsApp olarak ekler: müşterileriniz numaralarını ve WhatsApp Business uygulamasını korur, Meta mesajları sunucunuza iletir ve size imzalı olaylar olarak ulaşır. Aynı API ile Instagram, Facebook, TikTok, YouTube, LinkedIn ve daha fazla kanala da bağlanabilirsiniz. Bağlantı başına, ayda US$ 9 ile US$ 0.75 arasında; bağlantı sayısı arttıkça düşer, ilk 3 gün ücretsizdir.
Sık sorulan sorular
Başka bir WhatsApp API sağlayıcısında bulunan bir numara bağlanabilir mi?
Orada olduğu sürece hayır. Barındırılan kontrol listesi, üzerinde başka bir API sağlayıcısı ya da otomasyon aracı olmayan bir numara ister; bu nedenle müşteri önce numarayı o sağlayıcıdan çıkarır.
SaaS'ım müşterileri adına WhatsApp şablonları gönderebilir mi?
Evet; her müşterinin token'ıyla Cloud API üzerinden. Şablonu müşterinin WhatsApp Business Hesabında oluşturun, Meta'nın incelemesini bekleyin, ardından gönderin.
easyCoexistence müşterilerimin WhatsApp mesajlarını okur mu?
Hayır. Meta, bir numaranın mesajlarını sizin belirlediğiniz webhook_url adresine doğrudan iletir. webhook_url alanı olmayan bir numara easyCoexistence'ın geri çağrısına döner; burada mesajlar saklanmadan atılır.
easyCoexistence, WhatsApp numarası başına ne kadar tutar?
Aylık numara başına US$ 9 ile US$ 0.75 arasında; toplam bağlantı sayınızın bandına göre ve ilk 3 gün ücretsiz. Meta'nın mesaj ücretleri her müşterinin kendi WhatsApp Business Hesabına gider.
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