Hesap ve anahtar oluşturun
Anahtar almanın iki yolu — Bitrix24 içinden ya da geliştirici konsolunda e-posta ve parolayla. Yönlendirme URI'si yok, PKCE yok, onay ekranı yok.
WASync'i nasıl kullandığınıza bağlı olarak API key almanın iki eşit geçerli yolu vardır.
Uygulamayı Bitrix24'te açın, Ayarlar → API ve Ajanlar bölümüne gidin ve API anahtarları kartını bulun. Entegrasyona bir ad verin ve Anahtar oluştur düğmesine tıklayın.
Anahtar oluşturmak için API eklentisi etkin olan en az bir bağlantı gerekir
(numara başına ayda 12 $). Eklenti yoksa düğme nedeniyle birlikte devre dışı kalır
ve sunucu 403 addon_required yanıtı verir. Anahtar, tam orada bir kez gösterilir;
yanında bir Kopyala düğmesi bulunur ve standart whatsapp.read whatsapp.send
kapsamlarını taşır.
IP izin listeleri, webhook yapılandırması ve tek hesaptan birden fazla portalı yönetme bu kartta değil, geliştirici konsolunda yer alır. Kart, konsola bağlantı verir.
Anahtar yalnızca bir kez gösterilir; saklanan şey yalnızca özetidir (hash). Hemen ortamınıza kopyalayın.
export WASYNC_API_KEY=wsk_live_…Her istekte şu başlığı gönderin:
Authorization: Bearer $WASYNC_API_KEYKimlik doğrulama kurulumu bundan ibarettir. Yönlendirme URI'si yok, PKCE yok, onay ekranı yok, token yenileme yok.
Kapsamlar
Yalnızca entegrasyonun ihtiyaç duyduğu kapsamları işaretleyin. Kapsamlar anahtar başınadır.
| Scope | Neye izin verir |
|---|---|
whatsapp.read | Bağlantıları listeler ve mesajları okur. |
whatsapp.send | Mesaj gönderir ve okundu bilgilerini okur. |
whatsapp.events | webhook'ları alır ve nereye gideceklerini yapılandırır. |
whatsapp.manage | Bağlantıları oluşturur, inceler, yeniden başlatır, oturumunu kapatır ve siler. |
Kapsamlar ve erişilebilir bağlantı listesi her istekte canlı olarak çözümlenir. Bu nedenle bir anahtarı iptal etmek ya da kapsamını daraltmak bir sonraki çağrıda hemen etkili olur; önbelleğe alınmış hiçbir şey ve yenilenecek hiçbir şey yoktur. Ayrıntılar ve her kapsamın sızması hâlinde size neye mal olacağı Kapsamlar sayfasında yer alır.
Kendinizi dışarıda bırakamazsınız
İsteğe bağlı IP izin listesi yalnızca API çağrılarında uygulanır. Listeyi düzenlediğiniz sayfa anahtarla değil hesabınızla doğrulanır; bu yüzden her adresten erişilebilir kalır. Bkz. IP izin listesi.
Bir bağlantının maliyeti
Her WhatsApp numarasının mesaj gönderip alabilmesi için etkin bir lisansa ihtiyacı vardır.
Yeni bir numara 7 günlük ücretsiz denemeyle başlar. Ardından qr (WAPP) numarası için
numara başına ayda 19 $, cloud_api (WABA) numarası için numara başına ayda 29 $ ödenir;
fiyatlar USD cinsindendir. Bir Bitrix24 portalında bir numaraya API erişimi, numara başına
ayda 12 $ tutarında ayrı bir eklentidir. Tüm ayrıntılar için
Lisanslar ve deneme sayfasına bakın.