स्पीचकल सन्देशहरू

SpeechCall एक अन्तरक्रियात्मक भ्वाइस प्रतिक्रिया (IVR) सन्देश प्रकार हो जसले तपाईंलाई मेनु विकल्पहरू र DTMF (डुअल-टोन बहु-फ्रिक्वेन्सी) अन्तरक्रियाहरूका साथ स्वचालित भ्वाइस कलहरू गर्न अनुमति दिन्छ।

सिंहावलोकन

SpeechCall ले व्यवसायहरूलाई सक्षम बनाउँछ: - ग्राहकहरूलाई स्वचालित भ्वाइस कल गर्नुहोस् - परिचयात्मक अडियो सन्देशहरू प्ले गर्नुहोस् - अन्तरक्रियात्मक मेनु विकल्पहरू प्रस्तुत गर्नुहोस् - DTMF कुञ्जी प्रेस प्रतिक्रियाहरू ह्यान्डल गर्नुहोस् (०-९, *, #) - अमान्य/टाइमआउट इनपुटहरूको लागि अनुकूलन व्यवहार परिभाषित गर्नुहोस् - प्रयोगकर्ता चयनहरूमा आधारित अनुकूलन निकायहरू र हेडरहरूसँग वेबहुकहरू ट्रिगर गर्नुहोस् - कल प्रवाह गतिशील रूपमा प्रबन्ध गर्नुहोस् (मेनुहरू बीच नेभिगेट गर्नुहोस्)

केसहरू प्रयोग गर्नुहोस्

ग्राहक सर्वेक्षण - फोन मेनु विकल्पहरू मार्फत प्रतिक्रिया सङ्कलन
अपोइन्टमेन्ट रिमाइन्डरहरू - भ्वाइस अन्तर्क्रियाको साथ पुष्टि गर्नुहोस् वा पुन: तालिका बनाउनुहोस्
अर्डर ट्र्याकिङ - अर्डर स्थिति अद्यावधिकहरू प्रदान गर्नुहोस्
अन्तर्क्रियात्मक सूचनाहरू - कार्य विकल्पहरूको साथ महत्त्वपूर्ण जानकारी डेलिभर गर्नुहोस्
आवाज प्रमाणीकरण - भ्वाइस कलहरू मार्फत बहु-कारक प्रमाणीकरण

अनुरोध ढाँचा

आधारभूत संरचना

{
  "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"
              }
            ]
          }
        }
      ]
    }
  ]
}

प्यारामिटर विवरण

प्यारामिटर	प्रकार	आवश्यक	विवरण
'बाट'	स्ट्रिङ	हो	प्रेषक पहिचानकर्ता (अल्फा नाम वा आईडी)
`to`	स्ट्रिङ	हो	अन्तर्राष्ट्रिय ढाँचामा प्राप्तकर्ता फोन नम्बर
`पाठ`	स्ट्रिङ	हो	पाठ मान, सामान्यतया "ivr" SpeechCall
`प्रकार`	स्ट्रिङ	हो	`"स्पीचकल"` हुनुपर्छ
`मेनु`	array	हो	कलको लागि मेनु कन्फिगरेसनहरूको एरे

मेनु कन्फिगरेसन

प्रत्येक मेनु वस्तु समावेश:

प्यारामिटर	प्रकार	आवश्यक	विवरण
'introUrl'	स्ट्रिङ	हो	परिचयात्मक अडियो फाइलको URL वा पहिचानकर्ता
`idleTimeoutMsec`	पूर्णांक	छैन	कुञ्जी थिच्नका लागि मिलिसेकेन्डमा टाइमआउट (जस्तै, `१००००`)। यदि प्रयोगकर्ताले प्रतिक्रिया दिँदैन भने, `गलत` कुञ्जी अन्तर्गत कन्फिगर गरिएका कार्यहरू कार्यान्वयन गरिनेछन्
`dtmfActions`	वस्तु	हो	कार्यहरूको DTMF कुञ्जीहरूको नक्सा

DTMF कार्यहरू

'dtmfActions' वस्तुले DTMF कुञ्जीहरू वा कार्यहरूको एरेहरूमा विशेष सर्तहरू नक्सा गर्दछ:

DTMF कुञ्जी	विवरण
`d0`	0
`d1`	1
`d2`	2
...	...
`d9`	9 थिच्नुहोस्
`d*`	थिच्नुहोस् *
`d#`	#
'गलत'	अवैध कुञ्जी थिच्दा वा कुनै इनपुट बिना `idleTimeoutMsec` पुग्दा ट्रिगर हुन्छ

