Ücretsiz demo hesabıGiriş yap

Geliştirici API’si

Kişileri, randevuları, konuşmaları ve çağrıları kendi CRM’inize ya da klinik yazılımınıza bağlayın. Olaylar anında gelsin istiyorsanız Ayarlar › Entegrasyonlar › Webhook’lar bölümünden imzalı webhook ekleyin.

  • Temel adreshttps://zilko.co/api/v1
  • Sürüm 1.0.0
  • OpenAPI 3.1
İçindekiler

Başlarken

ZILKO REST API, işletmenizin kişilerini, randevularını, konuşmalarını ve aramalarını kendi CRM’inize, klinik yazılımınıza ya da otomasyon aracınıza bağlar. İstekler ve yanıtlar JSON’dur; bütün zamanlar ISO 8601 biçiminde ve UTC’dir.

  1. Panelde Ayarlar › Entegrasyonlar › Geliştirici API’si bölümünden bir anahtar oluşturun. Kişi ya da randevu yazacaksanız “Okuma ve yazma” erişimini seçin. /clinic/settings?tab=integrations
  2. Her istekte anahtarı Authorization başlığıyla gönderin ve aşağıdaki uçları çağırın.
  3. Yeni kişi, randevu ya da arama olduğunda anında haber almak için imzalı webhook ekleyin.
curl "https://zilko.co/api/v1/me" \
  -H "Authorization: Bearer zk_live_…"

Kimlik doğrulama

Her istek anahtarı Bearer olarak taşır. Anahtar yalnız kendi işletmesinin verisini görür; tamamı yalnız oluşturulduğunda bir kez gösterilir. Kaybolan ya da sızan anahtarı panelden iptal edip yenisini oluşturun.

Authorization: Bearer zk_live_…
Kapsamİzin verdiği
readGET uçları: kişiler, randevular, boş saatler, ekip, konuşmalar, aramalar.
writeOkumaya ek olarak POST ve PATCH: kişi ekleme ve güncelleme, not, randevu oluşturma ve güncelleme.

Demo hesaplarda anahtarlar çalışmaz (409 DEMO_MODE); hesap etkinleşince açılır.

Temel adres

https://zilko.co/api/v1

Bütün yollar bu adrese eklenir. Yalnız HTTPS kabul edilir.

İstek sınırı

Anahtar başına dakikada 120 istek. Sınır aşılınca 429 RATE_LIMITED döner; kısa bir süre bekleyip yeniden deneyin. Toplu eşitlemede updatedSince ile yalnız değişenleri çekin.

Hatalar

Hata yanıtları her zaman aynı zarfı taşır. code makinenin, message insanın okuması içindir; doğrulama hatalarında fields hangi alanın neden geçersiz olduğunu söyler.

{
  "error": {
    "code": "VALIDATION",
    "message": "Invalid request",
    "fields": [{ "path": "startsAt", "message": "Invalid datetime" }]
  }
}
KodAnlamı
400 VALIDATIONGeçersiz istek; fields alanlara göre ayrıntı verir.
401 UNAUTHORIZEDAnahtar yok, biçimi yanlış ya da iptal edildi.
403 FORBIDDENAnahtarın kapsamı yetmiyor (yazma için “write”) ya da işletme durduruldu (CLINIC_SUSPENDED).
404 NOT_FOUNDKayıt bulunamadı ya da başka işletmeye ait.
409 CONFLICTSaat dolu, kayıt durumu uygun değil ya da hesap demo (DEMO_MODE).
429 RATE_LIMITEDDakikalık istek sınırı (120) aşıldı.

Sayfalama

Liste uçları imleçle sayfalanır: limit (1–100, varsayılan 50) ve cursor parametreleri. Yanıt { items, nextCursor } biçimindedir; bir sonraki sayfa için nextCursor değerini cursor olarak gönderin. nextCursor null ise son sayfadasınız.

curl "https://zilko.co/api/v1/contacts?limit=50&cursor=clx8f2k1a0042" \
  -H "Authorization: Bearer zk_live_…"

{ "items": [ … ], "nextCursor": "clx8f2k1a0091" }

Webhook’lar

Olayların anında gelmesi için Ayarlar › Entegrasyonlar › Otomasyon bölümünden https adresi ekleyin. Her teslim JSON gövdeli bir POST’tur; Zapier, Make, n8n, Kommo ve respond.io doğrudan kabul eder.

