Get Contact

Each user API request in TeleCMI platform includes user login token. After getting the user login token, make a POST request to the below base URL to retrieve the list of saved contact details.

Base URL

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

https://rest.telecmi.com/v2/user/contact/get

Required Parameters

These are the required POST method parameters with description

Parameter Name	Type	Description
*token	string	Your user token
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. Maximum limit is 10.
name	string	The name of the contact.

Note

The * marked parameter is mandatory.

Sample JSON Request

Below is the following sample JSON POST method request

{
  "token": "xxxx-xxx-xxxx-xxx-xxx",
  "page": 1,
  "limit": 10,
  "name": "Mike"
} 

Sample Response

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

{
    "count": 1,
    "contacts": [
        {
            "agent": "101_1111112",
            "notes": [
                {
                    "msg": "It is a Support Lead",
                    "date": 1629980029850,
                    "agent": "101_1111112"
                }
            ],
            "inet_no": 1111112,
            "name": "Mike",
            "mobile": 9100000000,
            "tag": "callback",
            "time": 1629980029850,
            "remindme": 1630056656976,
            "email": "[email protected]",
            "info": "Sales",
            "status": "Hot Lead"
        }
    ],
    "code": 200
}

Properties

These are the list of properties and its description

Property	Type	Description
agent	string	The user ID for the saved contact
notes	JSON array	The entire notes information of the caller or calle
msg	string	The notes information of the caller or calle
date	number	Timestamp of the added notes in UTC timezone
agent	string	The user ID for the added note
inet_no	number	The App ID
name	string	The name of the saved contact
mobile	number	The phone number of the saved contact
tag	string	The tag assigned for the saved contact
time	number	Timestamp of the saved contact in UTC timezone.
remindme	number	Timestamp for the next remainder in UTC timezone.
email	string	The Email ID of the saved contact
info	string	Additional Information of the saved contact
status	string	The current status of the saved contact

HTTP status codes

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

Status code	Status Type	Description
200	Success	We received the request
404	Error	Invalid user token, Failed to authenticate token
400	Error	Parameter missing, Parameter limit lesser then equals 10