Sesvia Tool ve Webhook ile Asistanınızı Entegre Edin

Sesvia asistanınız, yalnızca konuşmakla kalmaz; dış sistemlerle de etkileşime geçebilir. Tool’lar sayesinde asistan, görüşme sırasında harici API’leri çağırabilir. Webhook’lar sayesinde ise Sesvia, çağrı sonrasında kendi sisteminize bildirim gönderir.

Tool (Araç)
Webhook

Tool nedir?

Tool, asistanınızın görüşme sırasında tetikleyebildiği bir HTTP işlevidir. Asistan, konuşma bağlamına göre hangi Tool’u ne zaman çağıracağına kendi karar verir. Tool’lar sayesinde asistanınız:

Sipariş veya stok durumunu sorgulayabilir
Randevu veya rezervasyon oluşturabilir
Müşteri bilgilerini CRM’e kaydedebilir

Tool nasıl oluşturulur?

Asistan ayarlarını açın

Sol menüden asistanınızı seçin, ardından Ayarlar → Tool’lar sekmesine gidin.

Yeni Tool ekleyin

Yeni Tool Ekle düğmesine tıklayın.

Tool bilgilerini doldurun

Aşağıdaki alanları doldurun:

Alan	Açıklama
Ad	Tool’un kısa ve tanımlayıcı adı (örn. `siparis_sorgula`)
Açıklama	Asistanın bu Tool’u ne zaman kullanacağını anlayan metin; ne kadar net olursa AI o kadar doğru karar verir
HTTP Yöntemi	`GET` veya `POST`
URL	Çağrılacak endpoint adresi
Başlıklar (Headers)	Kimlik doğrulama gibi sabit HTTP başlıkları (örn. `Authorization: Bearer ...`)
İstek Gövdesi Şeması	POST isteklerinde gönderilecek JSON alanları ve açıklamaları

Kaydedin ve test edin

Kaydet düğmesine tıklayın. Ardından Test Et seçeneğiyle Tool’un doğru yanıt döndürdüğünü doğrulayın.

Örnek kullanım alanları

Stok sorgulama: “Bu ürün var mı?” sorusuna anlık yanıt vermek için envanter API’nizi çağırın.
Randevu oluşturma: Görüşme sırasında müşterinin seçtiği tarih ve saatte rezervasyon kaydedin.
Lead kaydetme: Müşteriden alınan ad, telefon ve ilgi alanı bilgilerini CRM’inize iletin.

Webhook nedir?

Webhook, belirli bir çağrı olayı gerçekleştiğinde Sesvia’nın sizin belirlediğiniz URL’ye otomatik olarak gönderdiği bir HTTP POST isteğidir. Webhook’lar sayesinde:

Görüşme bittiğinde kendi sisteminizi anında haberdar edebilirsiniz
Transkript ve çağrı verilerini kendi veritabanınıza aktarabilirsiniz
CRM, bildirim veya otomasyon akışlarını tetikleyebilirsiniz

Webhook nasıl yapılandırılır?

Webhook ayarlarını açın

Sol menüden Ayarlar → Webhook’lar bölümüne gidin.

Endpoint URL'nizi girin

Sesvia’nın istek göndereceği HTTPS endpoint adresinizi Endpoint URL alanına yazın.

Olayları seçin

Abone olmak istediğiniz olayları işaretleyin. Örneğin:

call.ended — Çağrı sona erdiğinde
lead.captured — Müşteri verisi toplandığında

Kaydedin

Kaydet düğmesine tıklayın. Sesvia, seçtiğiniz olaylar gerçekleştiğinde endpoint’inize istek göndermeye başlar.

Webhook payload örneği

Sesvia’nın gönderdiği JSON yapısı aşağıdaki gibidir:

{
  "event": "call.ended",
  "call_id": "abc123",
  "phone_number": "+905551234567",
  "duration_seconds": 142,
  "transcript": "...",
  "timestamp": "2024-01-15T10:30:00Z"
}

Güvenlik

Webhook isteklerinin gerçekten Sesvia’dan geldiğini doğrulamak için paylaşımlı gizli anahtar (shared secret) kullanın. Sesvia, her istekle birlikte yapılandırdığınız gizli anahtarı özel bir HTTP başlığında gönderir. Endpoint’inizde bu başlığı kontrol ederek yetkisiz istekleri reddedebilirsiniz.

Başlangıç

Kurulum

Entegrasyonlar

Kullanım Alanları

Destek

Sesvia Tool ve Webhook ile Asistanınızı Entegre Edin

Tool nedir?

Tool nasıl oluşturulur?

Örnek kullanım alanları

Webhook nedir?

Webhook nasıl yapılandırılır?

Webhook payload örneği

Güvenlik

Başlangıç

Kurulum

Entegrasyonlar

Kullanım Alanları

Destek

​Tool nedir?

​Tool nasıl oluşturulur?

​Örnek kullanım alanları

​Webhook nedir?

​Webhook nasıl yapılandırılır?

​Webhook payload örneği

​Güvenlik

Tool nedir?

Tool nasıl oluşturulur?

Örnek kullanım alanları

Webhook nedir?

Webhook nasıl yapılandırılır?

Webhook payload örneği

Güvenlik