Перейти к основному содержимому

Настройка времени жизни сообщения | Документация для разработчиков

Настройте время жизни сообщения

Обновлено: 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 недвижимость в ПОЧТА /<PHONE_NUMBER_ID> /message_templates вызов.
С помощью этого метода вы также можете изменить значение 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 сбрасывается путем установки его в значение a нулевое значениеВы можете установить значение TTL на любое значение в пределах настраиваемого диапазона для новой категории шаблонов, как указано в Значения по умолчанию, минимальные/максимальные значения и таблица совместимости.
    Например, если шаблон утилиты с заданным временем жизни (TTL) равным 12 часам переклассифицируется как маркетинговый шаблон, то заданное время жизни сбрасываетсяmessage_send_ttl_seconds = нулевойНа этом этапе вы можете установить значение TTL в любом диапазоне от 12 часов до 30 дней, что соответствует настраиваемому диапазону для маркетинговых шаблонов, как указано в таблице выше.
    Видеть Категоризация шаблонов Для получения более подробной информации о категориях шаблонов сообщений WABA и связанных с ними рабочих процессах.
    
    
            
    
    
    

            
    
        
    
    
    

    
    

    
    
    
        
    
             Вернуться наверх