Olaylar

  • lead.created

    Yeni bir kişinin ilk teması: ad, telefon, kanal, dil ve ilk mesaj.

  • conversation.summary

    Zilko’nun yürüttüğü konuşma 30 dakika sessiz kalınca ya da ekip devralınca; son 10 mesaj.

  • appointment.created

    Randevu oluşturuldu: kişi, başlangıç ve bitiş, durum, kaynak ve uzman.

  • appointment.updated

    Randevu değişti (saat, durum ya da uzman).

  • appointment.cancelled

    Randevu iptal edildi.

  • call.ended

    Arama bitti: yön, süre, sonuç ve özet.

  • call.callback_requested

    Aramada kişi ekiple hemen görüşmek istedi: neden, kısa not ve geri aranacak numara.

Başlıklar

  • X-Zilko-Event

    olay türü, ör. appointment.created

  • X-Zilko-Delivery

    teslim kimliği (yeniden denemelerde aynı)

  • X-Zilko-Signature

    t=<unix saniye>,v1=<HMAC-SHA256 hex>

İmza doğrulama: başlıktaki t ile ham gövdeyi “t.gövde” olarak birleştirin, webhook’un gizli anahtarıyla HMAC-SHA256 hesaplayın ve v1 ile sabit zamanlı karşılaştırın. t 5 dakikadan eskiyse isteği reddedin. Gövdedeki id olay kimliğidir; tekrar gelen olayları bununla ayıklayın.

// Node.js (Express: express.raw({ type: 'application/json' }))
const crypto = require('crypto');
const header = req.get('X-Zilko-Signature'); // t=…,v1=…
const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
const expected = crypto.createHmac('sha256', process.env.ZILKO_SIGNING_KEY)
  .update(`${parts.t}.${req.body}`).digest('hex');
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1))
  && Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;

Alıcı 2xx dışında yanıt verir ya da 10 saniyede yanıt vermezse Zilko yaklaşık bir saat içinde 5 kez dener. Art arda 50 başarısız teslimde adres kapanır ve işletmeye bildirim gider.

Hesap

Anahtarın bağlı olduğu işletme.

GET/me

Anahtarın işletmesi

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/me" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "business": {
    "id": "clx8f2k1a0001",
    "name": "Elif Şahin",
    "sector": "DENTAL",
    "timezone": "Europe/Istanbul",
    "locale": "tr"
  },
  "key": {
    "name": "Elif Şahin",
    "scopes": [
      "read"
    ]
  }
}

Kişiler

Müşteri, hasta ya da misafir kayıtları (CRM).

GET/contacts

Kişileri listele

Parametreler

  • qstringsorgu

    Ad, telefon ya da e-posta içinde arama.

  • stageStagesorgu

    NEW_LEAD, NO_ANSWER, AWAITING_MEDIA, CONSULTATION, CONFIRMED, LOST

  • updatedSincestring (date-time)sorgu

    Bu andan sonra değişenler (eşitleme).

  • cursorstringsorgu

    Önceki yanıttaki nextCursor.

  • limitintegersorgu

    1–100 · varsayılan 50

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/contacts?limit=20" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "items": [
    {
      "id": "clx8f2k1a0001",
      "name": "Elif Şahin",
      "phone": "+90 532 000 00 00",
      "email": "elif@example.com",
      "country": "TR",
      "language": "tr",
      "stage": "NEW_LEAD",
      "source": "INSTAGRAM",
      "createdAt": "2026-10-28T09:15:00.000Z",
      "updatedAt": "2026-10-28T09:15:00.000Z"
    }
  ],
  "nextCursor": "clx8f2k1a0042"
}
POST/contacts“write” kapsamı gerekir

Kişi ekle (telefon ya da e-postayla eşleşen kişi varsa onu döner)

İstek gövdesi · ContactInput

  • namestringzorunlu

    en çok 160 karakter

  • phonestring

    Uluslararası biçim önerilir (+49 …).

    en çok 40 karakter

  • emailstring (email)
  • countrystring

    en çok 80 karakter

  • languagestring

    en çok 32 karakter

  • stageStage

    NEW_LEAD, NO_ANSWER, AWAITING_MEDIA, CONSULTATION, CONFIRMED, LOST

  • notestring

    Kişiye ilk not.

    en çok 5000 karakter

