Custom Webhook (Özel Webhook) Aksiyonu

Purvisor’da hazır butonu olmayan bir sisteme bağlanman mı gerekiyor? Custom Webhook tam bunun için. Asistanın, bir görüşme sırasında ya da görüşme biter bitmez, senin belirlediğin bir URL’ye HTTP isteği atar: kendi CRM’ine kayıt düşürür, Slack’e bildirim yollar, bir Google Sheet’i günceller ya da n8n/Make/Zapier’daki bir akışı tetikler. Kısacası bu aksiyon, panelde hazır entegrasyonu olmayan her sistemi bağlamanın kaçış kapısıdır — kod yazmadan, sadece bir URL ve bir payload şablonu tanımlayarak.

Bunu bir “otomatik kurye” gibi düşün: görüşme bitince asistanın topladığı bilgileri (ad, telefon, özet, duygu) bir paket haline getirir ve senin verdiğin adrese teslim eder.

Nasıl çalışır?

Görüşme başlar / biter
        ↓
Asistana bağlı "custom" aksiyonu tetiklenir
        ↓
payloadTemplate + {{değişkenler}} → JSON yük hazırlanır
        ↓
Senin webhookUrl'ine HTTP isteği gönderilir (POST/GET/...)
        ↓  (başarısızsa retryCount kadar tekrar)
Senin sistemin isteği alır → kendi otomasyonun çalışır

Ne zaman tetiklenir?

Custom Webhook iki ayrı anda çalışabilir. Hangi alanların uygulandığı bu ana göre değişir — bu ayrımı bilmek önemli.

Kurulum

Payload (gönderilen yük)

Görüşme sırasında — sabit yük

Asistan görüşme ortasında webhook’u tetiklediğinde gövde sabittir ve şu şekildedir:

{
  "callId": "call_abc123",
  "phoneNumber": "+905551112233",
  "params": { "urun": "ısı pompası" },
  "timestamp": "2026-07-13T10:24:00.000Z",
  "source": "purvisor-ai-incall"
}

params, asistanın o an tool çağrısında geçirdiği serbest alandır.

Görüşme sonrası — kendi şablonun

Post-call yürütmede yükü sen tanımlarsın. payloadTemplate alanına yazdığın JSON, gönderilmeden önce {{değişken}} etiketleri gerçek değerlerle doldurulur. Örnek şablon:

{
  "ad": "{{full_name}}",
  "telefon": "{{phone_number}}",
  "eposta": "{{email}}",
  "ozet": "{{call_summary}}",
  "duygu": "{{call_sentiment}}",
  "randevu_tarihi": "{{booking_date}}",
  "call_id": "{{call_id}}"
}

Şablonda kullanabileceğin değişkenler:

Karşılığı olmayan bir değişken boş metinle değiştirilir — yani şablon yine geçerli JSON olarak gider.

Kendi başlıklarınla kimlik doğrulama örneği (headers alanına):

{ "Authorization": "Bearer SENIN_TOKENIN", "X-Kaynak": "purvisor" }

Yeniden deneme ve timeout

Görüşme sonrası istekte, yanıt 2xx değilse ya da istek timeoutMs süresini aşarsa, Purvisor retryCount kadar tekrar dener. Denemeler arasında artan bir bekleme uygulanır (yaklaşık 1 sn, 2 sn, 3 sn…). Tüm denemeler tükenirse aksiyon başarısız işaretlenir; görüşmenin kendisi bundan etkilenmez.

REST-hook aboneliğinden farkı

Purvisor’da isim olarak benzeyen ama tamamen farklı iki mekanizma var. Karıştırmamak önemli:

Kısaca: bir görüşmeye tepki vermek istiyorsan Custom Webhook; hesap genelinde olan biteni dışarı akıtmak istiyorsan REST-hook aboneliği kullan. İkisi birbirinin alternatifi değil, tamamlayıcısıdır.

İyi uygulamalar

• HTTPS kullan. Kişisel veri (telefon, transkript, özet) taşıdığın için hedef URL mutlaka https olsun.
• Auth ekle. Uç noktan halka açıksa headers alanına bir Authorization token koy; sahte istekleri engelle.
• Timeout’u gerçekçi tut. Uç noktan yavaşsa varsayılan 10 saniye yetmeyebilir; ama çok uzun timeout, başarısız çağrıda tüm zinciri bekletir.
• Yeniden denemeyi ölçülü aç. retryCount değerini 1-2 ile sınırla; idempotent olmayan bir uç noktada yüksek retry mükerrer kayıt üretir.
• Zengin veri istiyorsan post-call’u tercih et. {{call_summary}}, {{call_sentiment}}, {{transcript}} yalnızca görüşme sonrası şablonda dolar.

Sorun giderme

İlgili