{"id":504,"date":"2025-05-11T13:16:52","date_gmt":"2025-05-11T13:16:52","guid":{"rendered":"https:\/\/smppcenter.com\/journal\/?p=504"},"modified":"2025-05-30T12:00:59","modified_gmt":"2025-05-30T12:00:59","slug":"whatsapp-business-api-templates-understanding-time-to-live-ttl","status":"publish","type":"post","link":"https:\/\/smppcenter.com\/journal\/whatsapp-business-api-templates-understanding-time-to-live-ttl\/","title":{"rendered":"\u23f3 WhatsApp Business API Templates: Understanding Time-To-Live (TTL)"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

In the world of real-time communication, timing is everything. Whether you\u2019re sending a one-time password (OTP), a shipment update, or a limited-time offer, it\u2019s critical that your message reaches your customer while it\u2019s still relevant. This is where Time-To-Live (TTL) in WhatsApp Business API<\/a><\/strong> templates becomes important.<\/p>\n\n\n\n

\"WhatsApp<\/figure>\n\n\n\n

\u2e3b<\/p>\n\n\n\n

\u2705 What is TTL?<\/h2>\n\n\n\n

TTL, or Time-To-Live, refers to the duration WhatsApp will keep retrying to deliver a message to a user who is temporarily unreachable (for example, if their phone is off or they are out of network coverage). If the message is not delivered within this TTL window, it is dropped and will not be delivered later.<\/p>\n\n\n\n

In technical terms, TTL is also referred to as the message validity period.<\/p>\n\n\n\n

\u2e3b<\/p>\n\n\n\n

\ud83d\udd27 Why is TTL Important?<\/h2>\n\n\n\n

Setting a suitable TTL ensures:
\u2022 Customers don\u2019t receive outdated or irrelevant messages.
\u2022 OTPs and other authentication messages are only delivered when the code is still valid.
\u2022 You avoid confusion and improve the user experience by sending timely information.<\/p>\n\n\n\n

\u2e3b<\/p>\n\n\n\n

\ud83d\udcca TTL Defaults, Limits, and Compatibility<\/h2>\n\n\n\n

Here\u2019s a quick breakdown of TTL behavior by template type:<\/p>\n\n\n\n

Template Type<\/th>Default TTL<\/th>Customizable Range<\/th>API Compatibility<\/th><\/tr><\/thead>
Authentication<\/td>10 minutes<\/td>30 seconds \u2013 15 minutes<\/td>Cloud API + On-Premise API<\/td><\/tr>
Utility<\/td>30 days<\/td>30 seconds \u2013 12 hours<\/td>Cloud API only<\/td><\/tr>
Marketing<\/td>30 days<\/td>12 hours \u2013 30 days<\/td>Marketing Messages (MM) Lite API<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

\ud83d\uded1 Note: Authentication templates created before October 23, 2024, default to a 30-day TTL unless explicitly updated.<\/p>\n\n\n\n

\u2e3b<\/p>\n\n\n\n

\u270d\ufe0f How to Set or Update TTL<\/h2>\n\n\n\n

To customize TTL, include the message_send_ttl_seconds parameter when creating or editing a template from the UI.
\u2022 TTL is defined in seconds
\u2022 You can use 1-second increments for fine-grained control
\u2022 TTL can be updated even on existing templates<\/p>\n\n\n\n

\ud83d\udd22 Valid Ranges by Template Type:<\/strong>
\u2022 Authentication: 30 to 900 seconds (30 seconds to 15 minutes)
\u2022 Utility: 30 to 43,200 seconds (30 seconds to 12 hours)
\u2022 Marketing: 43,200 to 2,592,000 seconds (12 hours to 30 days)<\/p>\n\n\n\n

\u2e3b<\/p>\n\n\n\n

\ud83d\udcc9 What Happens When TTL Expires?<\/h2>\n\n\n\n

If a message cannot be delivered within the defined TTL:
\u2022 It is dropped (not delivered at all).
\u2022 You will not receive a messages.delivered webhook.
\u2022 There may be a small delay in receiving the final webhook confirming the drop, so it\u2019s good practice to include a slight buffer in your application logic.<\/p>\n\n\n\n

\u2e3b<\/p>\n\n\n\n

\ud83c\udfaf Best Practices<\/h3>\n\n\n\n
\u2022   Always set a custom TTL for authentication templates, and match or stay below your OTP\/code expiration time.\n\u2022   Use short TTLs for critical utility updates like payment or delivery alerts.\n\u2022   For marketing messages, consider your campaign duration and user engagement window before setting TTL.<\/code><\/pre>\n\n\n\n
\u2e3b<\/p>\n\n\n\n
\ud83d\udcec In Summary<\/h3>\n\n\n\n
Feature<\/th>Benefit<\/th><\/tr><\/thead>
Customizable TTL<\/td>Fine-tune delivery windows by template type<\/td><\/tr>
Prevents Irrelevance<\/td>Messages dropped if no longer timely<\/td><\/tr>
Flexible Integration<\/td>1-second granularity and API-based config<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Using TTL smartly ensures your WhatsApp messages are timely, relevant, and effective\u2014helping you build trust and deliver a better experience to your users.<\/p>\n\n\n\n
\u2e3b<\/p>\n\n\n\n
\n
Read More Content:<\/strong><\/p>\n\n\n\n
\u2705 New Feature Announcement: \u201cAccept Terms Checkbox\u201d in Signup Form<\/a><\/p>\n\n\n\n
\ud83c\udd95 SMPPCenter Version 7.1 Feature Release: Consolidated Admin Alerts for Tracking New User Signups<\/a><\/p>\n\n\n\n
\ud83c\udd95 Feature Release: Append Text Action for Enhanced Message Customization<\/a><\/p>\n\n\n\n
New Feature Release: Random Replace Rule in Normalization for Dynamic Messaging<\/a><\/p>\n\n\n\n
\ud83c\udd95 Introducing Dashboard Notification for Resellers \u2013 Coming in Version 7.0!<\/a><\/p>\n\n\n\n
\ud83c\udf89 Introducing Contact Form Integration in Version 7.0<\/a><\/p>\n<\/blockquote>\n","protected":false},"excerpt":{"rendered":"
In the world of real-time communication, timing is everything. Whether you\u2019re sending a one-time password (OTP), a shipment update, or a limited-time offer, it\u2019s critical that your message reaches your customer while it\u2019s still relevant. This is where Time-To-Live (TTL) in WhatsApp Business API templates becomes important. \u2e3b \u2705 What is TTL? TTL, or Time-To-Live, […]<\/p>\n","protected":false},"author":1,"featured_media":510,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[326,325,5,328,327,323,321,320,45,47,83,317,318,319,324,81,329,322],"class_list":["post-504","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-general","tag-api-integration","tag-authentication-messages","tag-bulk-sms","tag-dlt-compliance","tag-marketing-messages","tag-message-validity","tag-otp-delivery","tag-real-time-communication","tag-smpp-application","tag-smpp-sms","tag-sms-marketing","tag-smsgatewaycenter","tag-time-to-live","tag-ttl-in-messaging","tag-utility-messages","tag-whatsapp-business-api","tag-whatsapp-campaigns","tag-whatsapp-templates"],"_links":{"self":[{"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/posts\/504","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/comments?post=504"}],"version-history":[{"count":0,"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/posts\/504\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/media\/510"}],"wp:attachment":[{"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/media?parent=504"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/categories?post=504"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/smppcenter.com\/journal\/wp-json\/wp\/v2\/tags?post=504"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}