Webphone için bilgilendirme kartı nasıl ayarlanır?

Başlamadan önce aşağıdaki adımları kontrol ediyoruz.

1. Paketimizde API ve Webkancası özelliklerinin bulunduğuna emin oluyoruz.
2. Hipcall Google Chrome Eklentisi'nin tarayıcımızda kurulduğuna emin oluyoruz.

Webkancasından telefon numarası ve çağrının UUID'sinin alınması

İlk önce çağrı başladığında çağrının UUID'sini alabilmek için webkancasını ayarlıyoruz. Bunun için Webkancaları nelerdir ve nasıl ayarlanır? makelemizi okuyabilirsiniz.

Her çağrı başladığında sizlere aşağıdaki gibi bir JSON verisi HTTPS protokolüyle POST ediliyor.

{
    "data": {
        "hangup_by": null,
        "call_flow": [
            {
                "action": "init",
                "detail": {
                    "id": null,
                    "type": "contact"
                },
                "timestamp": 1731840060
            }
        ],
        "callee_type": "contact",
        "number_id": 328,
        "first_touch_duration": null,
        "channel_id": 328,
        "answered_at": null,
        "voicemail_type": null,
        "caller_id": null,
        "call_duration": null,
        "callback_cdr_uuid": null,
        "missing_call": null,
        "related_id": null,
        "callee_number": "905438856301",
        "uuid": "2483a75a-56a2-41f1-991b-92b1667e324a",
        "callback_time": null,
        "related_type": null,
        "ended_at": null,
        "caller_type": null,
        "credited": null,
        "channel_type": "number",
        "voicemail_url": null,
        "callee_id": null,
        "user_id": null,
        "missing_call_reason": null,
        "started_at": "2024-11-17T10:41:00Z",
        "bridged_at": null,
        "voicemail_id": null,
        "contact_id": null,
        "callback_user_id": null,
        "direction": "outbound",
        "caller_number": "+902582440032",
        "record_url": null
    },
    "event": "call_init"
}

Burada çağrının UUID'sini ve müşterinin numarasını alabilirsiniz. Bu çağrı için

• UUID: "2483a75a-56a2-41f1-991b-92b1667e324a"
• Müşteri numarası: callee_number alanındaki 905438856301'dir.

Müşteri numarasıda dikkat edilecek önemli bir konu vardır. Eğer çağrının yönü (direction) outbound ise müşteri numarası callee_number alanındayken çağrının yönü (direction) inbound ise müşteri numarası caller_number alanındadır. İstenirse daha detaylı bilgiye Çağrı Kayıtlarına Detaylı Bir Bakış makalemizden erişebilirsiniz.

Müşteri numarasına göre kart bilgisini oluşturma

Müşteri numarasına göre kendi veritabanınızdan veya CRM sisteminizden iOS, Android veya webphone'da kart olarak gösterilecek bilgileri aşağıdaki gibi oluşturmanız gerekiyor.

{
  "card": [
    {
      "link": "https://my-crm.com",
      "text": "My CRM",
      "type": "title"
    },
    {
      "label": "Ad soyad",
      "link": "https://my-crm.com/contact/1234",
      "android": "yourapp://contact/id=1234",
      "ios": "yourapp://company/id=1234",
      "text": "Onur Ozgur OZKAN",
      "type": "shortText"
    },
    {
      "label": "Firma",
      "link": "https://my-crm.com/company/1234",
      "android": "yourapp://company/id=1234",
      "ios": "yourapp://company/id=1234",
      "text": "Acme Inc.",
      "type": "shortText"
    },
    {
      "label": "Tipi",
      "text": "Eski müşteri",
      "type": "shortText"
    },
  ]
}

Yukarıdaki JSON'ı incelersek webphoneda 1 başlık ve 3 tane label => value olduğunu göreceksiniz. Eğer iOS veya Android uygulamanız varsa aynı şekilde Hipcall Mobil uygulamasından onlarıda açtırabilirsiniz. Bunun için ios ve android kısımlarını kullanabilirsiniz.

My CRM

• Ad soyad: Onur Ozgur OZKAN
• Firma: Acme Inc.
• Tipi: Eski müşteri

Bu verilerden Ad soyad ve Firma bir URL aldığından tıklandığında yeni sekmede verilen URL'yi açacaktır. Tipi alanında böyle bir durum yoktur.

Dikkat edilmesi gerekenler

• Webphone'un alanı dar ve küçük olduğundan en fazla 3-4 alan gönderilmesi
• Telefon numarasının standartı E164 şeklindedir. Sizlere numalara 532620xxxx veya 0532620xxxx şeklinde değil 90532620xxxx şeklinde gelecektir.

API ile kart bilgilendirmesini webphone'a gönderme

Bu işlem için Hipcall API'deki POST => /api/v3/calls/{call_id}/cards alanını kullanıyoruz. İsterseniz API dokümanından canlı olarak test edebilirsiniz.

CALL_ID'ye Webkancasından gelen çağrının UUID'sini, BODY'e de bir önceki aşamada oluşturduğunuz JSON'ı göndermeniz gerekmektedir.

Sorularınız

Sorularınızı bizlere Geliştirici Topluluğu formumuz üzerinden sorabilirsiniz.