Добавить или удалить тег диалога

Этот метод добавляет и удаляет тег диалога.

URL

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

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

Аргументы

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

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

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

Ответ

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

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

Примеры

<!-- Добавить тег mytag диалогу с ID=716 от имени бота:

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  --data-urlencode 'tag=mytag' \
  --data-urlencode 'action=add' \
  'https://api.carrotquest.io/v1/conversations/716/tag'

Удалить тег mytag из диалога с ID=716 от имени бота:

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  --data-urlencode 'tag=mytag' \
  --data-urlencode 'action=delete' \
  'https://api.carrotquest.io/v1/conversations/716/tag'

--> Добавить тег mytag диалогу с ID=716 от имени администратора с ID=912:

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  --data-urlencode 'tag=mytag' \
  --data-urlencode 'action=add' \
  --data-urlencode 'from_admin=912' \
  'https://api.carrotquest.io/v1/conversations/716/tag'