Help Center Mesazhe të thirrjes së të folurit

Mesazhe të thirrjes së të folurit

SpeechCall është një lloj mesazhi i përgjigjes zanore interaktive (IVR) që ju lejon të bëni telefonata zanore të automatizuara me opsionet e menysë dhe ndërveprimet DTMF (me shumë frekuencë me dy ton).

Përmbledhje

SpeechCall u mundëson bizneseve të:

  • Bëni thirrje të automatizuara zanore për klientët
  • Luaj mesazhe audio hyrëse
  • Paraqisni opsionet interaktive të menusë
  • Trajtoni përgjigjet e shtypjes së tastierës DTMF (0-9, *, #)
  • Përcaktoni sjelljen e personalizuar për hyrjet e pavlefshme/kohore
  • Aktivizoni grepa në internet me trupa dhe tituj të personalizuar bazuar në zgjedhjet e përdoruesve
  • Menaxhoni rrjedhën e thirrjeve në mënyrë dinamike (lundroni midis menyve)

Rastet e përdorimit

  • Anketat e Klientëve - Mblidhni komente përmes opsioneve të menysë së telefonit
  • Kujtesat e takimeve - Konfirmo ose riplanifiko me ndërveprimin zanor
  • Ndjekja e porosive - Siguroni përditësime të statusit të porosisë
  • **Njoftimet interaktive ** - Jepni informacione të rëndësishme me opsionet e veprimit
  • Verifikimi zanor - Vërtetimi me shumë faktorë nëpërmjet thirrjeve zanore

Formati i kërkesës

Struktura bazë

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "text": "ivr",
      "type": "speechcall",
      "menu": [
        {
          "introUrl": "ivr_XXXXX",
          "idleTimeoutMsec": 10000,
          "dtmfActions": {
            "d1": [
              {
                "action": "webhook",
                "url": "https://YourWebhookURL/0",
                "body": {
                  "confirm": true
                },
                "headers": {
                  "test-header": "test"
                }
              },
              {
                "action": "hangup"
              }
            ],
            "d2": [
              {
                "action": "webhook",
                "url": "https://YourWebhookURL/1",
                "body": {
                  "confirm": false
                }
              },
              {
                "action": "hangup"
              }
            ],
            "wrong": [
              {
                "action": "gotoMenu",
                "menu": "1"
              }
            ]
          }
        }
      ]
    }
  ]
}

Përshkrimi i parametrit

ParametriLlojiKërkohetPërshkrimi
”nga”vargPoIdentifikuesi i dërguesit (emri alfa ose ID)
përvargPoNumri i telefonit të marrësit në format ndërkombëtar
tekstvargPoVlera e tekstit, zakonisht “ivr” për SpeechCall
’lloj’vargPoDuhet të jetë "telefonatë e folur"
menugrupPoGama e konfigurimeve të menysë për thirrjen

Konfigurimi i menysë

Çdo objekt i menusë përmban:

ParametriLlojiKërkohetPërshkrimi
introUrlvargPoURL ose identifikues i skedarit audio hyrës
idleTimeoutMsecnumër i plotëJoKoha skadon në milisekonda për të pritur për një shtypje tasti (p.sh., 10000). Nëse përdoruesi nuk përgjigjet, veprimet e konfiguruara nën tastin ‘gabim’ do të ekzekutohen
dtmfActionsobjektPoHarta e çelësave të veprimeve DTMF

Veprimet e DTMF

Objekti dtmfActions harton çelësat DTMF ose kushte të veçanta në grupe veprimesh:

Çelësi DTMFPërshkrimi
d0Shtypni 0
d1Shtypni 1
d2Shtypni 2
……
d9Shtypni 9
d*Shtypni *
d#Shtypni #
‘gabim’Aktivizohet kur shtypet një tast i pavlefshëm ose kur arrihet idleTimeoutMsec pa asnjë hyrje

Çdo çelës/kusht DTMF hartohet në një grup veprimesh që do të ekzekutohen në sekuencë.

Veprimet e mbështetura

