Çağrı Kayıtlarına Detaylı Bir Bakış

Bu makalede API ve Webkancalarından gelen çağrı ile ilgili kayıtların anlamları ve nelere dikkat edilmesi gerektiğini anlatacağız.

Bu yazıda, Hipcall API ve webkancaları (webhook) aracılığıyla erişebileceğiniz çağrı kayıtlarını inceleyeceğiz. API ve webkancaları ile çağrılar hakkında pek çok ayrıntılı bilgiye ulaşabilirsiniz. Bu bilgileri daha anlaşılır hale getirmek için kategorilere ayırarak sizlere sunacağız.

Çağrıların Benzersiz Kimlik Bilgisi

  • Çağrılar, benzersiz kimlik bilgisi olan uuid alanından alınabilir.

Çağrı Ayrıntıları

Çağrının yönü ve tarafları ile ilgili bilgiler için aşağıdaki veriler kullanılabilir:

1. Çağrı Yönü

  • direction: Çağrının kullanıcılarınıza göre yönünü belirtir. Olası değerler:
    • outbound: Kullanıcılarınızın başlattığı çağrılar.
    • inbound: Size doğru yapılan çağrılar.
    • internal: Sistemin içinde kullanıcıların birbirleriyle yaptığı görüşmelerdir.
  • number_id: Çağrının ilişkili telefon numarasının kayıt numarasıdır.

2. Çağrıyı Başlatan

  • caller_number: E.164 formatında çağrıyı başlatan numaradır.
  • caller_type: Çağrıyı başlatan tarafın türüdür:
    • Outbound çağrılarda: user.
    • Inbound çağrılarda: contact.
    • Not: Hipcall’in ileriki sürümlerinde yeni tipler eklenebilir.
  • caller_id: Çağrıyı başlatan tipin sistemdeki kayıt numarasıdır.
    • Örnek: Outbound bir çağrıda caller_type = user ise bu caller_id, çağrıyı başlatan kullanıcının ID'sidir.

3. Çağrılan Taraf

  • callee_number: E.164 formatında çağrının aranan numarasını belirtir.
  • callee_type: Aranan uc birimin tipini ifade eder. Olası değerler:
    • contact: Rehberde kayıtlı bir kişi ya da herhangi bir E.164 numarası.
    • user: Hipcall kullanıcıları (ekip arkadaşlarınız).
    • greeting: IVR yani karşılama menüsü.
    • team: Ekipler (kuyruk).
    • voicemail: Sesli mesaj.
    • smart_ivr: Akıllı yönlendirme.
    • speed_dial: Hızlı arama.
    • external_manager: Harici yönetim.
    • hangup: Çağrı sonlandırma.
  • Not:
    • contact ve hangup tipi çağrılarda callee_id boş olabilir. Bu durum sistemde kayda gerek duyulmadığı için oluşur.
    • hangup genel bir aksiyonu ifade eder; contact ise rehbere henüz kayıtlı olmayan kişileri temsil eder.
  • callee_id: Yukarıdaki türlerden ilgili birimin sistemdeki kayıt numarasıdır.

4. Kullanıcıya Dair Bilgiler

  • user_id: Çağrıyı yanıtlayan veya son konuşmayı gerçekleştiren kullanıcınızın kayıt numarasıdır. Özellikle ekipler üzerinden gelen çağrılarda, bu alan çağrıyı hangi kullanıcınızın karşıladığını belirtir.
  • channel_type: Şimdilik yalnızca number olarak gelir. Çağrının size ait bir numaradan başlatıldığını belirtir. Hipcall ileride farklı kanallardan çağrı almaya başladığında bu alana yeni tipler eklenecektir.

Rehber Bilgisi

İlişkili rehber bilgisi şu iki veri ile alınabilir:

  • related_type: company ya da contact olarak gelir.
    • company: Firma.
    • contact: Kişi.
  • related_id: Yukarıdaki tiplerden ilgili birey veya kurumun kayıt numarasıdır.

Ses Kaydı Bilgisi

  • record_url: Geçici bir URL döner. Bu URL:
    • İstek yapıldıktan sonraki 4 saat içinde kullanılmalıdır.
    • Uzun süreli saklanacaksa, URL’nin kullanım süresinin dolacağı unutulmamalı ve ses kaydı sistemde saklanmalıdır.
    • Alternatif olarak, her ihtiyaç duyulduğunda yeni bir URL talep edilmelidir.

Geri Arama Bilgileri

Eğer bir çağrı kaçan çağrı statüsündeyse, bu çağrıya yapılan geri dönüşün detayları aşağıdaki alanlarda yer almaktadır. Ancak, Webhook'lar çağrı bitiminde alındığı için bu alanlar pratikte genellikle boş gelecektir. Bununla birlikte, API üzerinden erişim sağlandığında, çağrı sonrasında oluşmuş geri dönüş bilgilerine ulaşabilirsiniz.

  • callback_user_id: Çağrıya dönüş yapan kullanıcının kayıt numarasıdır.
  • callback_time: Çağrıya kaç saniye sonra dönüldüğünü belirtir. Integer olarak saniye farkını ifade eder.
  • callback_cdr_uuid: Geri dönüş için yapılan ilgili çağrının benzersiz UUID bilgisidir.

İstatistik Alanları

  • started_at: ISO 8601 formatında çağrının başlangıç zamanıdır.
  • bridged_at: ISO 8601 formatında çağrının bir kullanıcıya bağlandığı zamandır.
  • answered_at: ISO 8601 formatında çağrının cevaplandığı zamandır.
    • Not: bridged_at ile farklı olabilir. Çünkü çağrı IVR veya ekip uç birimi tarafından da cevaplanmış olabilir.
  • ended_at: ISO 8601 formatında çağrının bitiş zamanıdır.

Kaçan Çağrılar ve Nedenleri

  • missing_call: Eğer çağrı kullanıcılarınızdan biriyle konuşma gerçekleştiremezse bu alan true olarak gelir. Bu alan kaçan çağrıları tespit etmek için kullanılabilir.
  • missing_call_reason: Kaçan çağrıların nedeni sistem tarafından belirtilir:
    • out_of_business_hours: Mesai saatleri dışında gelen çağrı.
    • short_abandoned: Kısa süreli aramalar. Sisteminizdeki hesap ayarlarından bu süreyi tanımlayabilirsiniz (Varsayılan: 3 saniye).
    • abandoned: Arayan tarafından terk edilen çağrı.
    • callback: Kuyrukta bekleyen kişinin geri aranma talebiyle ilettiği çağrı.
    • denylist: Engelli listesine takılan çağrı.

Çağrı Süreleri

  • first_touch_duration: Çağrının bir kullanıcıyla konuşma başlamadan önce sistemde ne kadar beklediğini belirtir. Çağrı merkezinizin arayanları bir personel ile görüştürme hızını analiz etmek için kullanılabilir.
  • call_duration: Çağrının toplam süresidir.

Sonlandırma Bilgisi

  • hangup_by: Çağrının kim tarafından sonlandırıldığını belirtir:
    • Olası değerler: user, contact, system.

Sesli Mesaj Bilgileri

Eğer çağrı bir sesli mesaj ile sonlandırılmışsa şu alanlar dönecektir:

  • voicemail_url: Ses dosyasının geçici URL bilgisi.
  • voicemail_id: Sesli mesaj kutusunun kayıt numarası.
  • voicemail_type: Mesaj kutusunun tipi:
    • Olası değerler: user ya da account.