ސްޕީޗްކޯލް މެސެޖްތައް
ސްޕީޗްކޯލް އަކީ މެނޫ އޮޕްޝަންތަކާއި ޑީޓީއެމްއެފް (ޑައުއަލް ޓޯން މަލްޓި ފްރީކުއެންސީ) އިންޓަރެކްޝަންތަކާއެކު އޮޓޮމެޓިކް ވޮއިސް ކޯލް ކުރެވޭ އިންޓަރެކްޓިވް ވޮއިސް ރެސްޕޮންސް (އައިވީއާރު) މެސެޖް ޓައިޕެކެވެ.
އޯވަރވިއު
ސްޕީޗްކޯލްގެ ސަބަބުން ވިޔަފާރިތަކަށް: - ކަސްޓަމަރުންނަށް އޮޓޮމެޓިކް ވޮއިސް ކޯލް ކުރުން - ތަޢާރަފް އޯޑިއޯ މެސެޖުތައް ކުޅުން - އިންޓަރެކްޓިވް މެނޫ އޮޕްޝަންތައް ހުށަހެޅުން - ޑީޓީއެމްއެފް ކީޕްރެސް ޖަވާބުތައް (0-9، *، #) ޙަވާލުކުރުން - ސައްހަ ނޫން/ޓައިމްއައުޓް އިންޕުޓްތަކަށް ކަސްޓަމް ބިހޭވިއަރ ކަނޑައެޅުން - ޔޫޒަރ ސެލެކްޝަންތަކަށް ބަލައިގެން ކަސްޓަމް ބޮޑީސް އާއި ހެޑަރސް އާއި އެކު ވެބްހޫކްސް ޓްރިގަރ ކުރުން - ކޯލް ފްލޯ ޑައިނަމިކް ގޮތެއްގައި މެނޭޖްކުރުން (މެނޫތަކުގެ މެދުގައި ދަތުރުކުރުން)
ޔޫސް ކޭސްސް
- ކަސްޓަމަރ ސާރވޭސް - ފޯނުގެ މެނޫ އޮޕްޝަންސް މެދުވެރިކޮށް ފީޑްބެކް އެއްކުރުން
- އެޕޮއިންޓްމަންޓް ރިމައިންޑަރސް - އަޑު މުޢާމަލާތާއެކު ކޮންފަރމް ނުވަތަ ރީޝެޑިއުލްކުރުން
- އޯޑަރ ޓްރެކިންގ - އޯޑަރ ސްޓޭޓަސް އަޕްޑޭޓްސް ފޯރުކޮށްދިނުން
- އިންޓަރެކްޓިވް ނޮޓިފިކޭޝަންސް - ފިޔަވަޅު އެޅުމުގެ އިޚްތިޔާރުތަކާއެކު މުހިންމު މަޢުލޫމާތު ފޯރުކޮށްދިނުން
- ވޮއިސް ވެރިފިކޭޝަން - ވޮއިސް ކޯލް މެދުވެރިކޮށް މަލްޓި ފެކްޓަރ އޮތެންޓިކޭޝަން
ރިކުއެސްޓް ފޯމެޓް
އަސާސީ އޮނިގަނޑު
ކޯޑް_ބްލޮކް_0
ޕެރެމިޓަރ ޑިސްކްރިޕްޝަން
| ޕެރެމިޓަރ | ވައްތަރު | ބޭނުންވާ | ތަފްސީލު |
|---|---|---|---|
އިން |
ސްޓްރިންގް | އާދެ | ސެންޑަރ އައިޑެންޓިފައިޓަރ (އަލްފާ ނަން ނުވަތަ އައިޑީ) |
އަށް |
ސްޓްރިންގް | އާދެ | ލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު ބައިނަލްއަޤްވާމީ ފޯމެޓުގައި |
ޓެކްސްޓް |
ސްޓްރިންގް | އާދެ | ޓެކްސްޓް ވެލިއު، އާންމުކޮށް "ivr" އަށް ސްޕީޗްކޯލް |
ވައްތަރު |
ސްޓްރިންގް | އާދެ | ވާންޖެހޭނީ "ސްޕީޗްކޯލް" |
މެނޫ |
އެރޭ | އާދެ | ކޯލް އަށް މެނޫ ކޮންފިގްރޭޝަންތަކުގެ އެރޭ |
މެނޫ ކޮންފިގްރޭޝަން
ކޮންމެ މެނޫ އޮބްޖެކްޓެއްގައި ހިމެނެނީ:
| ޕެރެމިޓަރ | ވައްތަރު | ބޭނުންވާ | ތަފްސީލު |
|---|---|---|---|
އިންޓްރޯއުރލް |
ސްޓްރިންގް | އާދެ | ތަޢާރަފް އޯޑިއޯ ފައިލްގެ ޔޫ.އާރ.އެލް ނުވަތަ އައިޑެންޓިފައިޓަރ |
idleTimeoutMsec |
އިންޓިޖަރ | ނޫން | ކީޕްރެސް އަކަށް އިންތިޒާރު ކުރުމަށް މިލިސެކަންޑްގައި ޓައިމްއައުޓް (އެބަހީ، 10000). ޔޫޒަރ ޖަވާބު ނުދީފިނަމަ، ގޯސް ކީގެ ދަށުން ކޮންފިގްރޭޓް ކުރެވިފައިވާ އަމަލުތައް އެގްޒެކެޓް ކުރެވޭނެ |
dtmfActions |
އެއްޗެއް | އާދެ | ޑީޓީއެމްއެފް ކީސް ޓު އެކްޝަންސްގެ މެޕް |
ޑީޓީއެމްއެފްގެ އަމަލުތައް
dtmfActions އޮބްޖެކްޓް ޑީޓީއެމްއެފް ކީސް ނުވަތަ ޚާއްޞަ ޝަރުތުތައް އެކްޝަންތަކުގެ އެރޭތަކަށް މެޕްކުރެއެވެ:
| ޑީޓީއެމްއެފް ކީ | ތަފްސީލު |
|---|---|
ދ0 |
0 އަށް ފިތާލާށެވެ |
ދ1 |
1 އަށް ފިތާލާށެވެ |
ދ2 |
2 އަށް ފިތާލާށެވެ |
| ... | ... |
ދ9 |
ޕްރެސް 9 |
ދ* |
ފިއްތާލާ * |
ދ# |
# |
ގޯސް |
ސައްހަ ނޫން ކީއެއް ފިއްތާލުމުން ނުވަތަ އެއްވެސް އިންޕުޓެއް ނެތި idleTimeoutMsec އަށް ވާސިލްވުމުން ޓްރިގަރ ކުރެއެވެ |
ކޮންމެ ޑީޓީއެމްއެފް ކީ/ކޮންޑިޝަނެއް މެޕް ކުރަނީ ތަރުތީބުން އެގްޒެކެޓް ކުރާނެ ޢަމަލުތަކުގެ އެރޭއަކަށެވެ.
ސަޕޯޓް ކުރެވޭ އަމަލުތައް
| ފިޔަވަޅު | ޕެރެމިޓަރސް | ތަފްސީލު |
|---|---|---|
ވެބްހޫކް |
url (ސްޓްރިންގް، ބޭނުންވާ)ބޮޑީ (އޮބްޖެކްޓް، އިޚްތިޔާރީ)ހެޑަރސް (އޮބްޖެކްޓް، އިޚްތިޔާރީ) |
ކަނޑައެޅިފައިވާ ޔޫ.އާރ.އެލް އަށް ޖޭއެސްއޯއެން ފޯމެޓުގައި އެޗްޓީޓީޕީ ޕޯސްޓް ރިކުއެސްޓެއް ފޮނުވައެވެ. ވެބްހޫކް ރިކުއެސްޓްގައިވާ އެކްޝަން ފީލްޑްގެ ދަށުން ބޮޑީ އޮބްޖެކްޓް ނެސްޓް ކުރެވޭނެއެވެ. ކަސްޓަމް ހެޑަރސް ހިމަނާފައިވަނީ އެޗްޓީޓީޕީ ހެޑަރސްގެ ގޮތުގައެވެ. |
ހެންގްއަޕް |
އެއްވެސް އެއްޗެއް ނެތް | ކޯލް ނިންމާލަނީ |
ގޯޓޯމެނޫ |
މެނޫ (ސްޓްރިންގް ނުވަތަ އިންޓިޖަރ) |
އޭގެ 0 އަށް ބިނާކޮށްފައިވާ އިންޑެކްސް (އެބަހީ، "1") ބޭނުންކޮށްގެން މެނޫ އެރޭގައިވާ އެހެން މެނޫއަކަށް ކޯލް ނެވިގޭޓް ކުރެއެވެ |
ވެބްހޫކް ޑެލިވަރީ ފޯމެޓް
webhook އެކްޝަން ޓްރިގަރ ވުމުން، ސިސްޓަމުން ކޮންފިގްރޭޓް ކުރެވިފައިވާ url އަށް Content-Type: application/json އާއެކު އެޗްޓީޓީޕީ ޕޯސްޓް ރިކުއެސްޓެއް ފޮނުވައެވެ.
ވެބްހޫކް ރިކުއެސްޓް ހެޑަރސް
އެކްޝަން ކޮންފިގްރޭޓް ކުރެވިފައިވަނީ headers ޕެރެމިޓަރ އިންނަމަ، އެ ކީ-ވެލިއު ޖޯޑުތައް ރިކުއެސްޓްގައި އެޗްޓީޓީޕީ ހެޑަރސްގެ ގޮތުގައި ހިމެނެއެވެ.
ވެބްހޫކް ރިކުއެސްޓް ބޮޑީ
ތިބާގެ ވެބްހޫކް ޔޫއާރްއެލް އަށް ފޮނުވާ ޖޭއެސްއޯއެން ޕޭލޯޑްގައި ތިރީގައިވާ އޮނިގަނޑެއް ހުރެއެވެ.
ކޯޑް_ބްލޮކް_1
| ދަނޑު | ވައްތަރު | ތަފްސީލު |
|---|---|---|
އިން |
ސްޓްރިންގް | ކޯލަރ ފޯނު ނަންބަރު / ސެންޑަރ އައިޑީ |
އަށް |
ސްޓްރިންގް | ލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު |
މެދު |
ސްޓްރިންގް | މެސެޖް އައިޑީ |
އަމަލު |
އެއްޗެއް | އެކްޝަންގެ ބޮޑީ ފީލްޑްގައި ކަނޑައެޅިފައިވާ ކަސްޓަމް ޖޭއެސްއޯއެން އޮބްޖެކްޓް |
ފުރިހަމަ މިސާލު
ޓައިމްއައުޓް އެންޑް އިންޕުޓް ވެލިޑޭޝަން އާއި އެކު ސިމްޕަލް އައިވީއާރު
ކޯޑް_ބްލޮކް_2
މަލްޓިޕަލް މެނޫތަކާއި ޑީޓީއެމްއެފް ރޫޓިންގ އާއި އެކު ކޮމްޕްލެކްސް އައިވީއާރު
މި މިސާލުން ދައްކުވައިދެނީ ޔޫޒަރ އިން ސައްހަ ނޫން ކީއެއް އިންޕުޓް ކުރާއިރު ނުވަތަ ކޯލް ޓައިމް އައުޓް ވާއިރު gotoMenu އެކްޝަން ބޭނުންކޮށްގެން އެތައް މެނޫއެއް ކަނޑައަޅައި އެ މެނޫތަކުގެ މެދުގައި ދަތުރުކުރާނެ ގޮތެވެ. އަދި ވެބްހޫކް ޓްރިގަރސް އާއި އެކު ފޮނުވާ ކަސްޓަމް ބޮޑީސް އާއި ކަސްޓަމް އެޗްޓީޓީޕީ ހެޑަރސް ވެސް ދައްކައެވެ.
ކޯޑް_ބްލޮކް_3
ޖަވާބު ފޯމެޓް
ކާމިޔާބީގެ ރައްދު
ކޯޑް_ބްލޮކް_4
އެރަރ ހެންޑްލިންގ
| އެޗްޓީޓީޕީ ސްޓޭޓަސް | ތަފްސީލު |
|---|---|
| 200 | ރިކުއެސްޓް ކާމިޔާބު |
| 400 ރުފިޔާ | ސައްހަ ނޫން ރިކުއެސްޓް ފޯމެޓެއް |
| 401 ރުފިޔާ | އޮތެންޓިކޭޝަން ފެއިލްވެއްޖެ |
| 429 | ރޭޓް ލިމިޓް ފަހަނައަޅައި ދިޔައީ |
| 500 ރުފިޔާ | އެތެރޭގެ ސަރވަރ އެރަރ |
cURL މިސާލު
ކޯޑް_ބްލޮކް_5
އެންމެ ރަނގަޅު އުސޫލުތައް
- އޯޑިއޯ ފައިލްސް - އިންޓްރޯ ޔޫ.އާރ.އެލް ތަކަށް އެކްސެސިބަލް ކަމާއި އޯޑިއޯ ފައިލްތައް ސަޕޯޓް ކުރެވޭ ފޯމެޓްތަކުގައި ހުރިތޯ ޔަޤީންކުރުން
- ވެބްހޫކް ރިލަޔަބިލިޓީ - އަވަހަށް ޖަވާބުދާރީވުމަށް ވެބްހޫކް ޑިޒައިންކުރުން (2 ސިކުންތުގެ ތެރޭގައި)
- DTMF އޮޕްޝަންސް - ޔޫޒަރ އެކްސްޕީރިއަންސް ރަނގަޅު ކުރުމަށްޓަކައި މެނޫ އޮޕްޝަންސް 4-6 ޗޮއިސް އަށް ލިމިޓް ކުރުން
- ޓައިމްއައުޓް ހެންޑްލިންގ - ކަސްޓަމް އިންއެކްޓިވިޓީ ލިމިޓްތައް ކަނޑައެޅުމަށް
idleTimeoutMsecބޭނުންކުރުން (އެބަހީ 10000 މިލިސެންޓް)، އަދިގޯސްޑީޓީއެމްއެފް ކީގެ ދަށުން ގްރޭސްފުލް ފޯލްބެކް ކޮންފިގްރޭޓްކުރުން (މެނޫ ތަކުރާރުކުރުން ނުވަތަ ފޯނު ކަނޑާލުން ފަދަ) - މަލްޓި-މެނޫ ކޯލް ފްލޯ - ޔޫޒަރުން އަނބުރާ ކުރީގެ މެނޫތަކަށް ރޫޓް ކުރާއިރު އިންފިނިޓް ލޫޕްސް ހުއްޓުވުމަށްޓަކައި
gotoMenuފަރުވާތެރިކަމާއެކު ބޭނުންކުރުން - ފޯލްބެކް ސްޓްރެޓެޖީ - ޖަވާބު ނުދޭ ނުވަތަ ގުޅުން ކަނޑާލާ ޔޫޒަރުންނަށް ފޯލްބެކް މެސެޖުތައް ބޭނުންކުރުން
ގުޅުންހުރި މައުޟޫޢުތައް
- މެސެޖް ފޮނުވުން - އާންމު މެސެޖު ފޮނުވުމުގެ ގައިޑް
- ފްލެޝް ކޯލް - އާދައިގެ އަޑު ޔަގީންކުރުމުގެ ކޯލްތަކެވެ
- ޗެކް ސްޓޭޓަސް - މެސެޖް ޑެލިވަރީ ސްޓޭޓަސް ޓްރެކްކުރުން
- މެސެޖް ޓައިޕްސް - ސަޕޯޓްކުރާ ހުރިހާ މެސެޖް ޓައިޕްތަކެއްގެ އޯވަރވިއު