eocean-logo
Login
Request a Demo

Voice OTP Call via Interactive Voice Response Service

Introduction

This article provides information on processing API service which will enable users to get One Time Password (OTP) via IVR service.

IVR: IVR (Interactive Voice Response) uses pre-recorded voice prompts and menus to provide information and options in order to receive responses from the users via keypad dialing. IVR applications are programs that control and respond to calls on the IVR platform.

Prerequisites for API

Number: The contact number of the user should be provided in the correct format in API for getting a success response.
Code: Code is a numeric value parameter it must be provided to generate anIVR call from the system.
Username: username will have to register in the system for accessing the API.
Password: user should provide their registered password for getting the success response from API.

Description

This document includes a detailed explanation of service involved during the process along with the steps.

The IVR call through API will be performed as:

  • The user will get a call from Voice OTP service to their number by hitting the API (https://ivr.eocean.us/********/ outbound.cgi? number=033XXXXXXXX & code= 1234 & username= demo&password=””) from browser.
  • The user will get a call from Voice OTP service to their number by hitting the API (https://ivr.eocean.us/********/ outbound.cgi? number=033XXXXXXXX & code= 1234 & username= demo&password=””) from browser.
  • The call will be transferred to the user if their provided parameters are verified and API generates success response code.
  • The system will respond in accordance with the information provided.

IVR call will not be processed in the following scenarios:

  • The user number is invalid, the call will get disconnected.
  • Call was disconnected by the user.
  • Call was disconnected due to a system error.
  • The user does not enter a valid code.
  • Authentication Failure.

Service Specifications

Voice OTP IVR Service

Introduction

This service will be utilized to find out whether the user identity gets verified after getting an IVR call from the system.

Steps

  • Call the API with user name (which is registered in a system) along with user mobile number (to which the call is received), password (registered unique password for user) and code (numeric unique value for each registered user) in parameters.
  • Here the API will verify the authenticity of the user.
  • Now the system will check if the user with provided credentials is verified.
  • If yes, the IVR processing service initiated.
  • Users will receive the IVR call from the system to their provided registered number.
  • If any parameter provided in API is not verified, the same will be responded via API and call will not receive.

Parameters

a. Request

sr.no Field name Field type Field Lenght Mandatory/ Optional Sample Data
1
username
string
5
M
Demo
2
Password
String
5
M
xxxxxx
3
Number
Numeric
15
M
03xxxxxxxxxx
4
code
Numeric
20
M
1234

b. Response

sr.no Field name Field type Field Lenght Sample Data
1
Response Code
string
3
200
2
Response Description
String
3
ok

Error Response Codes

Response Code Response Descriptio
400
Bad Request
2
Unauthorized

b. Response

image

Voice OTP Layout