İlk çağrınız
Anahtarınızın erişebildiği bağlantıları listeleyin ve yenisini oluşturmadan önce kapasitenizin olduğunu kontrol edin.
Temel URL https://developers.wasync.app/api/v1.
Kullanabileceğiniz bağlantıları listeleyin
curl https://developers.wasync.app/api/v1/connections \
-H "Authorization: Bearer $WASYNC_API_KEY"Yalnızca etkin lisansı olan bağlantılar görünür. Her birinde qr veya cloud_api değerini taşıyan bir provider, bir id (cuid — kendi müşteri kaydınızla birlikte saklamanız gereken kalıcı tanımlayıcı) ve bir status bulunur. whatsapp.read kullanır.
cloudapi.wasync.app/api/v1 adresini zaten mi kullanıyorsunuz? Kullanmaya devam edin.
developers.wasync.app esas adrestir, ancak cloudapi.wasync.app aynı API için kalıcı bir takma addır: aynı anahtarlar, aynı yollar, aynı yanıtlar. Süresiz olarak geçerli kalır. Mevcut hiçbir entegrasyonun herhangi bir şeyi değiştirmesi gerekmez. OAuth uç noktaları, /.well-known/… belgeleri ve MCP sunucusu URL'si, istemciler tarafından kaydedilen protokol tanımlayıcılarıdır; bilerek cloudapi.wasync.app üzerinde kalırlar.
Söz vermeden önce kapasitenizi kontrol edin
curl https://developers.wasync.app/api/v1/account \
-H "Authorization: Bearer $WASYNC_API_KEY"{
"slots": {
"total": 30,
"used": 28,
"available": 2,
"nextExpiry": "2027-08-08T09:00:00.000Z"
},
"connections": {
"total": 28,
"connected": 27,
"needsReconnect": 1
}
}slots.available, şu anda yeni bir numara ekleyip ekleyemeyeceğinizi söyler. nextExpiry ise kendi müşterinize fatura kesmeniz gereken son tarihtir; böylece size ödeme yapmış biri için bir slot hiçbir zaman süresi dolarak kaybolmaz. connections.needsReconnect, sahibinin QR taramasını bekleyen numaraların sayısını verir. Bu numaranın durumunun ne zaman değiştiğini sürekli sorgulamak yerine anında öğrenmek için bağlantı olaylarına abone olun. whatsapp.read kullanır.
Slot, bir telefon numarası değil, kapasitedir. Bir bağlantıyı sildiğinizde slotu, üzerinde kalan süreyle birlikte havuzunuza döner; bağlayacağınız bir sonraki numara onu otomatik olarak devralır. Ödenmiş bir slotu ayrılan bir müşteriden yeni bir müşteriye iki kez ödemeden taşıyabilmenizi sağlayan da budur.
Bir numara bağlayın
Tek bir çağrı bağlantıyı oluşturur ve taranacak bir QR kodu döndürür. Hiç bağlantısı olmayan yepyeni bir çalışma alanında da çalışır; bir anahtarla önce portalda tıklanacak hiçbir şey yoktur.
curl -X POST https://developers.wasync.app/api/v1/connections \
-H "Authorization: Bearer $WASYNC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"label":"Support line"}'{
"connection": {
"id": "conn_8f3a21",
"status": "connecting",
"qr": "data:image/png;base64,iVBORw0KGgo…"
}
}Burada aldığınız QR geçerliliğini korumaz
WhatsApp eşleştirme kodunu yaklaşık her 20 saniyede bir yeniler. Bu yüzden oluşturma yanıtındaki qr, gösterildikten birkaç saniye sonra eskimiş olur. Bu sessizce başarısız olur: telefon hiç eşleşmez ve ekranda nedenini açıklayan hiçbir şey görünmez. GET /connections/{id} çağrısını her 3–5 saniyede bir yapın ve qr değerini her yanıttan yeniden oluşturun. Önbelleğe almayın ve yenilemeyi kullanıcının basması gereken bir düğmenin arkasına gizlemeyin. Eşleştirme kodu ve QR sayfası, tek cihazlı alternatifi anlatır.
whatsapp.manage kullanır. Bu şekilde oluşturulan bağlantılar qr numaralarıdır; cloud_api numaraları ise bunun yerine Meta Embedded Signup üzerinden eklenir. Bu uç nokta yalnızca bağımsız çalışma alanları içindir. Bir Bitrix24 portalına 403 forbidden_portal_kind yanıtı verilir, çünkü orada bağlantıları portal yöneticisi WASync içinde oluşturur. Bir Idempotency-Key gönderin: bağlantı oluşturmak ücretli bir slot tüketir ve anahtarsız yapılan, zaman aşımına uğramış bir yeniden deneme size iki slot satın aldırır. Hatalar ve idempotency sayfasında ele almanız gereken dört durum yer alır.