Üçüncü taraf uygulamalar için OAuth2

Yalnızca diğer WASync müşterilerinin kurduğu uygulamalar içindir. PKCE ile Authorization Code, döndürülen yenileme token'ları ve tek bir yapısal sınır.

Kendi hesabınızı otomatikleştiriyorsanız bunu atlayın

Bir API key, bu belgelerdeki her şeyi hiçbir ek mekanizma olmadan yapar. OAuth tam olarak tek bir iş için doğru araçtır: uygulamanız başka WASync müşterileri tarafından kuruluyor ve bu müşterilerin kendilerine ait bağlantılar için onay vermesi gerekiyor.

Uygulamayı kaydedin

https://developers.wasync.app/apps adresinde kayıt olun. Bir client_id ve bir client_secret alırsınız (yalnızca bir kez gösterilir). Ayrıca bir veya daha fazla redirect_uri (token değişiminde birebir eşleştirilir), isteğe bağlı bir webhook_url ve ihtiyaç duyduğunuz kapsamları (scope) belirlersiniz.

Akış

PKCE ile Authorization Code — S256 zorunludur. Kullanıcıyı /oauth/authorize adresine response_type=code, client_id, redirect_uri, scope, bir state ve bir code_challenge ile yönlendirin.

Endpoint	URL
Yetkilendirme	`https://cloudapi.wasync.app/oauth/authorize`
Token (`client_secret_post`)	`https://cloudapi.wasync.app/oauth/token`
Keşif	`https://cloudapi.wasync.app/.well-known/oauth-authorization-server`

Bu URL'ler ve MCP sunucu URL'si bilerek cloudapi.wasync.app olarak yazılmıştır. İstemci kitaplığınızın ve keşif belgelerimizin zaten kaydettiği protokol tanımlayıcılarıdır; bu yüzden birebir eşleşmeleri gerekir. Yalnızca REST temel URL'si ve kullanıcıya yönelik sayfalar kanonik developers.wasync.app adresini kullanır.

Bitrix24. WASync kısa bir kullanıcı kodu gösterir. Portalın API & Agents alanında Yazma erişimi olan biri bu kodu Settings → API & Agents altında girer ve bağlantıları ile kapsamları seçer. Her Bitrix24 yöneticisinin bu erişimi vardır; bir yöneticinin Staff sayfasındaki erişim matrisinde bu erişimi verdiği kişilerin de vardır.

Bağımsız (Standalone). Geliştirici onayı https://developers.wasync.app/authorize adresinde verir. Geliştirici, en az bir bağlantısı olan tam olarak bir çalışma alanına sahipse onay otomatik verilir.

Kodu token ile değiştirin

Token exchange

curl -X POST https://cloudapi.wasync.app/oauth/token \
  -d grant_type=authorization_code \
  -d code=$AUTH_CODE \
  -d redirect_uri=https://your.app/callback \
  -d client_id=$CLIENT_ID \
  -d client_secret=$CLIENT_SECRET \
  -d code_verifier=$CODE_VERIFIER

access_token 15 dakika geçerlidir. refresh_token 30 gün geçerlidir ve her kullanımda döndürülür (rotate edilir). Yeni token'ı atomik olarak kaydedin ve yenilemeleri worker'lar arasında sıraya koyun; aksi halde yarışan iki worker birbirinin token'ını geçersiz kılar.

Erişim token'ı, bir API key ile aynı başlıkta gönderilir: Authorization: Bearer …. Her iki kimlik bilgisi türü de tüm endpoint'lere erişir.

Tek bir yapısal sınır

Bir yetki (grant) yalnızca zaten var olan bağlantılar için verilir. Bu nedenle yalnızca OAuth kullanan bir entegrasyon, bir çalışma alanının ilk bağlantısını oluşturamaz. Bir API key oluşturabilir; hızlı başlangıç bu yüzden onunla başlar.

OAuth uygulamaları için webhooks

Bir OAuth uygulaması, PUT /webhook çağırmak yerine webhook_url değerini uygulamanın kendisinde ayarlar. Yetki, whatsapp.events ile onaylanmış olmalıdır; aksi halde hiçbir şey iletilmez. Geri kalan her şey (imza şeması, yeniden deneme politikası, payload'lar) Webhooks kılavuzu ile aynıdır.

24 Temmuz 2026 öncesinde oluşturulan abonelikler yalnızca message.received olayını alır; 10 Ağustos 2026 öncesinde oluşturulanlar bağlantı olaylarını almaz. Yeni olay türlerini almak için yeniden yetkilendirin veya mevcut aboneliğinize eklenmeleri için destek ekibine yazın.

Bu sayfa yardımcı oldu mu?