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

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

URL

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

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

Параметры

Параметры аутентификации.
Параметр id_as_string.

Параметр	Тип	Описание
`admin`	Optional[ID]	ID администратора, которому назначается диалог. Если не задан - назначение снимается с текущего оператора.
`from_admin`	ID/`default_admin`	Укажите ID администратора в случае ответа от администратора или `default_admin` для отправки от имени дефолтного отправителя сайта
`random_id`	Optional[integer]	Случайное целое число, чтобы сопостовлять создаваемое сообщение с репликой из RTS. По умолчанию, `0`

Замечания

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

Чтобы контролировать, кто производит назначение, используйте параметр from_admin.

random_id используются для сопоставления реплики, пришедшей через Realtime services. Вы можете записать сюда случайное 32-битное число, которое придет в поле random_id объекта ConversationPart, созданного этим запросом. В этом случае нельзя использовать ID реплики, поскольку Realtime services работают асинхронно и сообщение туда может прийти раньше, чем вы получите ответ на запрос создания реплики. А может и наоборот. Порядок не определен.

Ответ

Если назначение не изменилось, будет возвращен пустой ответ в поле data.

В случае, если реплика была создана в поле data будет возвращен словарь, содержащий:

id: ID - идентификатор созданной системной реплики назначения
part_group: ID - идентификатор вопроса, к которому принадлежит новая реплика

Пример:

{
  "data": {
    "id": 123,
    "part_group": 345
  },
  "meta": {
    "status": 200
  }
}

Ошибки

Стандартные ошибки Web API.

Примеры

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

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