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

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": "+908508852972",
    "data": {},
    "timestamp": 1729721495,
    "uuid": "8bcfdf1d-d7b9-434d-9207-d33a8e73ac47",
    "direction": "inbound",
    "external_manager_id": 2,
    "callee": "908508851980",
    "callflow": [
        {
            "timestamp": 1729721495,
            "action": "init",
            "detail": {
                "id": 2,
                "type": "external_manager"
            }
        }
    ]
}

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.