VeprimiParametratPërshkrimi
Uebhookurl (varg, kërkohet)
trupi (objekt, opsional)
headers (objekt, opsional)		Dërgon një kërkesë HTTP POST në formatin JSON në URL-në e specifikuar. Objekti “trupi” do të vendoset nën fushën “veprim” në kërkesën për uebhook. Titujt e personalizuar përfshihen si tituj HTTP.
hangupAsnjëPërfundon thirrjen
gotoMenumenu (varg ose numër i plotë)Navigon thirrjen në një meny tjetër në grupin menu duke përdorur indeksin e tij të bazuar në 0 (p.sh., “1”)

Sjellje e detajuar e veprimit

Veprimi i lidhjes së uebit (‘hook ueb’)

Veprimi “hook ueb” dërgon një kërkesë HTTP POST në URL-në tuaj të kthimit të thirrjes me meta të dhënat e thirrjes dhe të dhënat opsionale të personalizuara:

  • Nëse ofrohet një “trup”, çiftet e tij çelës-vlerë dërgohen brenda fushës “veprim” të trupit të ngarkesës.
  • Nëse ofrohen headers, ato dërgohen si tituj të personalizuar HTTP në kërkesë.

Veprimi i ndërprerjes (‘hangup’)

Veprimi “Hangup” përfundon menjëherë thirrjen aktive. Asnjë veprim i mëtejshëm në sekuencë ose meny nuk do të përpunohet pas një veprimi “hangup”.

Shkoni te Veprimi i menysë (gotoMenu)

Veprimi gotoMenu e ridrejton rrjedhën e thirrjes në një strukturë tjetër të menysë brenda grupit të “menusë”. Duhet një parametër i vetëm menu i cili specifikon indeksin e bazuar në 0 të menysë së synuar (p.sh., “1” për të shkuar në menynë e dytë, ose “0” për të rifilluar menynë e parë).

Pasiviteti dhe trajtimi i gabimeve (‘gabim’)

Tasti “i gabuar” brenda “dtmfActions” është një mbajtës i veçantë i dështimit. Ai ekzekuton vargun e tij të sekuencës së veprimeve në dy skenarë:

  1. Inputi i pavlefshëm: Telefonuesi shtyp një tast DTMF që nuk është përcaktuar në “dtmfActions” (për shembull, ata shtypin “3” por menyja përcakton vetëm “d1” dhe “d2”).
  2. Idle Timeout: Telefonuesi nuk shtyp asnjë çelës brenda kohëzgjatjes së specifikuar nga idleTimeoutMsec.

