Назначить диалог

Этот метод назначает определенный диалог определенному администратору (или снимает назначение).

URL

POST https://api.carrotquest.io/v1/conversations/{id}/assign

В качестве {id} нужно использовать ID диалога.

Аргументы

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

Аргумент Описание
auth_token Обязательный. Токен авторизации (нужен scope: conversations-write)
admin Обязательный. ID администратора, которому назначается диалог (либо '' (пустое значение) для снятия назначения)
from_admin Обязательный. Укажите ID администратора в случае назначения администратором (а не ботом).<!-- Можно указать default_admin — администратор по умолчанию
bot_name Укажите имя бота, от которого происходит отправка. Имя по умолчанию: Bot-->
random_id Случайный ID ConversationPart для контроля отправки. По умолчанию: 0

Если диалог уже назначен на этого администратора, ничего не произойдет, будет возвращен ответ со стаусом 200.

Ответ

{
  "data": {
  }
  "meta": {
    "status": 200
  }
}

Ответ будет пустым.

Примеры

<!-- Назначить диалог с ID=716 администратору с ID=819 от имени бота:

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  --data-urlencode 'admin=819' \
  'https://api.carrotquest.io/v1/conversations/716/assign'

--> Назначить диалог с ID=716 администратору с ID=819 от имени другого администратора с ID=912:

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  --data-urlencode 'admin=819' \
  --data-urlencode 'from_admin=912' \
  'https://api.carrotquest.io/v1/conversations/716/assign'