Chat List

Description

You can use this API to get the complete list of chats and the info available about the chat in your department.

Query Parameters

*limit : The number of chats you would like to get, the maximum limit is restricted to 99 (By default, the limit is set to 50.)

*fromtime : The chats after the specified time will be retrieved and displayed.

*totime : The chats before the specified time will be retrieved and displayed.

Pre-requisite

A valid OAuth Token is mandatory.

Click to view the list of Sample Response Params

URL


				https://salesiq.zoho.com/api/v1/<screenname>/chats			

Example


				https://salesiq.zoho.com/api/v1/zylker/chats?limit=15&fromtime=1459171743914&totime=1458795665587			

Success Response


				{
  "data": [
    {
      "department_id": "4489000000002013",
      "chatinitiated_time": "1459171743914",
      "attender_name": "Patricia",
      "attender_email": "patricia@zylker.com",
      "attender_id": "4489000000002001",
      "country_code": "US",
      "participants": [
        "5000000000007"
      ],
      "embed_id": "4489000000002043",
       "supervisor":[
         "5000000000005"
      ],
      "chat_duration": "120000",
      "end_time": "1459171979283",
      "chat_id": "282",
      "visitor_ip": "192.168.141.236",
      "visitor_email": "tom@zylker.com",
      "visitor_name": "Tom",
      "question": "Running a test chat !",
      "department_name": "sales",
      "embed_name": "zylker",
      "pickup_time": "1459171840646",
      "waited_duration": "25000",
      "chat_title" : "Zylker"
    },
{
      "missed_time":"1458795725587",
      "visitor_phoneno": "1-541-754-3010",
      "customer_info": {
        "Expiry": "Jan 20, 2016",
        "Band": "Premium"
      },
      "crm_info":"Lead",
      "department_id": "4489000000002013",
      "chatinitiated_time": "1458795665587",
      "country_code": "US",
      "embed_id": "4489000000127003",
      "end_time": "1458795665587",
      "chat_id": "277",
      "visitor_ip": "192.168.141.236",
      "visitor_email": "tom@zylker.com",
      "visitor_name": "Tom",
      "description" : "Info about the list of chats in your departments",
      "question": "Running a test chat",
      "department_name": "sales",
      "embed_name": "zylker",
      "waited_duration": "60000"
    }
  ]
}			

Error Codes - General Error


				Internal Server error while retrieving the chat list
 code : 2010
 Error Message : "Unable to retrieve Chat list"			

Error Response - Example


				{
 "error" :
  {
           "message":"Unable to retrieve Chat list",
           "code":2010
    }
}