प्रत्येक DTMF कुञ्जी/सर्त क्रमबद्ध रूपमा कार्यान्वयन गरिने कार्यहरूको एर्रेमा नक्सा गर्दछ।

समर्थित कार्यहरू

कार्य	प्यारामिटरहरू	विवरण
`वेबहुक`	`url` (स्ट्रिङ, आवश्यक) `body` (वस्तु, ऐच्छिक) `हेडर` (वस्तु, ऐच्छिक)	निर्दिष्ट URL मा JSON ढाँचामा HTTP POST अनुरोध पठाउँछ। वेबहुक अनुरोधमा `बॉडी` वस्तु `कार्य` फिल्ड अन्तर्गत नेस्ट गरिनेछ। अनुकूलन हेडरहरू HTTP हेडरहरूको रूपमा समावेश छन्।
`hangup`	कुनै पनि छैन	कल समाप्त हुन्छ
`gotoMenu`	`मेनु` (स्ट्रिङ वा पूर्णांक)	यसको ०-आधारित अनुक्रमणिका प्रयोग गरेर `मेनु` एरेमा अर्को मेनुमा कल नेभिगेट गर्छ (जस्तै, `"1"`)

विस्तृत कार्य व्यवहार

वेबहुक कार्य (`वेबहुक`)

'webhook' कार्यले कल मेटाडेटा र वैकल्पिक अनुकूलन डेटाको साथ तपाईंको कलब्याक URL मा HTTP POST अनुरोध पठाउँछ: - यदि एक शरीर प्रदान गरिएको छ भने, यसको मुख्य-मान जोडीहरू पेलोड शरीरको कार्य क्षेत्र भित्र पठाइन्छ। - यदि हेडर प्रदान गरिएको छ भने, तिनीहरू अनुरोधमा अनुकूलन HTTP हेडरहरूको रूपमा पठाइन्छ।

ह्याङ्गअप कार्य (`ह्याङअप')

'hangup' कार्यले सक्रिय कल तुरुन्तै समाप्त गर्छ। 'ह्याङअप' कार्य पछि अनुक्रम वा मेनुमा कुनै थप कार्यहरू प्रशोधन गरिने छैन।

मेनु कार्यमा जानुहोस् (`gotoMenu`)

'gotoMenu' कार्यले कलको प्रवाहलाई menu array भित्रको फरक मेनु संरचनामा रिडिरेक्ट गर्छ। यसले एकल प्यारामिटर मेनु लिन्छ जसले लक्ष्य मेनुको ०-आधारित अनुक्रमणिका निर्दिष्ट गर्दछ (जस्तै, "१" दोस्रो मेनुमा जानको लागि, वा "०" पहिलो मेनु पुनः सुरु गर्न)।

निष्क्रियता र त्रुटि ह्यान्डलिंग (`गलत')

dtmfActions भित्रको गलत कुञ्जी एउटा विशेष फलथ्रु ह्यान्डलर हो। यसले दुई परिदृश्यहरूमा कार्य अनुक्रमको आफ्नो एरे कार्यान्वयन गर्दछ: १. अमान्य इनपुट: कलरले dtmfActions मा परिभाषित नभएको DTMF कुञ्जी थिच्छ (उदाहरणका लागि, उनीहरूले 3 थिच्छन् तर मेनुले d1 र d2 मात्र परिभाषित गर्छ)। 2. निष्क्रिय टाइमआउट: कलरले idleTimeoutMsec द्वारा निर्दिष्ट अवधि भित्र कुनै कुञ्जी थिच्दैन।

यदि गलत परिभाषित गरिएको छैन र कलरले अमान्य कुञ्जी वा टाइम आउट थिच्यो भने, कल प्रवाह पूर्वनिर्धारित रूपमा ह्याङ्ग अप हुनेछ। गलत परिभाषित गर्नाले तपाईंलाई लुप मेनुहरू निर्माण गर्न अनुमति दिन्छ (जस्तै "कार्य": "gotoMenu", "menu": "0" सँग उही मेनुमा फर्केर) वा प्रयोगकर्तालाई मद्दत मेनुमा रिडिरेक्ट गर्ने।

वेबहुक डेलिभरी ढाँचा

जब webhook कार्य ट्रिगर हुन्छ, प्रणालीले कन्फिगर गरिएको url लाई Content-Type: application/json सँग HTTP POST अनुरोध पठाउँछ।

वेबहुक अनुरोध हेडरहरू

यदि कार्य हेडर प्यारामिटरसँग कन्फिगर गरिएको छ भने, ती कुञ्जी-मान जोडीहरूलाई अनुरोधमा HTTP हेडरहरूको रूपमा समावेश गरिन्छ।

वेबहुक अनुरोध निकाय

तपाईंको वेबहुक URL मा पठाइएको JSON पेलोडको निम्न संरचना छ:

{
  "from": "0443914272",
  "to": "50001",
  "mid": "7748021",
  "action": {
    "confirm": true
  }
}

क्षेत्र	प्रकार	विवरण
'बाट'	स्ट्रिङ	कल गर्ने फोन नम्बर / प्रेषक आईडी
`to`	स्ट्रिङ	प्रापकको फोन नम्बर
'मध्य'	स्ट्रिङ	सन्देश ID
'कार्य'	वस्तु	कार्यको `body` फिल्डमा परिभाषित गरिएको अनुकूलन JSON वस्तु

पूरा उदाहरण

टाइमआउट र इनपुट प्रमाणीकरणको साथ सरल IVR

{
  "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"
              }
            ]
          }
        }
      ]
    }
  ]
}

