Hipcall harici yönetim (external management) nedir ve nasıl kullanılır?

Bu makalemizde Hipcall External Management sisteminden bahsedeceğiz.

Bu özellik şuan yapım aşamasındadır. Lütfen geribildirimlerinizi https://community.hipcall.com/c/turkce/gelistiriciler/12 üzerinden mühendislik ekibimiz ile paylaşın.

External manager için kurulması

  • JSON'u alacağımız webservisin URL'i
  • Webservisinizin varsa Basic Auth kullanıcı adı ve parolası

Nasıl çalışır?

Harici yönetim modulüne çağrı ilk düştüğünde sizin verdiğiniz webservisine Hipcall bir JSON POST eder.

{
    "caller": "908508850000",
    "data": {},
    "timestamp": 1728464434,
    "uuid": "170f8657-4fe6-42d8-b781-15438919f545",
    "direction": "inbound",
    "external_manager_id": 1,
    "callee": "902582440149"
}

Sonra bu isteğin (requestion) cevabı olarak aşağıda belirtiğimiz standartlarda bir JSON bekler. JSON'daki komutları sırasıyla uygular.

Örnek bir payload

{
    "version": "1",
    "seq": [
        {
            "action": "play",
            "args": {
                "url": "http://hcxm.demo.hipcall.com/demosesler/demo-welcome.mp3"
            }
        },
        {
            "action": "connect",
            "args": {
                "destination": "1000"
            }
        },
        {
            "action": "dial",
            "args": {
                "destination": "905326202911"
            }
        },
        {
            "action": "gather",
            "args": {
                "min_digits": 1,
                "max_digits": 2,
                "ask": "http://example.com/demo/covid/positive.mp3",
                "variable_name": "variable_name"
            }
        },
        {
            "action": "hangup"
        }
    ]
}

External managementta olan özellikler

  • dial: Çağrıyı harici bir numaraya yönlendirir.
  • connect: Çağrıyı bir iç hatta yönlendirir. Karşılama anonsu, Akıllı yönlendirme, Ekip (Kuyruk) vb dahili numarası olan tüm servisler iç hat olarak geçmektedir.
  • play: Verilen bir mp3 dosyasını okur.
  • gather: Basılan tuşlamaları alıp, sizin belirleyeceğiniz bir değişken ile sizlerle paylaşır.
  • hangup: Görüşmeyi sonlandırır.