Yanıtlar

  • 200Aynı telefon ya da e-postayla kayıtlı kişi
  • 201Oluşturuldu
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl -X POST "https://zilko.co/api/v1/contacts" \
  -H "Authorization: Bearer zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Elif Şahin",
    "phone": "+90 532 000 00 00",
    "email": "elif@example.com",
    "language": "tr",
    "note": "İmplant fiyatını sordu."
  }'
Örnek yanıt · 201
{
  "id": "clx8f2k1a0001",
  "name": "Elif Şahin",
  "phone": "+90 532 000 00 00",
  "email": "elif@example.com",
  "country": "TR",
  "language": "tr",
  "stage": "NEW_LEAD",
  "source": "INSTAGRAM",
  "createdAt": "2026-10-28T09:15:00.000Z",
  "updatedAt": "2026-10-28T09:15:00.000Z"
}
GET/contacts/{id}

Kişi

Parametreler

  • idstringzorunluyol

    Kişi kimliği

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/contacts/clx8f2k1a0001" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "id": "clx8f2k1a0001",
  "name": "Elif Şahin",
  "phone": "+90 532 000 00 00",
  "email": "elif@example.com",
  "country": "TR",
  "language": "tr",
  "stage": "NEW_LEAD",
  "source": "INSTAGRAM",
  "createdAt": "2026-10-28T09:15:00.000Z",
  "updatedAt": "2026-10-28T09:15:00.000Z"
}
PATCH/contacts/{id}“write” kapsamı gerekir

Kişiyi güncelle

Parametreler

  • idstringzorunluyol

    Kişi kimliği

İstek gövdesi · ContactUpdate

  • namestring
  • phonestring | null
  • emailstring | null
  • countrystring | null
  • languagestring | null
  • stageStage

    NEW_LEAD, NO_ANSWER, AWAITING_MEDIA, CONSULTATION, CONFIRMED, LOST

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl -X PATCH "https://zilko.co/api/v1/contacts/clx8f2k1a0001" \
  -H "Authorization: Bearer zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "stage": "NEW_LEAD"
  }'
Örnek yanıt · 200
{
  "id": "clx8f2k1a0001",
  "name": "Elif Şahin",
  "phone": "+90 532 000 00 00",
  "email": "elif@example.com",
  "country": "TR",
  "language": "tr",
  "stage": "NEW_LEAD",
  "source": "INSTAGRAM",
  "createdAt": "2026-10-28T09:15:00.000Z",
  "updatedAt": "2026-10-28T09:15:00.000Z"
}
POST/contacts/{id}/notes“write” kapsamı gerekir

Kişiye not ekle

Parametreler

  • idstringzorunluyol

    Kişi kimliği

İstek gövdesi

  • textstringzorunlu

    en çok 5000 karakter

Yanıtlar

  • 201Eklendi
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl -X POST "https://zilko.co/api/v1/contacts/clx8f2k1a0001/notes" \
  -H "Authorization: Bearer zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Geri arandı, teklifi e-postayla istiyor."
  }'
Örnek yanıt · 201
{
  "id": "clx8f2k1a0001",
  "text": "Merhaba, implant için bilgi almak istiyorum.",
  "createdAt": "2026-10-28T09:15:00.000Z"
}

Randevular

Randevu ve rezervasyonlar; boş saatler.

GET/appointments

Randevuları listele

Parametreler

  • fromstring (date-time)sorgu

    Başlangıç (dahil). Varsayılan: şimdi.

  • tostring (date-time)sorgu

    Bitiş (hariç). Varsayılan: 30 gün sonra.

  • statusAppointmentStatussorgu

    PENDING, BOOKED, CONFIRMED, COMPLETED, CANCELLED, NO_SHOW

  • contactIdstringsorgu
  • cursorstringsorgu

    Önceki yanıttaki nextCursor.

  • limitintegersorgu

    1–100 · varsayılan 50

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/appointments?limit=20" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "items": [
    {
      "id": "clx8f2k1a0001",
      "contactId": "clx8f2k1a0001",
      "contact": {
        "id": "clx8f2k1a0001",
        "name": "Elif Şahin",
        "phone": "+90 532 000 00 00"
      },
      "staffId": "stf_3k9d",
      "startsAt": "2026-10-30T11:00:00.000Z",
      "endsAt": "2026-10-30T11:30:00.000Z",
      "status": "PENDING",
      "kind": "CONSULTATION",
      "source": "INSTAGRAM",
      "partySize": 2,
      "notes": "İlk muayene",
      "createdAt": "2026-10-28T09:15:00.000Z"
    }
  ],
  "nextCursor": "clx8f2k1a0042"
}
POST/appointments“write” kapsamı gerekir

