Inbound Missed

To receive the inbound webhooks, you must complete the webhooks setup. After completing the webhooks setup, our PIOPIY platform will notify your web server POST method URL with JSON CDR ( Call Detail Record) when an incoming call got missed.

Properties

These are the list of properties and its description

Property	Type	Description
to	number	Your incoming DID number
appid	number	Your app id
time	number	Timestamp of this call
start_time	number	The start time of this call
end_time	number	The end time of this call
from	number	The number who made a call
direction	string	Direction of this call
duration	number	The total duration of this call in seconds
extra_params	string	Your custom parameters
cmiuuid	string	A unique identifier of this call
call_rate	string	The billed call rate for this call
balance	string	The total available account balance after this call
conversation_uuid	string	A unique identifier of this conversation
callerid	number	The incoming DID number
answer_time	number	The answer time of this cal
leg	string	Define the leg of the call either a or b
status	string	Status of this call

CDR response

This is the sample JSON CDR (Call Detail Record), where the PIOPIY platform will notify your web server POST method URL.

Leg A

{
  to: 440000000000,
  appid: 2222222,
  time: 1632317071000,
  start_time: 1632317068,
  end_time: 1632317073,
  from: 440000000001,
  direction: 'inbound',
  duration: 0,
  extra_params: '{"key":"value"}',
  cmiuuid: '33079756-faed-4a29-8b36-c8ead67e047c',
  call_rate: 0,
  balance: '899.000000',
  conversation_uuid: '33079756-faed-4a29-8b36-c8ead67e047c',
  answer_time: 1632318515,
  leg: 'a',
  status: 'missed'
}

Leg B

{
  to: 440000000000,
  appid: 2222222,
  time: 1632317071000,
  start_time: 1632317068,
  end_time: 1632317073,
  from: 440000000001,
  direction: 'outbound',
  duration: 0,
  extra_params: '{"key":"value"}',
  cmiuuid: '33079756-faed-4a29-8b36-c8ead67e047c',
  call_rate: 0,
  balance: '899.000000',
  conversation_uuid: '33079756-faed-4a29-8b36-c8ead67e047c',
  callerid: 19170000000,
  status: 'missed',
  leg: 'b'
}

The above sample JSON live event consists of several properties. Each property has a description and take a look at it.

Implementation

PIOPIY webhooks implementation in different languages.

Node.js

const express = require("express"),
  bodyParser = require("body-parser"),
  app = express();

// parse application/json
app.use(bodyParser.json());

app.post("/webhook/cdr", (req, res) => {
  //Received CDR JSON Object from PIOPIY platform
  var cdr = req.body;

  console.log(cdr);

  res.send("got it");
});

app.listen(5000);
app.run((debug = True), (port = 5000));

To know more about testing webhooks for local development purposes, go to examples.

Python

from flask import Flask,request
app = Flask(__name__)


# Receive webhooks from PIOPIY platform when call receive or make
@app.route("/webhook/cdr",methods=['POST'])
def hello():
    # Received JSON CDR from PIOPIY Platform
    cdr = request.get_json()
    print(cdr)

    return "got it"

if __name__ == "__main__":
    app.run(debug=True, port=5000)

To know more about testing webhooks for local development purposes, go to examples.