Ana içeriğe geç
İşlemler

Arama verilerini sisteminize gönderin

Her aramadan sonra özeti, transkripti ve toplanan verileri CRM'inize, webhook'unuza veya veritabanınıza gönderin.

API Çağrısı, arama bittiğinde onu kendi sisteminize gönderir — özet, transkript, ruh hali ve ajanın topladığı her şey. CRM'inizde bir lead oluşturmak, bir otomasyon başlatmak veya kendi kayıtlarınızı tutmak için kullanın. Sisteminiz çalışmıyorsa istek yeniden denenir ve hiçbir şey kaybolmaz.

Kurulum​

  1. Eylemi ekleyin

    Ajanı açın → İşlemler → Araç Ekle → Post call → API Çağrısı.

  2. Uç noktanıza yönlendirin
    AlanNe girilmeli
    Adör. CRM lead senkronizasyonu
    KoşulNe zaman gönderileceği, ör. arayan satın almak istiyorsa. Boş: her aramadan sonra
    API Uç Noktası URL’siUç noktanız, ör. https://hooks.example.com/hanc
    HTTP MetoduÇoğu sistem için POST; GET, PUT, PATCH, DELETE de çalışır
    Header'lar, Query Parametreleriİsteğe bağlı, ör. bir API anahtarı
  3. İsteği biçimlendirin (isteğe bağlı)
    • Gövde (JSON) — kendi alanlarınız. Bir arama değişkeni eklemek için {{ yazın, ör. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Yalnızca benim alanlarımı gönder — standart arama verilerini dışarıda bırakır; yalnızca kendi yapısını kabul eden bir sistem için.
  4. Hata durumunda ne olacağına karar verin
    • Hata durumunda yeniden denemeler — uç noktanız 2xx ile yanıt vermediğinde her yeni denemeden önceki bekleme süreleri. Varsayılan: 1 dk, 5 dk, 30 dk, 2 sa, 6 sa, 24 sa, 48 sa.
    • Hata bildirimi — son denemeden sonra (varsayılan), her başarısız denemeden sonra veya hiç e-posta gönderilmez. Alıcı: boşsa hesap sahibi.

Düzenleyicideki Uç noktam ne alacak? tam isteği gösterir.

Uç noktanıza ne gelir​

POST, PUT ve PATCH için bir JSON gövdesi — sizin alanlarınız aramanın alanlarıyla birleştirilir:

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

GET ve DELETE için aynı alanlar, iç içe olanlar (transkript, ruh hali, toplanan veriler) hariç query string'e eklenir.

Her istek X-Hanc-Delivery-Id taşır — bir teslimatın tüm denemelerinde aynıdır, böylece kopyaları atlayabilirsiniz — ve deneme numarasını içeren X-Hanc-Attempt. Her deneme 30 saniye sonra zaman aşımına uğrar. Tüm denemeler CRM → İletişimler altında listelenir; başarısız bir teslimat oradan yeniden gönderilebilir. Ayrıntılar: Webhook'lar ve Teslimat.

Kullanım örnekleri​

  • CRM'inizde bir lead veya bir talep oluşturmak.
  • Arama verileriyle no-code bir otomasyon başlatmak.
  • Kendi arama arşivinizi tutmak.
Bu sayfada