Создать диалог, начатый пользователем на сайте

Этот метод создает диалог, который был инициирован пользователем на сайте (то есть первое сообщение в диалоге — от пользователя).

Для создания диалога, в котором первое сообщение от администратора, нужно использовать метод отправки сообщения пользователю /users/{id}/sendmessage.

URL

POST https://api.carrotquest.io/v1/users/{id}/startconversation

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

Аргументы

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

Аргумент Описание
auth_token Обязательный. Токен авторизации (нужен scope: as-user и conversations-write)
body Обязательный. Текст сообщения

Ответ

{
  "meta": {
    "status": 200
  },
  "data": {
    "id": 1856194,
  }
}

Ответ будет содержать ID диалога.

Примеры

curl -X POST \
  --data-urlencode 'body=Hello' \
  --data-urlencode 'auth_token=XXX' \
  https://api.carrotquest.io/v1/users/3964935/startconversation