Randevu oluştur

contactId ya da contact verin; contact verilirse telefon/e-postayla eşleşen kişi kullanılır, yoksa açılır. Çakışan saat 409 döner.

İstek gövdesi · AppointmentInput

  • contactIdstring
  • contactContactInput
  • startsAtstring (date-time)zorunlu
  • durationMininteger

    Varsayılan 30 (restoranda oturma süresi).

    5–480

  • endsAtstring (date-time)

    Otelde çıkış.

  • kindstring
  • staffIdstring
  • partySizeinteger

    1–500

  • notesstring

    en çok 2000 karakter

Yanıtlar

  • 201Oluşturuldu
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 409Saat dolu ya da kayıt durumu uygun değil
  • 429Anahtar başına dakikada 120 istek
İstek
curl -X POST "https://zilko.co/api/v1/appointments" \
  -H "Authorization: Bearer zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": {
      "name": "Elif Şahin",
      "phone": "+90 532 000 00 00"
    },
    "startsAt": "2026-10-30T11:00:00.000Z",
    "durationMin": 30,
    "notes": "İlk muayene"
  }'
Örnek yanıt · 201
{
  "id": "clx8f2k1a0001",
  "contactId": "clx8f2k1a0001",
  "contact": {
    "id": "clx8f2k1a0001",
    "name": "Elif Şahin",
    "phone": "+90 532 000 00 00"
  },
  "staffId": "stf_3k9d",
  "startsAt": "2026-10-30T11:00:00.000Z",
  "endsAt": "2026-10-30T11:30:00.000Z",
  "status": "PENDING",
  "kind": "CONSULTATION",
  "source": "INSTAGRAM",
  "partySize": 2,
  "notes": "İlk muayene",
  "createdAt": "2026-10-28T09:15:00.000Z"
}
GET/appointments/{id}

Randevu

Parametreler

  • idstringzorunluyol

    Randevu kimliği

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/appointments/clx8f2k1a0007" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "id": "clx8f2k1a0001",
  "contactId": "clx8f2k1a0001",
  "contact": {
    "id": "clx8f2k1a0001",
    "name": "Elif Şahin",
    "phone": "+90 532 000 00 00"
  },
  "staffId": "stf_3k9d",
  "startsAt": "2026-10-30T11:00:00.000Z",
  "endsAt": "2026-10-30T11:30:00.000Z",
  "status": "PENDING",
  "kind": "CONSULTATION",
  "source": "INSTAGRAM",
  "partySize": 2,
  "notes": "İlk muayene",
  "createdAt": "2026-10-28T09:15:00.000Z"
}
PATCH/appointments/{id}“write” kapsamı gerekir

Randevuyu güncelle, onayla ya da iptal et

Parametreler

  • idstringzorunluyol

    Randevu kimliği

İstek gövdesi · AppointmentUpdate

  • startsAtstring (date-time)
  • durationMininteger

    5–480

  • endsAtstring (date-time)
  • statusstring

    CONFIRMED, CANCELLED, COMPLETED, NO_SHOW

  • staffIdstring | null
  • partySizeinteger

    1–500

  • notesstring | null

    en çok 2000 karakter

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 409Saat dolu ya da kayıt durumu uygun değil
  • 429Anahtar başına dakikada 120 istek
İstek
curl -X PATCH "https://zilko.co/api/v1/appointments/clx8f2k1a0007" \
  -H "Authorization: Bearer zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "CONFIRMED"
  }'
Örnek yanıt · 200
{
  "id": "clx8f2k1a0001",
  "contactId": "clx8f2k1a0001",
  "contact": {
    "id": "clx8f2k1a0001",
    "name": "Elif Şahin",
    "phone": "+90 532 000 00 00"
  },
  "staffId": "stf_3k9d",
  "startsAt": "2026-10-30T11:00:00.000Z",
  "endsAt": "2026-10-30T11:30:00.000Z",
  "status": "PENDING",
  "kind": "CONSULTATION",
  "source": "INSTAGRAM",
  "partySize": 2,
  "notes": "İlk muayene",
  "createdAt": "2026-10-28T09:15:00.000Z"
}
GET/availability

Boş saatler

