Incoming Answered

Each API request in TeleCMI platform includes App id and secret. Get your App id and secret in CHUB dashboard. After getting the app id and secret, make a POST request to the below base URL to retrieve the incoming answered call details.

Base URL

Send your POST method request with valid parameters, to the following base URL.

https://piopiy.telecmi.com/v1/answered

Required Parameters

These are the required POST method parameters with description

Parameter Name	Type	Description
*appid	number	Your app ID
*token	string	Your app secret
start_date	number	The from date and time in timestamp. By default the timestamp will be last 24 hours from current timestamp.
end_date	number	The to date and time in timestamp, By default the timestamp will be current timestamp .
page	number	The Number of page per 10 record. By default the page is 1.
limit	number	The Number of record for request, By default the limit is 10.

Note

The * marked parameter is mandatory.

Sample JSON Request

Below is the following sample JSON POST method request

{
  "appid": 1111113,
  "token": "xxxx-xxxx-xxxx-xxx",
  "start_date": 1569911400000,
  "end_date": 1570167249853,
  "page": 2,
  "limit": 5
}    

Sample Response

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

{
  "total": 19,
  "cdr": [
    {
      "_id": "5d95dabd04eaac7de3aa20c8",
      "to": 9100000000,
      "time": 1570101934939,
      "from": 9200000000,
      "agent": "201_1111113",
      "billedsec": 14,
      "rate": "0.00",
      "record": "true",
      "filename": "15700821185415026428427_1111113.mp3",
      "name": "unknown"
    },
    {
      "_id": "5d95daa804eaac7de3aa20c1",
      "to": 9300000000,
      "time": 1570101916018,
      "from": 9400000000,
      "agent": "201_1111113",
      "billedsec": 12,
      "rate": "0.00",
      "record": "true",
      "filename": "157008212492320417337498_1111113.mp3",
      "name": "unknown"
    },
    {
      "_id": "5d95dadb04eaac7de3aa20d0",
      "to": 9500000000,
      "time": 1570101820557,
      "from": 9600000000,
      "agent": "201_1111113",
      "billedsec": 10,
      "rate": "0.00",
      "record": "true",
      "filename": "15700821786156624298395_1111113.mp3",
      "name": "unknown"
    },
    {
      "_id": "5d95dad104eaac7de3aa20cd",
      "to": 9700000000,
      "time": 1570101807162,
      "from": 9800000000,
      "agent": "202_1111113",
      "billedsec": 13,
      "rate": "0.00",
      "record": "true",
      "filename": "157008211915747906964588_1111113.mp3",
      "name": "unknown"
    },
    {
      "_id": "5d95da8f04eaac7de3aa20b9",
      "to": 9900000000,
      "time": 1570101739436,
      "from": 9100000000,
      "agent": "201_1111113",
      "billedsec": 15,
      "rate": "0.00",
      "record": "true",
      "filename": "157008209657297373120208_1111113.mp3",
      "name": "unknown"
    }
  ],
  "code": 200
}

Properties

These are the list of properties and its description

Property	Type	Description
total	number	The total count of call detail record(cdr) available
cdr	JSON array	The list of total cdr in detail
_id	string	A unique identifier of the call
to	number	The number of user(agent) received the call
time	number	Timestamp of the call
from	number	The number of the call came from
agent	string	A unique Id of the user(agent)
billedsec	number	The duration of call in seconds
rate	string	The call cost of the call
record	string	Call recording is enabled
filename	string	The file name of the recorded conversation
name	string	The name of the caller

HTTP status codes

TeleCMI API platform represents the following status code to identity the errors.

Status code	Status code	Description
200	OK	We received the request
404	Error	Invalid app id or secret, authentication failed