Bilgilendirme Kartında Arayan Adı, Şirket ve Bakiye Göster

Genel Bakış

Bir temsilci çağrıyı yanıtladığında her saniye önemlidir. Kimin aradığını öğrenmek için CRM’de arama yapmak yerine, temsilci merhaba demeden önce arayanın adını, şirketini ve hesap bakiyesini otomatik olarak görmelidir.

Bu rehber, bir çağrı bağlandığı anda temsilci ekranında gerçek zamanlı arayan verilerini görüntülemek için Webkancaları ve Bilgilendirme Kartı API’sini nasıl birleştireceğinizi gösterir.

Nasıl Çalışır

Entegrasyon iki Hipcall geliştirici aracını kullanır:

1. Webkancaları — Bir çağrı başladığında Hipcall, sunucunuza bir call_init olayı gönderir.
2. Bilgilendirme Kartı API — Sunucunuz arayanı sorgular ve Hipcall’a bir kart göndererek bunu temsilcinin ekranında gösterir.

Mimari

flowchart TD
    A[Gelen çağrı] --> B[Hipcall call_init webkancasını gönderir]
    B --> C[Sunucunuz olayı alır]
    C --> D{CRM/ERP'de\neşleşme bulundu mu?}
    D -- Evet --> E[Bilgilendirme Kartı API'sine POST gönder]
    D -- Hayır --> F[Atla]
    E --> G[Temsilci ekranda arayan bilgisini görür]

Adım 1: Webkancayı Alın

Hesap > Entegrasyonlar > Webkancaları bölümünden call_init olayına abone olun. Hipcall, her çağrı başladığında — hem gelen hem giden — uç noktanıza bir JSON yükü POST edecektir.

Örnek webkanca yükü:

{
  "event": "call_init",
  "data": {
    "uuid": "call_abc123",
    "direction": "inbound",
    "caller_number": "+442045205757",
    "callee_number": "+441234567890",
    "callee_extension_id": 1042
  }
}

data.uuid (çağrı kimliği) ve müşterinin telefon numarasını çıkarın:

• Gelen çağrı → müşteri data.caller_number’dır
• Giden çağrı → müşteri data.callee_number’dır

Adım 2: CRM veya ERP’nizde Arayan Verisini Sorgulayın

Müşterinin telefon numarasını kullanarak veri kaynağınızı — bir veritabanı, CRM API’si veya ERP sistemi — sorgulayın.

CRM’inizden örnek yanıt:

{
  "full_name": "Jane Smith",
  "company": "Acme Corp",
  "balance": "4250.00"
}

Eşleşme bulunamazsa Bilgilendirme Kartı çağrısını tamamen atlayabilir veya minimal bir yedek kart gönderebilirsiniz.

Adım 3: Kartı Bilgilendirme Kartı API’sine Gönderin

Kartı doğru çağrıyla ilişkilendirmek için webkancadan gelen call_id ile Bilgilendirme Kartı API’sini çağırın.

Uç nokta:

POST /api/v3/calls/{call_id}/cards
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

İstek gövdesi:

{
  "card": [
    {
      "type": "title",
      "text": "Hipcall Insight",
      "link": "https://www.hipcall.com"
    },
    {
      "type": "shortText",
      "label": "Ad",
      "text": "Jane Smith"
    },
    {
      "type": "shortText",
      "label": "Şirket",
      "text": "Acme Corp"
    },
    {
      "type": "shortText",
      "label": "Bakiye",
      "text": "$4,250.00"
    }
  ]
}

Kart, çağrı başladıktan milisaniyeler içinde temsilcinin Webphone’unda görünür.

Kullanılan Araçlar

Araç	Amaç
Webkancaları	Bir çağrı başladığında call_init olayını alır
Bilgilendirme Kartı API	Arayan veri kartını temsilcinin ekranına gönderir

Sonraki Adımlar

• Webkancaları dokümantasyonu — Olaylara abone olun, yeniden deneme mantığını yapılandırın, imzaları doğrulayın
• Bilgilendirme Kartı API referansı — Kart türlerinin, biçimlendirme seçeneklerinin ve sınırların tam listesi
• REST API kimlik doğrulaması — Sunucunuz için API anahtarları veya OAuth 2.0 ayarlayın