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

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.

20 mps

Hem WhatsApp Business uygulamasıyla hem de Cloud API ile kullanılan bir numaranın sabit işlem hızı.

2.24.17

Müşterinin numarasının Coexistence üzerinden bağlanabileceği en eski WhatsApp Business uygulama sürümü.

180 days

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.

24 hours

WhatsApp'ın, kullanıcının bir mesajı ya da araması sonrasındaki müşteri hizmetleri penceresi; her yeni mesaj pencereyi sıfırlar.

October 15, 2026

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:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

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_url adresine 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.
Reply inside the customer service window
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.
Bunu EasyCoexistence'la yapmak

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

SaaS için birleşik sosyal medya API'si: WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ve daha fazla kanal için tek entegrasyonMüşterilerinizin WhatsApp, Instagram, Facebook, TikTok, YouTube ve LinkedIn bağlantıları için tek entegrasyon: neyin birleştiği, her ağın kararı ve çağrılar.SaaS'ınıza TikTok paylaşımı nasıl eklenirMüşterilerinizin TikTok hesaplarını bağlayın, video ya da fotoğraf gönderisini tek istekle hemen veya sonra paylaşın ve her birini yayına girene kadar izleyin.Çok kiracılı sosyal medya API'si: tek API anahtarı, çok sayıda müşteri hesabıMüşteri hesaplarının tamamı için tek API anahtarı. Her hesabı external_ref ile etiketleyin, token'ları ayrı tutun, webhook'ları müşteri bazında yönlendirin.WhatsApp Embedded Signup müşterileriniz için: kendi Tech Provider uygulamanız mı, barındırılan bir sayfa mı?Bir SaaS, müşterilerinin WhatsApp numaralarını Coexistence ile nasıl bağlar: Tech Provider şartları, barındırılan sayfa ve müşterinin gördükleri.WhatsApp Business uygulamasının sohbet geçmişi ve kişileri API üzerinden nasıl içe aktarılırWhatsApp Business uygulama numarasının kişilerini ve 180 güne kadar sohbetlerini Coexistence ile içe aktarın: geçmiş webhook'ları, chunk_order, ilerleme, 2593109.24 saatlik müşteri hizmetleri penceresiMüşteri hizmetleri penceresinin ne olduğunu, ne zaman açılıp kapandığını ve bu sürede yanıtların neden ücretsiz olduğunu öğrenin.

İ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