Skip to main content

Get details of a List of Conversations

Description

You can use this API to get the details of a list of conversations.

Query Parameters:

  • page - Each page fetches 20 conversations. Use this parameter to fetch the set of conversations with respect to pages.  
  • limit - Number of conversations to be fetched in a particular request, the default value is 20, and the maximum value is 99.
  • status - To list the conversations associated with the specified status (Values: open, closed, waiting, connected, missed, end)
  • department_id - To list the conversation associated with the specified department ID, if the department id is not mentioned, then the operator's current department ID will be considered.
  • attender_id - The chat attender's (operator) unique ID. To get the list of conversations attended by a particular operator.
  • fields - This param can be used to fetch the data of a specified field. You can specify any field, and in the response, you'll receive only the data of the specified field (visitor, department, question, start_time, attended_time, missed_time, end_time, owner, attender, supervisors, participants, status.)
  • from_time - The conversations with start time greater than the mentioned time are fetched. The value must be mentioned in milliseconds.
  • to_time - The conversations with start time lesser than the mentioned time are fetched. The value must be mentioned in milliseconds.
  • app_id - To list the conversation associated with the specified Website/Brand ID.
  • email - The conversations associated with the mentioned email IDs are fetched. 
  • visitor_type - To get the list of all conversations based on the visitor type mentioned. (Values: lead and contact)
  • updated_till_time - To get the conversations before the specified update time.
  • updated_from_time - To get the conversations after the specified update time.
  • sort_by - To sort conversations based on in_time (Chat initiated time), end_time, or updated_time. By default, the conversations are sorted based on updated_time.

Note:  For department_id, app_id, and attender_id multiple IDs can be given separated by a comma.

OAuth Scope:

SalesIQ.conversations.READ

URL:

Copiedhttps://{zohosalesiq_server_uri}/api/v2/{screen name}/conversations

Example:

Copiedhttps://salesiq.zoho.com/api/v2/zylker/conversations?status=closed&limit=20

Sample Response:

Copied{
  "url": "/api/v2/zylker/conversations",
  "object": "list",
  "data": [
    {
      "id": "19000000085003",
      "end_time": "1567141185253",
      "owner": {
        "email": "patricia@zylker.com",
        "name": "Patricia",
        "id": "19000000079005"
      },
      "question": "hello",
      "attender": {
        "email": "tricia@zylker.com",
        "name": "Tricia",
        "id": "19000000079006"
      },
      "status": "Attended Online",
      "department": {
        "name": "conversation2",
        "id": "19000000000017"
      },
      "participants": [
        {
          "email": "Danny@zylker.com",
          "name": "Danny",
          "id": "19000000079007"
        }
      ],
      "start_time": "1567073480392",
      "visitor": {
        "phone": "122321421341",
        "email": "Daffany@zylker.com",
        "name": "Daffany"
      },
      "app_id": "19000000000047",
      "supervisors": [
        {
          "email": "Dency@zylker.com",
          "name": "Dency",
          "id": "19000000000008"
        }
      ],
      "attended_time": "1567073481231"
    },
    {
      "id": "19000000084165",
      "end_time": "1566976875732",
      "owner": {
        "email": "Patricia@zylker.com",
        "name": "Patricia",
        "id": "19000000079005"
      },
      "question": "Bot pickuped?",
      "attender": {
        "email": "Tricia@zylker.com",
        "name": "Tricia",
        "id": "19000000079006"
      },
"status": "Attended Online",
      "department": {
        "name": "conversation2",
        "id": "19000000000017"
      },
      "participants": [
        {
          "email": "Danny@zylker.com",
          "name": "Danny",
          "id": "19000000079007"
        },
        {
          "email": "Dency@zylker.com",
          "name": "Dency",
          "id": "19000000000008"
        }
      ],
      "start_time": "1566976697276",
      "visitor": {
        "phone": "0098765434567876",
        "email": "Danna@zylker.com",
        "name": "Dann"
      },
      "app_id": "19000000000047",
      "supervisors": [
        {
          "email": "Tricia@zylker.com",
          "name": "Tricia",
          "id": "19000000000006"
        }
      ],
      "last_message_info": {
        "sender": {
          "name": "Dann",
          "id": "$2487775191209924871"
        },
        "type": "text",
        "message": {
          "text": "I would like to contact the shipping status team."
        },
        "time": "1566976680259"
      },
      "attended_time": "1566976697476"
    }
  ],
  "more_data_available": true
}