Кто-то печатает ...

Этот метод позволяет установить статус "Пользователь Х печатает сообщение ..." в диалоге. Можно передать печатаемое сообщение, получается "наблюдение за печатью".

URL

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

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

Параметры

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

Параметр Тип Описание
body строка Набираемое сообщение
from_user Optional[ID] ID пользователя, от имени которого отправляется typing
from_admin Optional[ID/default_admin] Укажите ID администратора в случае ответа от администратора или default_admin для отправки от имени дефолтного отправителя сайта

Замечания

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

Ответ

Поле data возвращается пустым.

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

Ошибки

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

Примеры

Установить "печатает пользователь на сайте":

curl -X POST \
  --data-urlencode "body=My Message" \
  --data-urlencode "from_user=true" \
  -H "Authorization: Token XXX" \
  https://api.carrotquest.io/conversations/1789152/settyping

Установить "печатает администратор" (ID администратора 8164):

curl -X POST \
  --data-urlencode "body=My Message" \
  --data-urlencode "from_admin=8164" \
  -H "Authorization: Token XXX" \
  https://api.carrotquest.io/conversations/1789152/settyping

Установить "печатает администратор по умолчанию":

curl -X POST \
  --data-urlencode "body=My Message" \
  --data-urlencode "from_admin=default_admin" \
  -H "Authorization: Token XXX" \
  https://api.carrotquest.io/conversations/1789152/settyping