Incoming Answered CDR

To receive the incoming answered cdr, you must complete the webhooks setup. After completing the webhooks setup, our TeleCMI platform will notify your web server POST or GET method URL with JSON Call Detail Record(CDR) when an incoming call answered.

Sample CDR response

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

{
  virtual_number: 440000000000,
  custom: '{"key":"value"}',
  appid: 2222223,
  type: 'cdr',
  direction: 'inbound',
  cmiuuid: '16132200-57fa-47b5-888d-4ab5b7e631ee',
  user: '204_2222223',
  status: 'answered',
  to: 440000000001,
  from: 440000000002,
  time: 1634720920615,
  answeredsec: 11,
  team: 'Sales_2222223',
  hangup_reason: 'recv_bye',
  record: true,
  filename: '1634720915260737218351_2222223.mp3',
  conversation_uuid: '16132200-57fa-47b5-888d-4ab5b7e631ee',
  ivr_name: 'salesivr'
}

The above sample JSON Call Detail Record(CDR) consists of several properties. Each property has a description, so take a look at it.

Properties

This is the list of properties and their descriptions.

Property	Type	Description
virtual_number	number	The caller ID of the inbound call.
custom	string	Your custom parameters.
appid	number	Your app id.
type	string	Type of notification from TeleCMI platform it may be cdr or event.
direction	string	The direction of this call is inbound.
cmiuuid	string	A unique identifier for this call.
user	string	A unique ID of the user.
status	string	The status of this answered call.
to	number	The user phone number.
from	number	The call was made from this number.
time	number	A timestamp indicates the time the call was answered.
answeredsec	number	The duration of the call was answered in seconds.
team	string	Name of the team where the call was answered.
hangup_reason	string	sent_bye = The call ended by the user. recv_bye = The call ended by the caller. recv_cancel = The call ended due to user unanswer. sent_reject = The call rejected by the user.
record	boolean	If the record is enabled, it shows the status as true.
filename	string	The file name of the recorded conversation.
conversation_uuid	string	A unique identifier for this overall conversation.
ivr_name	string	The name of the last IVR stage touched by the customer during their call interaction.

Implementation

TeleCMI webhooks implementation in different languages.

Python

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


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

    return "got it"



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

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 TeleCMI platform
    var cdr = req.body;

    console.log(cdr);

    res.send('got it');

})


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

PHP

<?php
use \Psr\Http\Message\ServerRequestInterface as Request;
use \Psr\Http\Message\ResponseInterface as Response;
require 'vendor/autoload.php';
 
$app = new \Slim\App;
 
$handler = function (Request $req, Response $res) {
    $cdr = $req->getParsedBody();
    error_log(print_r($cdr, true));
    return $res->withStatus(204);
};
 
$app->post('/webhook/cdr', $handler);
$app->run();

Java

/*
 * This Java source file was generated by the Gradle 'init' task.
 */
package telecmi_example_java;

import static spark.Spark.*;

import com.cedarsoftware.util.io.JsonWriter;

public class App {

	public static void main(String[] args) {

		port(5000);

		post("/webhook/cdr", (req, res) -> {

			System.out.println("You got CDR from TeleCMI Platform");
			String cmiJSON = JsonWriter.formatJson(req.body());
			System.out.println(cmiJSON);
			res.status(204);
			return "";
		});

	}
}

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