Input

The input action will collect the digits from the caller or callee on a live call. when the digits are collected, you can make the call jump to the next action also. Collecting the digits will be useful to create multi-level IVR, confirming the order, etc,

Prerequisites

1. Sign up for a free PIOPIY demo account.

2. Create your endpoint and add capacity.

3. Buy PIOPIY phone number.

4. Setup your webserver and map your POST method URL in answer URL.

Input action JSON

[
  {
    "action": "input",
    "max_digit": 4,
    "timeout": 5,
    "action_url": "https://test.com/dtmf"
  }
]

Properties

Property	Type	Description
*action	string	The PCMO action to control the flow of the call.
max_digit	number	It defines the DTMF input length. By default the maximum digit is 1
timeout	number	The seconds to wait, to get the DTMF. By default the timeout is 5 seconds.
*action_url	string	Your webserver URL to inform the DTMf input

Note

The * marked property is mandatory.

Sample JSON Response

Your web server will get a sample response from PIOPIY Platform as given below for incoming call.

{
  action: 'inbound',
  from: '19170000001',
  to: '19170000000',
  time: 1670568234000,
  cmiuuid: '28b9fc5f-b147-47e1-80a4-1edf1339efe1'
}

Properties

These are the list of properties and its description

Property	Type	Description
action	string	Direction of this call
from	number	The number who made a call
to	string	Your PIOPIY phone number
time	string	Timestamp of this call
cmiuuid	string	A unique identifier of this call

Sample JSON Response for DTMF

If the provided information is valid, your web server will get a sample response from PIOPIY Platform as given below

{ 
  "from": 919100000000,
  "to": 4471000000,
  "dtmf": "1234",
  "cmuuid": "41aa4bb1-d693-415e-82ce-bdf2e8814aeb"
}

Properties

These are the list of properties and its description

Property	Type	Description
from	number	The number the call came from
to	number	Your PIOPIY phone number
dtmf	string	The digits entered during the call
cmiuuid	string	A unique identifier of this call