Forward Call to PSTN

The bridge action will connect the call to other phone numbers. For example, when the caller dials the PIOPIY phone number the incoming call can be routed to multiple phone numbers at a time, such as landline and mobile number.

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.

Bridge action JSON

• Single
• Group

[
  {
  "action": "bridge",
  "duration": 300,
  "timeout": 20,
  "from": 19170000000,
  "loop": 2,
  "connect": [
    {
      "type": "pstn",
      "number": 440000000000
    }
   ]
  }
]

Properties

Property	Type	Description
*action	string	The PCMO action to control the flow of the call.
from	number	It defines the caller id of this call. By default, the from number will be PIOPIY plaform's default phone number.
duration	number	The duration of this call in seconds. By default, the duration is 5400. seconds.
timeout	number	The ringing time of this call in seconds, The default value for timeout is 40.
loop	number	The total number of retry, of this call. By default, the loop is 1.
ring_type	string	It defines to call multiple phone numbers at a time. By default, the ring type is single.
*connect	JSON array	type = Defines the type internet or pstn. number = The phone number to connect, it may be mobile or landline number.

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