Parametreler

  • datestring (date)sorgu

    İlk gün (işletmenin saat dilimi). Varsayılan: bugün.

  • daysintegersorgu

    1–14 · varsayılan 7

  • staffIdstringsorgu

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/availability" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "timezone": "Europe/Istanbul",
  "slots": [
    {
      "startsAt": "2026-10-30T11:00:00.000Z",
      "endsAt": "2026-10-30T11:30:00.000Z",
      "staffId": "stf_3k9d"
    }
  ]
}
GET/staff

Ekip (hekim, uzman, personel)

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/staff" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "items": [
    {
      "id": "clx8f2k1a0001",
      "name": "Elif Şahin",
      "title": "Dr.",
      "specialty": "Implant",
      "active": true
    }
  ]
}

Konuşmalar

Instagram, WhatsApp ve Messenger konuşmaları (salt okunur).

GET/conversations

Konuşmaları listele (son mesaja göre)

Parametreler

  • channelChannelsorgu

    INSTAGRAM, WHATSAPP, MESSENGER

  • contactIdstringsorgu
  • cursorstringsorgu

    Önceki yanıttaki nextCursor.

  • limitintegersorgu

    1–100 · varsayılan 50

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/conversations?limit=20" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "items": [
    {
      "id": "clx8f2k1a0001",
      "channel": "INSTAGRAM",
      "contact": {
        "id": "clx8f2k1a0001",
        "name": "Elif Şahin"
      },
      "aiEnabled": true,
      "unread": 1,
      "lastMessageAt": "2026-10-28T09:15:00.000Z",
      "preview": "Perşembe 14:00 uygun mu?"
    }
  ],
  "nextCursor": "clx8f2k1a0042"
}
GET/conversations/{id}/messages

Konuşmanın mesajları (yeniden eskiye)

Parametreler

  • idstringzorunluyol

    Konuşma kimliği

  • cursorstringsorgu

    Önceki yanıttaki nextCursor.

  • limitintegersorgu

    1–100 · varsayılan 50

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/conversations/cnv_7h2m/messages?limit=20" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "items": [
    {
      "id": "clx8f2k1a0001",
      "direction": "IN",
      "author": "PATIENT",
      "text": "Merhaba, implant için bilgi almak istiyorum.",
      "createdAt": "2026-10-28T09:15:00.000Z"
    }
  ],
  "nextCursor": "clx8f2k1a0042"
}

Çağrılar

Sesli asistan çağrıları, özet ve döküm (salt okunur).

GET/calls

Çağrıları listele

Parametreler

  • fromstring (date-time)sorgu
  • tostring (date-time)sorgu
  • contactIdstringsorgu
  • cursorstringsorgu

    Önceki yanıttaki nextCursor.

  • limitintegersorgu

    1–100 · varsayılan 50

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/calls?limit=20" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "items": [
    {
      "id": "clx8f2k1a0001",
      "contactId": "clx8f2k1a0001",
      "direction": "INBOUND",
      "channel": "PHONE",
      "outcome": "ANSWERED",
      "startedAt": "2026-10-30T11:00:00.000Z",
      "durationSec": 192,
      "summary": "Implant fiyatını sordu; perşembe 14:00 için randevu verildi."
    }
  ],
  "nextCursor": "clx8f2k1a0042"
}
GET/calls/{id}

Çağrı (özet ve döküm)

Parametreler

  • idstringzorunluyol

    Çağrı kimliği

Yanıtlar

  • 200Başarılı
  • 400Geçersiz istek
  • 401Anahtar yok, geçersiz ya da iptal edildi
  • 403Anahtarın kapsamı yetmiyor (yazma için "write")
  • 404Kayıt bulunamadı
  • 429Anahtar başına dakikada 120 istek
İstek
curl "https://zilko.co/api/v1/calls/cll_5p1q" \
  -H "Authorization: Bearer zk_live_…"
Örnek yanıt · 200
{
  "id": "clx8f2k1a0001",
  "contactId": "clx8f2k1a0001",
  "direction": "INBOUND",
  "channel": "PHONE",
  "outcome": "ANSWERED",
  "startedAt": "2026-10-30T11:00:00.000Z",
  "durationSec": 192,
  "summary": "Implant fiyatını sordu; perşembe 14:00 için randevu verildi.",
  "transcript": [
    {
      "role": "zilko",
      "text": "Merhaba, implant için bilgi almak istiyorum.",
      "t": 4.2
    }
  ]
}
WhatsApp’tan yazınGeliştirici API’si · ZILKO