> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Сервисные сообщения

> Узнайте о 24-часовом окне обслуживания клиентов и выберите подходящий тип произвольного сообщения WhatsApp для ответа.

Сервисные сообщения — это произвольные сообщения, которые вы можете отправлять, пока открыто окно обслуживания клиентов. В отличие от шаблонных сообщений, их содержание не требует предварительного утверждения шаблона перед каждой отправкой.

Используйте их, чтобы ответить на вопрос, отправить документ, предложить варианты выбора или продолжить диалог с клиентом.

## Окно обслуживания клиентов

Окно обслуживания клиентов длится 24 часа. Согласно текущим правилам Meta для сервисных сообщений, сообщение или звонок от пользователя WhatsApp открывает это окно. Каждое последующее сообщение или звонок пользователя продлевает его.

Ваше собственное исходящее сообщение само по себе не продлевает окно. Поэтому отправка шаблона не эквивалентна получению ответа от клиента.

Ознакомьтесь с правилами платформы в [документации Meta по сервисным сообщениям](https://developers.facebook.com/docs/whatsapp/conversation-types/). При [совместном использовании с приложением WhatsApp Business](/ru/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence) также изучите поведение приложения и API, описанное в соответствующем руководстве.

### Пример временной шкалы

Все указанные ниже события приведены в одном часовом поясе.

| Событие | Влияние на окно |
| - | - |
| Понедельник, 09:00: клиент отправляет вопрос. | Открывается окно до вторника, 09:00. |
| Понедельник, 09:15: ваша команда отвечает. | Время истечения остается прежним — вторник, 09:00. |
| Понедельник, 14:00: клиент отправляет еще одно сообщение. | Окно продлевается до вторника, 14:00. |
| Вторник, после 14:00: клиент больше не выходил на связь. | Используйте подходящий утвержденный шаблон, если нужно продолжить общение. |
| Клиент отвечает на этот шаблон. | Ответ клиента открывает новое окно. |

### Выбор типа отправки

| Ситуация | Вариант отправки |
| - | - |
| Окно открыто. | Используйте поддерживаемое сервисное сообщение или доступный утвержденный шаблон с соблюдением применимых правил. |
| Окно закрылось. | Используйте подходящий утвержденный шаблон. |
| Вы не получали обращений от клиента, открывающих окно. | Наличие номера телефона или согласия клиента не означает, что окно открыто. |
| Вы отправили шаблон, но клиент не ответил. | Сама по себе отправка шаблона не открывает новое сервисное окно. |

Сервисное окно определяет только возможность отправки произвольных сообщений. Тарифы и правила бесплатных точек входа действуют отдельно. Ознакомьтесь с действующими [тарифами WhatsApp](/ru/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing), а не рассматривайте каждое открытое окно одинаково с точки зрения оплаты.

## Типы произвольных сообщений

Помимо шаблонов, YCloud Messages API поддерживает следующие типы исходящего контента.

| Тип | Применение |
| - | - |
| Текст | Прямой ответ, объяснение или ссылка. |
| Изображение | Фото товара, наглядная инструкция или другое изображение. |
| Видео | Демонстрация или короткое визуальное пояснение. |
| Аудио | Голосовой ответ или аудиозапись. |
| Документ | Чек, инструкция или любой другой файл. |
| Стикер | Поддерживаемый стикер. |
| Геолокация | Конкретное место, например магазин или пункт выдачи. |
| Контакты | Структурированные контактные данные. |
| Реакция | Эмодзи-реакция на существующее сообщение. |
| Интерактивное | Кнопки, списки и другие поддерживаемые интерактивные элементы. |

Это возможности API. Набор функций в Inbox или других продуктах YCloud может быть ограничен. Обращайтесь к руководству по конкретному используемому сценарию.

### Интерактивные сообщения

Выбирайте тип взаимодействия в зависимости от того, какое следующее действие должен совершить клиент.

| Элемент взаимодействия | Типичное применение |
| - | - |
| Кнопки ответа | Выбор из небольшого набора вариантов ответа. |
| Список | Выбор пункта из структурированного списка опций. |
| Кнопка с URL | Переход на соответствующую веб-страницу. |
| Запрос геолокации | Запрос на отправку клиентом своего местоположения. |
| Сообщение о товаре или каталоге | Показ настроенных товаров из каталога. |
| Flow | Сбор структурированной информации, например данных для записи на прием. |
| Кнопка звонка | Вызов через поддерживаемые функции звонков WhatsApp. |
| Карусель | Показ нескольких медиакарточек. |
| Детали или статус заказа | Поддержка подходящих процессов торговли или оплаты. |

Интерактивные типы имеют собственные предварительные требования, обязательные поля и доступность на платформе. Наличие типа в API не означает, что его можно использовать для каждого номера, региона или рабочего процесса в консоли.

См. разделы [Отправка сообщения WhatsApp](/ru/api-reference/guides/whatsapp-platform/send-whatsapp-message), [WhatsApp Flows](/ru/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-flows/index) и [Звонки в WhatsApp](/ru/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-calling) для выбора подходящего следующего шага.

<Frame caption="An interactive reply-button example for an open service window. Buttons return a choice to the business.">
  <div style={{ position: "relative", width: "100%", maxWidth: "600px", margin: "0 auto" }}>
    <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-service-reply-buttons.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=93a4e4b0a2cd1c8fca2f7792fc502736" alt="Интерактивное сервисное сообщение Meta с обозначением заголовка, тела, нижнего колонтитула и кнопок ответа «Изменить» и «Отмена»." style={{ width: "100%", height: "auto", margin: 0 }} width="1671" height="1624" data-path="product-assets/whatsapp-platform-2026-09-22/meta-service-reply-buttons.png" />
  </div>
</Frame>

Источник: [официальный пример Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/interactive-reply-buttons-messages/).

## Практические ограничения для распространенных произвольных сообщений

Это ограничения YCloud API для указанного типа сообщений, а не лимиты для кнопок шаблонов.

| Контент | Ограничение |
| - | - |
| Текст сообщения | До **4096 символов**. |
| Кнопки интерактивного ответа | До **3 кнопок**; названия кнопок до **20 символов**. |
| Сообщение со списком | Всего до **10 строк во всех секциях**, а не по 10 в каждой секции. |
| Строка списка | Заголовок до **24 символов**; необязательное описание до **72 символов**. |
| Кнопка открытия списка | До **20 символов**. |
| Ссылка на медиафайл | Укажите медиа `id` или HTTP/HTTPS `link`, но не оба одновременно. |
| Имя файла документа | Используйте поле `filename` документа; не помещайте его в несвязанные поля сообщения. |

Для кнопок ответа и списков используйте постоянные идентификаторы, соответствующие вашему рабочему процессу. Например, `track_order` — это идентификатор действия; **Track my order** — это текст, который видит клиент. Обрабатывайте возвращенный ID, а не полагайтесь только на отображаемый текст, который может отличаться в зависимости от языка.

### Пример: короткое сервисное меню

Пока окно открыто, служба доставки может спросить:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
How can we help with your delivery?

[Track my order]  [Change address]  [Talk to a person]
```

Для такого выбора подходят три кнопки ответа. Для семи адресов магазинов обычно понятнее список. Для многостраничной формы записи используйте Flow. Большее количество кнопок не обязательно делает взаимодействие удобнее.

### Проверки медиафайлов для предотвращения устранимых сбоев

* Убедитесь, что отправитель может использовать идентификатор медиафайла, а сервис может получить доступ по любой ссылке.
* Сопоставляйте тип сообщения с фактическим форматом файла. Простое переименование расширения файла не конвертирует его.
* Используйте поддерживаемый MIME-тип и размер для соответствующего типа медиа.
* Проверяйте текст на изображениях и документы на телефоне, а не только на компьютере.
* Сохраняйте ссылки на медиафайлы доступными для доставки; не полагайтесь на истекающую аутентифицированную сессию браузера.
* Не используйте подпись к медиафайлу в качестве замены параметров тела или заголовка шаблона.

### Распространенные форматы медиафайлов и ограничения по размеру

| Сообщение | Распространенные поддерживаемые типы файлов | Максимальный размер файла |
| - | - | - |
| Изображение | JPEG или PNG | 5 МБ |
| Видео | MP4 или 3GPP | 16 МБ |
| Аудио | AAC, AMR, MP3, MP4 audio или поддерживаемый OGG | 16 МБ |
| Документ | PDF; дополнительные типы документов зависят от способа отправки | 100 МБ для поддерживаемого пути PDF |
| Статический стикер | WebP | 100 КБ |
| Анимированный стикер | WebP | 500 КБ |

Для изображений используйте 8-битный RGB или RGBA. Для видео Meta поддерживает видео H.264 с аудио AAC, с одной аудиодорожкой или без звука. Для аудио OGG используйте кодек OPUS и монофонический вход; простого изменения расширения недостаточно.

Эти ограничения платформы не означают доступность каждого формата в каждом редакторе YCloud. Например, требования к образцам медиафайлов для шаблонов строже, чем для общих медиафайлов сервисных сообщений.

Источники: [форматы медиа Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media/), [требования к изображениям](https://developers.facebook.com/docs/whatsapp/cloud-api/messages/image-messages/), [ограничения для стикеров](https://developers.facebook.com/docs/whatsapp/cloud-api/messages/sticker-messages/) и [OpenAPI YCloud](https://newdocs.ycloud.com/openapi/endpoints/ycloud-api-v2.yaml).

## Когда ответ из очереди выходит за границы окна

Ответ, подготовленный в 08:59, может быть отправлен после закрытия окна в 09:00. Проверяйте доступность при фактической отправке, а не только тогда, когда оператор открывает диалог или запускается автоматизация.

Если окно истекло, выберите одобренный шаблон, соответствующий цели последующего взаимодействия. Не отправляйте шаблон с предположением, что сразу после него можно добавлять произвольный текст: шаблон сам по себе не открывает сервисное окно заново.

Связанное с рекламой **72-часовое окно бесплатной точки входа является тарифным правилом**, а не 72 часами неограниченных произвольных ответов. Продолжайте применять правило 24 часов для сервисных сообщений.

## Делайте ответ полезным

* Выбирайте самый простой формат, позволяющий клиенту понять информацию или совершить действие.
* Избегайте запроса информации, которая у вас уже есть.
* Формулируйте кнопки и варианты списка понятно и четко.
* Проверяйте окно в момент отправки сообщения, а не только при создании черновика.
* Учитывайте [запросы на отказ от рассылки](/ru/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out).

Если Inbox не может отобразить входящее сообщение, следуйте инструкциям в разделе [Неподдерживаемые сообщения в Inbox](/ru/documentation/inbox/unsupported-messages-in-inbox). Не делайте предположений об исходном содержимом на основе плейсхолдера.

## Дальнейшие действия

* [Ответ через Inbox](/ru/documentation/inbox/inbox-introduction).
* [Отправка через API](/ru/api-reference/guides/whatsapp-platform/send-whatsapp-message).
* [Использование шаблона вне окна](/ru/documentation/whatsapp-business-platform/messaging/message-templates/index).
* [Проверка статусов доставки сообщений](/ru/documentation/whatsapp-business-platform/messaging/message-delivery-statuses).

## Часто задаваемые вопросы

<AccordionGroup>
  <Accordion title="Клиент написал вчера, а оператор открыл чат только сегодня. С какого момента отсчитывается окно?">
    Окно открывается с момента подходящего взаимодействия со стороны клиента, а не тогда, когда оператор назначен или открывает Inbox. Используйте метку времени последнего подходящего взаимодействия клиента и проверяйте ее повторно перед отправкой. Если окно закрылось, отправьте подходящий одобренный шаблон и дождитесь ответа клиента, прежде чем возвращаться к сообщениям в свободной форме.
  </Accordion>

  <Accordion title="Клиент нажал кнопку с URL-адресом. Открывает ли это сервисное окно заново?">
    Переход на веб-сайт сам по себе не является входящим сообщением WhatsApp. Не перезапускайте окно на основании отчета о клике по ссылке. Ориентируйтесь на фактические входящие действия: быстрый ответ, отправляющий сообщение назад, отличается от кнопки, которая лишь открывает URL.
  </Accordion>

  <Accordion title="Можно ли отправить сообщение со списком, чтобы возобновить неактивный диалог?">
    Нет, это нельзя использовать как обходной путь для свободной переписки. Списки и обычные сообщения с кнопками ответа относятся к сервисным форматам и требуют открытого окна. Вне его рамок используйте одобренный шаблон с поддерживаемыми компонентами и назначением, соответствующим ожиданиям клиента.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.