Настройка времени жизни сообщения | Документация для разработчиков
Настройте время жизни сообщения
Обновлено: 27 февраля 2026 г
Если сообщение не удается доставить пользователю WhatsApp, попытка доставки повторяется в течение периода времени, известного как время жизни сообщения («TTL»), или срок действия сообщения.
Вы можете настроить значение TTL по умолчанию для шаблонов аутентификации и служебных сообщений, отправляемых через Cloud API, а также для маркетинговых шаблонов, отправляемых через Marketing Messages API для WhatsApp.
Установите значение TTL для всех шаблонов аутентификации, предпочтительно равное или меньшее времени истечения срока действия кода, чтобы ваши клиенты получали сообщение только тогда, когда код еще действителен.
Значения по умолчанию, минимальные/максимальные значения и таблица совместимости
| Аутентификация | Полезные функции | Маркетинг | |
|---|---|---|---|
TTL по умолчанию | 10 минут Для шаблонов аутентификации, созданных до 23 октября 2024 года, установлен срок в 30 дней | 30 дней | 30 дней |
Совместимость | Облачный API | Только облачный API | API для маркетинговых сообщений в WhatsApp |
Настраиваемый диапазон | от 30 секунд до 15 минут | от 30 секунд до 12 часов | от 12 часов до 30 дней |
Настройте значение TTL
Чтобы установить пользовательское значение TTL для шаблона аутентификации, служебного шаблона или маркетингового шаблона, добавьте
message_send_ttl_seconds в POST-запрос. /message_templates call.С помощью этого метода вы также можете изменить значение TTL в ранее настроенном шаблоне.
Значение TTL можно изменять с шагом в 1 секунду.
Допустимые значения свойства message_send_ttl_seconds
от 30 до 900 секунд (от 30 секунд до 15 минут)Вспомогательные шаблоны: от 30 до 43200 секунд (от 30 секунд до 12 часов)Шаблоны маркетинговых кампаний: от 43200 до 2592000 (от 12 часов до 30 дней)Для аутентификации и шаблонов служебных файлов можно установить значение свойства
message_send_ttl_seconds -1 , что задаст пользовательское значение TTL в 30 дней.Пример запроса
curl 'https://graph.facebook.com/v21.0/102290129340398/message_templates' \ -H 'Authorization: Bearer EAAJB...' \ -H 'Content-Type: application/json' \ -d ' { "name": "test_template", "language": "en_US", "category": "MARKETING", "message_send_ttl_seconds": 120, "components": [ { "type": "BODY", "text": "Shop now through {{1}} and use code {{2}} to get {{3}} off of all merchandise.", "example": { "body_text": [ [ "the end of August","25OFF","25%" ] ] } }, { "type": "FOOTER", "text": "Use the buttons below to manage your marketing subscriptions" }, ] }'Пример ответа
{ "id": "572279198452421", "status": "ОЖИДАЕТСЯ", "category": "МАРКЕТИНГ" }Когда превышено значение TTL
Система отбрасывает сообщения, которые не могут быть доставлены в течение заданного по умолчанию или пользовательского времени жизни (TTL).
Если вы не получили веб-перехватчик "Доставленное сообщение" до истечения времени жизни сообщения (TTL), считайте, что сообщение было отброшено.
Если вы отправите сообщение, которое не будет доставлено , может возникнуть небольшая задержка перед получением веб-хука, поэтому, возможно, стоит предусмотреть небольшой буфер, прежде чем считать, что сообщение было отброшено.
Сброс TTL при автоматическом обновлении категорий
Если шаблон переклассифицируется в результате автоматического обновления категории , значение TTL обнуляется путем установки его в нулевое значение . Вы можете установить значение TTL на любое значение в пределах настраиваемого диапазона для новой категории шаблона, как указано в таблице значений по умолчанию, минимальных/максимальных значений и совместимости .
Например, если шаблон служебной рассылки с заданным временем жизни (TTL) в 12 часов переклассифицируется как маркетинговый шаблон, заданное значение TTL обнуляется (
message_send_ttl_seconds = null ). На этом этапе вы можете установить значение TTL на любой диапазон от 12 часов до 30 дней, что соответствует настраиваемому диапазону для маркетинговых шаблонов, как указано в таблице выше.Дополнительную информацию о категориях шаблонов сообщений WABA и связанных с ними рабочих процессах см разделе «Категоризация шаблонов»