Telvoi'yi Kendi
Sistemlerinize Entegre Edin

REST API ve Webhook desteğiyle çağrı verilerinizi CRM'inize, e-ticaret platformunuza veya özel yazılımınıza bağlayın.

API Referans

Tüm istekler https://api.telvoi.com/v1 base URL'i üzerinden yapılır. Bearer token ile kimlik doğrulama.

Kullanıcı Listele

# GET /users — Tüm kullanıcıları listele
curl -X GET \
  https://api.telvoi.com/v1/users \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json"

# Başarılı yanıt (200 OK)
{
  "data": [
    {
      "id": "usr_abc123",
      "name": "Ahmet Kaya",
      "extension": 101,
      "status": "online"
    }
  ],
  "total": 8
}

Kullanıcı Ekle

# POST /users — Yeni kullanıcı oluştur
curl -X POST \
  https://api.telvoi.com/v1/users \
  -H "Authorization: Bearer {API_KEY}" \
  -d '{
    "name": "Zeynep Demir",
    "email": "zeynep@sirket.com",
    "extension": 105,
    "plan": "growing"
  }'

# Başarılı yanıt (201 Created)
{
  "id": "usr_xyz789",
  "status": "created",
  "credentials_sent": true
}

CDR Logları Çek

# GET /cdr — Çağrı detay kayıtları
curl -X GET \
  "https://api.telvoi.com/v1/cdr?from=2026-05-01&to=2026-05-19" \
  -H "Authorization: Bearer {API_KEY}"

# Yanıt örneği
{
  "calls": [
    {
      "call_id": "cdr_111",
      "direction": "inbound",
      "from": "+905321110000",
      "to": "+902120000000",
      "duration": 185,
      "status": "answered",
      "recording_url": "https://..."
    }
  ]
}

Webhook Yapılandır

# POST /webhooks — Webhook endpoint kaydet
curl -X POST \
  https://api.telvoi.com/v1/webhooks \
  -H "Authorization: Bearer {API_KEY}" \
  -d '{
    "url": "https://sizin-sunucunuz.com/hook",
    "events": [
      "call.started",
      "call.answered",
      "call.ended",
      "call.missed"
    ]
  }'

# Telvoi bu URL'e POST atar:
{
  "event": "call.started",
  "call_id": "cdr_222",
  "from": "+905001234567",
  "timestamp": "2026-05-19T13:45:00Z"
}

Desteklenen Olaylar

Event Açıklama Kullanım Örneği
call.started Çağrı başladığında tetiklenir CRM popup, müşteri kaydını aç
call.answered Çağrı karşılandığında tetiklenir Ticket oluştur, süre başlat
call.ended Çağrı bittiğinde tetiklenir CDR kaydet, CRM'e not ekle
call.missed Cevapsız çağrıda tetiklenir Slack/e-posta bildirimi gönder
user.status Kullanıcı durumu değiştiğinde tetiklenir Dashboard güncelle, vardiya takibi

Hızlı Başlangıç

Node.js / JavaScript

npm paketi ile dakikalar içinde entegrasyon. TypeScript desteği dahil.

npm install @telvoi/sdk

Python

PyPI paketi. Django, FastAPI veya Flask projenize hızlıca ekleyin.

pip install telvoi

REST (Herhangi bir dil)

Standart HTTP REST API. Postman koleksiyonumuzu indirin ve hemen test edin.

Postman Koleksiyonu İndir

Entegrasyon Desteği mi Gerekli?

Teknik ekibimiz entegrasyon sürecinizde size eşlik eder.