Bağlantı türleri
provider alanı qr veya cloud_api değerini alır. Her birinin neler yapabildiği ve ikisinin gerçekten nerede ayrıştığı.
Her bağlantı bir provider bildirir ve bu alan iki değerden biridir:
provider | Nedir | Nasıl devreye alınır |
|---|---|---|
qr | Bir cihaz bağlanarak eşleştirilen, sıradan bir WhatsApp numarası (WAPP olarak satılır). | POST /connections, ardından QR kodunu tarayın veya eşleştirme kodunu girin. API üzerinden tamamen self-servis — Meta Business hesabı gerekmez. |
cloud_api | Meta'ya kayıtlı, resmi Cloud API üzerinde çalışan bir WhatsApp Business numarası (WABA olarak satılır). | Bu API üzerinden değil, Meta Embedded Signup ile. |
Her iki tür de aynı uç noktalar üzerinden, aynı istek gövdeleri ve aynı iki mesaj kimliğiyle gönderir ve alır. Kendi uygulamanızdan QR ile bağlanmanın mümkün olmadığını düşünüyorsanız: mümkündür.
Gerçekte nerede ayrışırlar
Webhooks. Olaylar yalnızca qr bağlantıları için tetiklenir. cloud_api
bağlantıları şu an hiçbir webhook göndermez — bunlar için GET /messages ve
GET /connections/{id} uç noktalarını düzenli aralıklarla sorgulayın.
Eşleştirme. POST /connections/{id}/pairing-code yalnızca qr için geçerli
bir kavramdır. Bir cloud_api numarası 409 not_supported_for_provider yanıtı
verir; bu kalıcı bir reddedilmedir, bu yüzden isteği yeniden denemeyin.
Gönderim gecikmesi. Bir qr gönderimi normalde 1–7 sn sürer (uzun bir metinde
~20 sn'ye kadar) ve kendini onarma yolunda ~2,5 dakika sürebilir. Bir cloud_api
gönderimi yaklaşık 1 sn sürer. HTTP zaman aşımınızı yavaş olana göre belirleyin:
en az 180 sn.
Okundu işaretleme. POST /messages/read, bir qr bağlantısında sohbetin
tamamını okundu olarak işaretler. Bir cloud_api bağlantısı yalnızca belirli bir
mesajı işaretleyebilir; bu yüzden yalnızca phone içeren bir istekte, o
numaradan gelen en son mesajınız otomatik olarak bulunur.
Hacim. Yeni eşleştirilmiş bir qr numarasında saatlik hacme uygulanan 72
saatlik ısınma sınırları vardır; bir sınırın aşılması 429 warmup_limited
döndürür. Bkz.
Lisanslar ve deneme.
Oturum sağlığı. Bir qr bağlantısı, erişilebilir kalması gereken bir
telefona bağlıdır; bu yüzden kopabilir ve yeniden eşleştirme istenebilir.
connection.disconnected / connection.connected olayları ve needs_reconnect
bayrağı bunun içindir. Bir cloud_api bağlantısı hiçbir şey taramaz ve bu tür
bir arıza yaşamaz.
Bilinmeyen provider değerleri sızmaz
provider, tanınmayan bir değeri olduğu gibi geçirmek yerine null olarak
eşlenir. İleride yeni bir bağlantı türü eklenirse burada bilinçli olarak
adlandırılacaktır; bu yüzden bugün qr / cloud_api üzerinden dallanmak
güvenlidir — ancak null değerini, istemcinin bilmediği bir tür olarak ele alın
ve bu yüzden çökmeyin.
Çalışma alanları
Bir anahtar tam olarak tek bir çalışma alanına aittir. Bunun çok kiracılı uygulamalar için ne anlama geldiği ve bir Bitrix24 portalının bağımsız bir çalışma alanından farkı.
Lisanslar ve deneme süresi
Her numara için 7 günlük ücretsiz deneme, ardından numara başına aylık lisans. Slot nedir ve süresi dolduğunda ne olur?