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": "BazarCOM",
      "to": "+380936670003",
      "text": "ivr",
      "type": "speechcall",
      "menu": [
        {
          "introUrl": "ivr_651854",
          "idleTimeoutMsec": 10000,
          "dtmfActions": {
            "d1": [
              {
                "action": "webhook",
                "url": "https://api.example.com/callback/option1",
                "body": {
                  "confirm": true
                },
                "headers": {
                  "X-Custom-Header": "value"
                }
              },
              {
                "action": "hangup"
              }
            ],
            "d2": [
              {
                "action": "webhook",
                "url": "https://api.example.com/callback/option2",
                "body": {
                  "confirm": false
                }
              },
              {
                "action": "hangup"
              }
            ],
            "wrong": [
              {
                "action": "hangup"
              }
            ]
          }
        }
      ]
    }
  ]
}

Përshkrimi i parametrit

Parametri	Lloji	Kërkohet	Përshkrimi
"nga"	varg	Po	Identifikuesi i dërguesit (emri alfa ose ID)
`për`	varg	Po	Numri i telefonit të marrësit në format ndërkombëtar
`tekst`	varg	Po	Vlera e tekstit, zakonisht "ivr" për SpeechCall
'lloj'	varg	Po	Duhet të jetë `"telefonatë e folur"`
`menu`	grup	Po	Gama e konfigurimeve të menysë për thirrjen

Konfigurimi i menysë

Çdo objekt i menusë përmban:

Parametri	Lloji	Kërkohet	Përshkrimi
`introUrl`	varg	Po	URL ose identifikues i skedarit audio hyrës
`idleTimeoutMsec`	numër i plotë	Jo	Koha 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
`dtmfActions`	objekt	Po	Harta 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 DTMF	Përshkrimi
`d0`	Shtypni 0
`d1`	Shtypni 1
`d2`	Shtypni 2
...	...
`d9`	Shtypni 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

Veprimi	Parametrat	Përshkrimi
`Uebhook`	`url` (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.
`hangup`	Asnjë	Përfundon thirrjen
`gotoMenu`	`menu` (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”`)

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

Fusha	Lloji	Përshkrimi
"nga"	varg	Numri i telefonit / ID e dërguesit
`për`	varg	Numri i telefonit të marrësit
`mesa`	varg	ID e mesazhit
`veprim`	objekt	Objekti 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": "BazarCOM",
      "to": "+380936670003",
      "text": "ivr",
      "type": "speechcall",
      "menu": [
        {
          "introUrl": "ivr_651854",
          "idleTimeoutMsec": 10000,
          "dtmfActions": {
            "d1": [
              {
                "action": "webhook",
                "url": "https://api.example.com/callback/option1",
                "body": {
                  "confirm": true
                }
              },
              {
                "action": "hangup"
              }
            ],
            "d2": [
              {
                "action": "webhook",
                "url": "https://api.example.com/callback/option2",
                "body": {
                  "confirm": false
                }
              },
              {
                "action": "hangup"
              }
            ],
            "wrong": [
              {
                "action": "hangup"
              }
            ]
          }
        }
      ]
    }
  ]
}

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": "+380936670003",
      "status": "sent"
    }
  ]
}

Trajtimi i gabimeve

Statusi HTTP	Përshkrimi
200	Kërkesa me sukses
400	Format i pavlefshëm i kërkesës
401	Autentifikimi dështoi
429	Kufiri i tarifës është tejkaluar
500	Gabim 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_651854",
            "idleTimeoutMsec": 10000,
            "dtmfActions": {
              "d1": [
                {
                  "action": "webhook",
                  "url": "http://api.smsbat.local/gatereq/temp/hook",
                  "body": {
                    "confirm": true
                  },
                  "headers": {
                    "test-header": "test"
                  }
                },
                {
                  "action": "hangup"
                }
              ],
              "d2": [
                {
                  "action": "webhook",
                  "url": "http://api.smsbat.local/gatereq/temp/hook",
                  "body": {
                    "confirm": false
                  }
                },
                {
                  "action": "hangup"
                }
              ],
              "wrong": [
                {
                  "action": "gotoMenu",
                  "menu": "1"
                }
              ]
            }
          },
          {
            "introUrl": "ivr_651854",
            "idleTimeoutMsec": 10000,
            "dtmfActions": {
              "d1": [
                {
                  "action": "webhook",
                  "url": "http://localhost/1"
                }
              ],
              "d2": [
                {
                  "action": "webhook",
                  "url": "http://localhost/1"
                }
              ],
              "wrong": [
                {
                  "action": "hangup"
                }
              ]
            }
          }
        ]
      }
    ]
  }'

Praktikat më të mira

Skedarët audio - Sigurohuni që URL-të hyrëse të jenë të aksesueshme dhe skedarët audio janë në formate të mbështetura
Besueshmëria e Uebhook-it - Dizajnoni grepa në internet që të përgjigjen shpejt (brenda 2 sekondave)
Opsionet DTMF - Kufizoni opsionet e menysë në 4-6 zgjedhje për përvojë më të mirë të përdoruesit
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)
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
Strategjia e kthimit - Përdorni mesazhe kthyese për përdoruesit që nuk përgjigjen ose shkëputen

Tema të ngjashme

Dërgo Mesazh - Udhëzues i përgjithshëm për dërgimin e mesazheve
Flash Call - Telefonata të thjeshta të verifikimit zanor
Kontrollo statusin - Gjurmo statusin e dorëzimit të mesazhit
Llojet e mesazheve - Përmbledhje e të gjitha llojeve të mesazheve të mbështetura