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

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

URL

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

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

Аргументы

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

Аргумент Описание
auth_token Обязательный. Токен авторизации (нужен scope: conversations-write)
body Набираемое сообщение
from_user Укажите true в случае, если печатает пользователь (в этом случае нужен scope as-user)
from_admin Укажите ID администратора в случае, если печатает администратор<!-- (можно указать default_admin — печатает администратор по умолчанию)
bot_name Укажите имя бота, который печатает. Имя по умолчанию: Bot-->

Примеры

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

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

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

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

Ответ

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