API referansı

Chats

Sohbet listesi, telefon numarasından sohbet eşleştirme ve sohbet mesaj geçmişi.

get/chats

Sohbetleri listele

Hesaba bağlı tüm sohbetleri döndürür.

Gerekli yetki: chats:read

İstek örneği

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

Yanıt 200

{
  "success": true,
  "data": [
    {
      "id": "[email protected]",
      "name": "Ahmet Yılmaz",
      "type": "individual",
      "is_muted": false,
      "is_archived": false,
      "last_message_at": "2026-07-30T08:45:12.000Z"
    }
  ]
}

Yanıt kodları

200Sohbet listesi
401API anahtarı eksik veya geçersiz
403API anahtarının bu uç için yetkisi yok

get/chats/resolve

Telefondan sohbet bul

Serbest formatlı bir telefon numarasını normalize ederek ilgili sohbeti bulur. Numara biçimi farklılıklarını (boşluk, +, 0 öneki) kendisi çözer.

Gerekli yetki: chats:read

Sorgu parametreleri

phonezorunlu string Ülke kodlu telefon numarası. `+90 555 123 45 67`, `05551234567` ve `905551234567` aynı sonucu verir.

İstek örneği

curl -X GET "https://api.zenwapp.com/api/v1/whatsapp/external/chats/resolve?phone=905551234567" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY"

Yanıt 200

{
  "success": true,
  "data": {
    "id": "[email protected]",
    "name": "Ahmet Yılmaz",
    "phone": "905551234567"
  }
}

Yanıt kodları

200Eşleşen sohbet
400Gövde veya sorgu parametreleri geçersiz
404Kaynak bulunamadı

get/chats/{chatId}/messages

Sohbet mesajlarını getir

Bir sohbetin mesaj geçmişini en yeniden eskiye doğru döndürür. Sayfalama `before` imleci ile yapılır.

Gerekli yetki: messages:read

Yol parametreleri

chatIdzorunlu string Sohbet kimliği (örn. `[email protected]`).

Sorgu parametreleri

`limit`	`integer`	Döndürülecek mesaj sayısı.Varsayılan: `50`
`before`	`ISO 8601`	Bu zaman damgasından önceki mesajları getirir (ISO 8601). Sayfalama imleci.
`include_raw`	`boolean`	Ham sağlayıcı verisini yanıta ekler.Varsayılan: `true`
`include_presigned_url`	`boolean`	Medya mesajları için süreli indirme bağlantısı üretir.Varsayılan: `true`

İstek örneği

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

Yanıt 200

{
  "success": true,
  "data": [
    {
      "id": "3EB0A1B2C3",
      "from": "[email protected]",
      "body": "Merhaba, fiyat listesi alabilir miyim?",
      "type": "chat",
      "timestamp": 1785400000,
      "from_me": false,
      "has_media": false
    }
  ]
}

Yanıt kodları

200Mesaj listesi
401API anahtarı eksik veya geçersiz
403API anahtarının bu uç için yetkisi yok