Получить диалоги с пользователем

Этот метод позволяет получить диалоги с пользователем.

URL

GET https://api.carrotquest.io/v1/users/{id}/conversations

В качестве {id} нужно использовать ID из нашей системы.

Аргументы

Этот метод следует общим правилам. Аргументы передаются как GET или POST параметры.

Аргумент Описание
auth_token Обязательный. Токен авторизации (нужен scope: conversations-read и user-read)
after Пагинация, начать с данного курсора
count Пагинация, максимальное количество диалогов, которое нужно вернуть (от 1 до 50). По умолчанию: 20

Подробнее о пагинации.

Ответ

{
  "data": [
    {
      "id": 7100586,
      "created": 1450342055,
      "read": true,
      "replied": true,
      "clicked": false,
      "unsubscribed": false,
      "closed": false,
      "message": null,
      "type": "popup_chat",
      "reply_type": "text",
      "part_last": {
        "id": 7855356,
        "created": 1450345019,
        "conversation": 7100586,
        "body": "...",
        "type": "reply_user",
        "sent_via": "web_user",
        "from": 16588048
      },
      "parts_count": 13,
      "assignee": null,
      "unread_parts_count": 2,
      "last_admin": {
        "id": 24601,
        "name": "Maks",
        "avatar": "https://files.carrotquest.io/avatars/1446021235578-je57yp6v.jpg",
        "type": "admin"
      },
      "last_update": 1450345019,
      "tags": []
    },
    ...
  ],
  "meta": {
    "next_after": 1447339319.900966,
    "status": 200
  }
}

Ответ будет содержать объекты Conversation.

В объекте будет отсутствовать поле user. Чтобы получить информацию о пользователе, используйте метод для получения информации о конкретном пользователе.

Примеры

curl -X GET https://api.carrotquest.io/v1/users/8173131/conversations?auth_token=XXX