बहु मेनु र DTMF राउटिङको साथ जटिल IVR

यो उदाहरणले प्रयोगकर्ताले अमान्य कुञ्जी इनपुट गर्दा वा कल टाइम आउट हुँदा gotoMenu कार्य प्रयोग गरेर कसरी बहु मेनुहरू परिभाषित गर्ने र तिनीहरूको बीचमा नेभिगेट गर्ने भनेर देखाउँछ। यसले वेबहुक ट्रिगरहरूसँग पठाइएका अनुकूलन निकायहरू र अनुकूलन HTTP हेडरहरू पनि देखाउँदछ।

{
  "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"
              }
            ]
          }
        }
      ]
    }
  ]
}

प्रतिक्रिया ढाँचा

सफलताको प्रतिक्रिया

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

त्रुटि ह्यान्डलिंग

HTTP स्थिति	विवरण
२००	अनुरोध सफल
400	अमान्य अनुरोध ढाँचा
४०१	प्रमाणीकरण असफल
४२९	दर सीमा नाघ्यो
५००	आन्तरिक सर्भर त्रुटि

cURL उदाहरण

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"
                }
              ]
            }
          }
        ]
      }
    ]
  }'

उत्तम अभ्यासहरू

अडियो फाइलहरू - परिचय URL हरू पहुँचयोग्य छन् र अडियो फाइलहरू समर्थित ढाँचाहरूमा छन् भनी सुनिश्चित गर्नुहोस्।
वेबहुक विश्वसनीयता - छिटो प्रतिक्रिया दिन वेबहुक डिजाइन गर्नुहोस् (२ सेकेन्ड भित्र)
DTMF विकल्पहरू - राम्रो प्रयोगकर्ता अनुभवको लागि मेनु विकल्पहरूलाई 4-6 विकल्पहरूमा सीमित गर्नुहोस्
टाइमआउट ह्यान्डलिंग - अनुकूलन निष्क्रियता सीमाहरू निर्दिष्ट गर्न idleTimeoutMsec प्रयोग गर्नुहोस् (जस्तै 10000 ms), र गलत DTMF कुञ्जी अन्तर्गत एक आकर्षक फलब्याक कन्फिगर गर्नुहोस् (जस्तै मेनु दोहोर्याउने वा ह्याङिङ अप गर्ने)
मल्टी-मेनु कल फ्लो - प्रयोगकर्ताहरूलाई अघिल्लो मेनुहरूमा फर्काउँदा अनन्त लुपहरू रोक्न सावधानीपूर्वक gotoMenu प्रयोग गर्नुहोस्।
फलब्याक रणनीति - जवाफ नदिने वा विच्छेदन गर्ने प्रयोगकर्ताहरूका लागि फलब्याक सन्देशहरू प्रयोग गर्नुहोस्

सम्बन्धित विषयहरू

सन्देश पठाउनुहोस् - सामान्य सन्देश पठाउने गाइड
फ्ल्यास कल - सरल आवाज प्रमाणिकरण कलहरू
स्थिति जाँच गर्नुहोस् - सन्देश डेलिभरी स्थिति ट्र्याक गर्नुहोस्
सन्देशका प्रकारहरू - सबै समर्थित सन्देश प्रकारहरूको अवलोकन