API referansı

System

Sağlık kontrolü ve bağlı hesap bilgisi. Entegrasyonunuzu doğrulamak için ilk çağıracağınız uçlar.

get/health

Sağlık kontrolü

API anahtarınızın geçerliliğini ve bağlı hesabın durumunu doğrular. Entegrasyon kurulumunda ilk çağrılması önerilen uçtur.

Gerekli yetki: API anahtarı doğrulaması

İstek örneği

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

Yanıt 200

{
  "success": true,
  "status": "ok",
  "account": {
    "id": "b3d1e009-...",
    "name": "Satış Hattı",
    "status": "connected"
  },
  "timestamp": "2026-07-30T09:12:00.000Z"
}

Yanıt kodları

200API erişilebilir ve anahtar geçerli
401API anahtarı eksik veya geçersiz

get/account

Hesap bilgisi

API anahtarının bağlı olduğu hattın sağlayıcısını, bağlantı durumunu ve profil bilgisini döndürür. Bir entegrasyonun ilk çağrısı bu olmalı: `provider` alanı hangi gönderme uçlarının o hatta çalıştığını belirler (bkz. Sağlayıcılar tablosu). `assigned_agents` bu hatta erişimi olan ekip üyeleridir (hesap sahibi ilk sırada). ⚠️ **Atama hat düzeyindedir — ZenWapp'ta sohbet başına atama yoktur.** Bir sohbette en son kimin cevap yazdığını `GET /chats` yanıtındaki `last_responder` alanından okuyun.

Gerekli yetki: API anahtarı doğrulaması

İstek örneği

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

Yanıt 200

{
  "success": true,
  "data": {
    "account_id": "6e170999-ac8d-4286-80b8-5e2adf70c2ee",
    "provider": "evolution",
    "status": "ready",
    "phone": "905551234567",
    "pushname": "Satış Hattı",
    "platform": "evolution",
    "assigned_agents": [
      {
        "user_id": "a1f2c3d4-1111-2222-3333-444455556666",
        "name": "Okan Hocaoğlu"
      },
      {
        "user_id": "b2e3d4c5-7777-8888-9999-aaaabbbbcccc",
        "name": "Ayşe Yılmaz"
      }
    ]
  }
}

Yanıt kodları

200Hesap bilgisi
401API anahtarı eksik veya geçersiz