Geliştirici Dokümantasyonu

Telefoni REST API & Gerçek Zamanlı Webhook'lar

SanalPBX güçlü REST API uçları ve Webhook altyapısı sayesinde CRM, ERP veya kendi şirket içi yazılımlarınıza kolayca entegre olur.

1. Kimlik Doğrulama (API Key Authentication)

Tüm isteklerinizde Authorization: Bearer <API_KEY> başlığı gönderilmelidir.

POST /api/v1/telephony/originate (Click-to-Call Başlatma)

{
  "extension": "1001",
  "destination": "+905321112233",
  "caller_id": "+908508500321",
  "timeout": 30
}

2. Webhook Bildirimleri (Call Events)

Santralinizde çağrı başladığında (call.initiated), cevaplandığında (call.answered) veya ses kaydı hazır olduğunda (recording.ready) sunucunuza anlık JSON HTTP POST iletilir.

Webhook Payload: recording.ready

{
  "event": "recording.ready",
  "call_uuid": "8f41c2a0-95e4-40ac-b272-33e554cb4a00",
  "caller": "+905321112233",
  "extension": "1001",
  "duration": 165,
  "recording_url": "https://storage.sanalpbx.com/records/2026/08/rec_8f41.mp3"
}