Индикаторы ввода | Документация для разработчиков
Индикаторы ввода
Обновлено: 21 октября 2025 г
Когда вы получаете сообщений, указывающий на получение сообщения , вы можете использовать
message.id , чтобы пометить сообщение как прочитанное и отобразить индикатор набора текста, чтобы пользователь WhatsApp знал, что вы готовите ответ. Это хорошая практика, если ответ займет у вас несколько секунд.
Индикатор набора текста исчезнет после вашего ответа или через 25 секунд, в зависимости от того, что наступит раньше. Чтобы избежать неудобств для пользователя, отображайте индикатор набора текста только в том случае, если вы собираетесь ответить.
Синтаксис запроса
curl -X POST \
'https://graph.facebook.com/
< API_VERSION > / < WHATSAPP_BUSINESS_PHONE_NUMBER_ID > /messages' -H 'Authorization: Bearer
< ACCESS_TOKEN > ' \ -H 'Content-Type: application/json' \
-d '
{
"messaging_product": "whatsapp",
"status": "read",
"message_id": "
< WHATSAPP_MESSAGE_ID > ", "typing_indicator": {
"type": "text"
}
}'
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить | Необходимый. Системный токен или бизнес-токен . | |
<API_VERSION>Нить | Необязательный. Версия Graph API. | v25.0 |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить | Необходимый. Идентификатор бизнес-телефона WhatsApp. | 106540352242922 |
<WHATSAPP_MESSAGE_ID>Нить | Необходимый. Идентификатор сообщения WhatsApp. Этот идентификатор присваивается messages.id в полученных сообщений . | wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJDQjZCMzlEQUE4OTJBMTE4RTUA |
Ответ
В случае успеха:
{
"success"
: true }
Пример запроса
curl 'https://graph.facebook.com/ v25.0 /106540352242922/messages' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "messaging_product": "whatsapp", "status": "read", "message_id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJDQjZCMzlEQUE4OTJBMTE4RTUA", "typing_indicator": { "type": "text" } }'Ответ
В случае успеха:
{
"success"
: true }