İçeriğe geç
ZZenWapp Docs

Başlarken

Hızlı başlangıç

Bu sayfanın sonunda çalışan bir API anahtarınız olacak ve ilk mesajınızı göndermiş olacaksınız.

Ön koşullar

  • Aktif bir ZenWapp hesabı ve en az bir bağlı kanal (örneğin WhatsApp numarası).
  • Kanalın bağlı (connected) durumda olması. Bağlı olmayan hesapta gönderim uçları hata döndürür.

1. API anahtarı oluşturun

Panelde Ayarlar → API bölümüne gidin ve yeni bir anahtar oluşturun. Anahtar yalnızca oluşturulduğu anda tam haliyle gösterilir; kapattıktan sonra tekrar görüntüleyemezsiniz.

Oluştururken yalnızca ihtiyaç duyduğunuz yetkileri seçin. Sadece mesaj gönderen bir entegrasyon için messages:send yeterlidir; * vermeyin.

Anahtarı istemci tarafına koymayın

API anahtarı hesabınızın tüm sohbet geçmişine erişebilir. Tarayıcı JavaScript'i, mobil uygulama paketi veya herkese açık depo gibi yerlerde saklamayın — çağrıları kendi sunucunuzdan yapın.

2. Bağlantıyı doğrulayın

Anahtarınızı ortam değişkeni olarak tanımlayın ve sağlık kontrolü ucunu çağırın. Bu çağrı hem anahtarın geçerliliğini hem de kanalın bağlantı durumunu doğrular.

export ZENWAPP_API_KEY="wa_live_..."

curl "https://api.zenwapp.com/api/v1/whatsapp/external/health" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY"

Yanıtta status: "ok" ve hesabınızın bilgileri geliyorsa kurulum doğrudur. 401 alıyorsanız anahtarı kontrol edin.

3. İlk mesajınızı gönderin

Mesaj gönderimi varsayılan olarak asenkrondur: istek kuyruğa alınır ve hemen 202 Accepted döner. Bu, WhatsApp tarafındaki gecikmelerin uygulamanızı bloklamamasını sağlar.

curl -X POST "https://api.zenwapp.com/api/v1/whatsapp/external/messages/send" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"905551234567","message":"ZenWapp entegrasyonu çalışıyor."}'

202 teslimat garantisi değildir

202 yanıtı yalnızca mesajın kuyruğa alındığını söyler. Gerçek teslimat durumunu webhook üzerinden gelen message.status olaylarıyla izleyin.

4. Gelen mesajları alın

Gelen mesajları yakalamak için sürekli sorgulama (polling) yapmayın; webhook tanımlayın. ZenWapp her olayı imzalayarak sizin uç noktanıza gönderir.

curl -X POST "https://api.zenwapp.com/api/v1/whatsapp/external/webhooks" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://sizin-sunucunuz.com/zenwapp/webhook",
    "events": ["message.received", "message.status"]
  }'

Sonraki adımlar