Nëse “gabim” nuk është përcaktuar dhe telefonuesi shtyp një çelës të pavlefshëm ose skadon, fluksi i telefonatës do të mbyllet si parazgjedhje. Përcaktimi i ‘gabim’ ju lejon të krijoni meny të ciklit (p.sh. kthimin në të njëjtën meny me `“veprim”: “gotoMenu”, “menu”: “0"") ose ridrejtimin e përdoruesit në një menu ndihme.

Formati i dorëzimit të Uebhook

Kur aktivizohet veprimi i ‘webhook’, sistemi dërgon një kërkesë HTTP POST te ‘url’ e konfiguruar me ‘Content-Type: application/json’.

Titujt e Kërkesave të Uebhook

Nëse veprimi është konfiguruar me parametrin “headers”, ato çifte çelës-vlerë përfshihen si tituj HTTP në kërkesë.

Trupi i kërkesës për uebhook

Ngarkesa JSON e dërguar në URL-në tuaj të uebhook-ut ka strukturën e mëposhtme:

KODI_BLOCK_1

FushaLlojiPërshkrimi
”nga”vargNumri i telefonit / ID e dërguesit
përvargNumri i telefonit të marrësit
mesavargID e mesazhit
veprimobjektObjekti i personalizuar JSON i përcaktuar në fushën “trupi” të veprimit

Shembull i plotë

IVR e thjeshtë me afat kohor dhe vërtetim të hyrjes

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "text": "ivr",
      "type": "speechcall",
      "menu": [
        {
          "introUrl": "ivr_651854",
          "idleTimeoutMsec": 10000,
          "dtmfActions": {
            "d1": [
              {
                "action": "webhook",
                "url": "https://YourWebhookURL/0",
                "body": {
                  "confirm": true
                }
              },
              {
                "action": "hangup"
              }
            ],
            "d2": [
              {
                "action": "webhook",
                "url": "https://YourWebhookURL/1",
                "body": {
                  "confirm": false
                }
              },
              {
                "action": "hangup"
              }
            ],
            "wrong": [
              {
                "action": "hangup"
              }
            ]
          }
        }
      ]
    }
  ]
}

Kompleks IVR me Menu të Shumëfishta dhe Rrugë DTMF

Ky shembull tregon se si të përcaktohen menytë e shumta dhe të lundroni ndërmjet tyre duke përdorur veprimin “gotoMenu” kur përdoruesi fut një çelës të pavlefshëm ose kur koha e thirrjes përfundon. Ai gjithashtu tregon trupat e personalizuar dhe titujt e personalizuar të HTTP të dërguara me aktivizuesit e uebit.

KODI_BLOCK_3

Formati i përgjigjes

Përgjigja e suksesit

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

Trajtimi i gabimeve

Statusi HTTPPërshkrimi
200Kërkesa me sukses
400Format i pavlefshëm i kërkesës
401Autentifikimi dështoi
429Kufiri i tarifës është tejkaluar
500Gabim i brendshëm i serverit

cURL Shembull

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "from": "YourSender",
        "to": "+380XXXXXXXXX",
        "text": "ivr",
        "type": "speechcall",
        "menu": [
          {
            "introUrl": "ivr_XXXXX",
            "idleTimeoutMsec": 10000,
            "dtmfActions": {
              "d1": [
                {
                  "action": "webhook",
                  "url": "https://YourWebhookURL/0",
                  "body": {
                    "confirm": true
                  },
                  "headers": {
                    "test-header": "test"
                  }
                },
                {
                  "action": "hangup"
                }
              ],
              "d2": [
                {
                  "action": "webhook",
                  "url": "https://YourWebhookURL/1",
                  "body": {
                    "confirm": false
                  }
                },
                {
                  "action": "hangup"
                }
              ],
              "wrong": [
                {
                  "action": "gotoMenu",
                  "menu": "1"
                }
              ]
            }
          },
          {
            "introUrl": "ivr_651854",
            "idleTimeoutMsec": 10000,
            "dtmfActions": {
              "d1": [
                {
                  "action": "webhook",
                  "url": "https://YourWebhookURL/0",
                  "body": {
                    "confirm": true
                  }
                },
                {
                  "action": "hangup"
                }
              ],
              "d2": [
                {
                  "action": "webhook",
                  "url": "https://YourWebhookURL/1",
                  "body": {
                    "confirm": false
                  }
                },
                {
                  "action": "hangup"
                }
              ],
              "wrong": [
                {
                  "action": "hangup"
                }
              ]
            }
          }
        ]
      }
    ]
  }'

Praktikat më të mira

  1. Skedarët audio - Sigurohuni që URL-të hyrëse të jenë të aksesueshme dhe skedarët audio janë në formate të mbështetura
  2. Besueshmëria e Uebhook-it - Dizajnoni grepa në internet që të përgjigjen shpejt (brenda 2 sekondave)
  3. Opsionet DTMF - Kufizoni opsionet e menysë në 4-6 zgjedhje për përvojë më të mirë të përdoruesit
  4. Trajtimi i kohëzgjatjes - Përdorni idleTimeoutMsec për të specifikuar kufijtë e personalizuar të pasivitetit (p.sh. 10000 ms) dhe konfiguroni një kthim të këndshëm nën tastin DTMF “të gabuar” (si përsëritja e menysë ose mbyllja e telefonit)
  5. Rrjedha e thirrjeve me shumë meny - Përdorni ‘gotoMenu’ me kujdes për të parandaluar unazat e pafundme gjatë rrugëtimit të përdoruesve në menytë e mëparshme
  6. Strategjia e kthimit - Përdorni mesazhe kthyese për përdoruesit që nuk përgjigjen ose shkëputen

Tema të ngjashme