---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/messenger/doc/ru/api-requests/message-send-typing.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/messenger/doc/ru/llms.txt

# Отправка индикатора набора текста

Метод отправляет в чат событие «печатает...» (typing). Его можно вызывать перед отправкой ответа, чтобы пользователь видел индикатор ввода. Таймаут 3 секунды.

HTTP метод: `POST`

URL: `https://botapi.messenger.yandex.net/bot/v1/messages/sendTyping/`

## Заголовки
```
Authorization: OAuth <токен>
Content-Type: application/json
```

## Тело запроса (JSON)
| Имя параметра | Обязательный | Тип | Описание | Ограничения, значение по умолчанию |
| ------------- | ------------ | --- | ---------| ---------------------------------- |
| `chat_id` | Нет* | `string` | Идентификатор целевого чата | Бот должен быть участником чата |
| `user_id` | Нет* | `string` | Идентификатор целевого пользователя (UUID) | — |
| `login` | Нет* | `string` | Логин целевого пользователя | — |
| `thread_id` | Нет | `integer` | Идентификатор треда (timestamp сообщения) | — |

(*) Необходимо указать ровно один из параметров `chat_id`, `user_id` или `login` — в одном запросе нельзя передавать несколько из них одновременно.

## Ограничения {#restriction}
1. Бот может отправлять события только в те чаты, в которых он является участником или админом.
2. Бот не может отправлять личные события пользователям, для которых это запрещено настройками приватности.
3. Бот не может отправлять личные события пользователям вне своей организации.

## Результат {#result}
При успешном выполнении возвращается HTTP 200. Тело ответа может отсутствовать или быть пустым.

В случае ошибки возвращается соответствующий статус HTTP. Описание ошибки приходит в поле `description`.

| Имя параметра | Обязательный | Тип | Описание |
| ------------- | ------------ | --- | ---------|
| `ok` | Да | `boolean` | Флаг успешности выполнения |
| `description` | Да | `string` | Описание ошибки |

## Пример запроса
```
curl -X POST -H 'Authorization: OAuth AtXXXXXXXXXXX' -H "Content-Type: application/json" -d '{"chat_id":"0/0/4f24b544-697c-4e18-a9c1-b39432ee9bf9"}' 'https://botapi.messenger.yandex.net/bot/v1/messages/sendTyping/'
```

## Пример ответа с ошибкой
```
{"ok": false, "description": "Bot is not a member of the chat"}
```