{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Products","product_name":"Engage Studio","type":"markdown"},"seo":{"title":"Troubleshoot SMS Delivery in Engage Studio","description":"Diagnose common SMS campaign, sender, audience, quiet-hours, link, and delivery-event problems in Engage Studio.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshoot-sms-delivery","__idx":0},"children":["Troubleshoot SMS Delivery"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this page when an SMS campaign cannot launch, recipients are missing, messages are blocked, or delivery and click events do not look as expected. Start with the symptom that matches your issue, then follow the linked setup or reference page for the full behavior."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-sms-sender-is-not-available","__idx":1},"children":["The SMS Sender Is Not Available"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm that a short code has been provisioned by Treasure AI and assigned to the workspace. Sender provisioning is a supported setup process, not a self-service action in the campaign editor."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/set-up-sms-sending"},"children":["Set Up SMS Sending"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recipients-are-missing-from-the-audience","__idx":2},"children":["Recipients Are Missing from the Audience"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Parent Segment contains a phone-number column."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Phone numbers use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.twilio.com/articles/1260803420489"},"children":["E.164 format"]},", such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+12125551234"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Target Segment is the intended audience."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your consent and opt-out filters do not exclude the recipient unexpectedly."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/sms-message-requirements"},"children":["SMS Message Requirements and Limits"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/manage-sms-consent-and-opt-outs"},"children":["Manage SMS Consent and Opt-Outs"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"messages-are-recorded-as-quiet_hours_blocked","__idx":3},"children":["Messages Are Recorded as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quiet_hours_blocked"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The campaign attempted to send outside its configured delivery window. Engage Studio does not retry these messages automatically. Correct the audience segmentation or delivery window, then launch a new campaign."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/configure-sms-delivery-windows"},"children":["Configure SMS Delivery Windows"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-message-uses-more-segments-than-expected","__idx":4},"children":["The Message Uses More Segments Than Expected"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review the message text, Liquid values, UTM parameters, and destination URLs. Unicode characters, including many emojis, reduce the characters available per segment. A longer message uses more segments and increases delivery cost."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/sms-message-requirements"},"children":["SMS Message Requirements and Limits"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/add-utm-tracking-to-sms-campaigns"},"children":["Add UTM Tracking to SMS Campaigns"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-url-was-not-shortened","__idx":5},"children":["The URL Was Not Shortened"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm that:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Workspace ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SMS links click tracking"]}," is enabled."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The campaign-level ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use TD shortened URL"]}," setting is enabled."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The URL uses HTTPS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The URL is not malformed, longer than 2,048 characters, a localhost URL, or already a Treasure AI short-link URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The message contains no more than five eligible URLs."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/shorten-links-in-sms-campaigns"},"children":["Shorten Links in SMS Campaigns"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"click-events-are-missing","__idx":6},"children":["Click Events Are Missing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click events require a shortened URL. Confirm that the workspace setting and campaign-level shortening setting were enabled before the campaign was sent, and that the recipient selected the shortened link rather than an unchanged full-length URL."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click events are processed asynchronously, so they may not appear immediately. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/track-clicks-in-sms-campaigns"},"children":["Track Clicks in SMS Campaigns"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-events-are-missing-or-unexpected","__idx":7},"children":["Delivery Events Are Missing or Unexpected"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the appropriate table in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_sms_<workspace_id>"]}," database:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]}," contains post-send delivery statuses and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quiet_hours_blocked"]}," records."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_events"]}," contains failures before acceptance by Twilio or after delivery retries are exhausted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_events"]}," contains STOP and START events."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/view-sms-delivery-events"},"children":["View SMS Delivery Events"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-pages","__idx":8},"children":["Related Pages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/create-sms-campaign"},"children":["Create an SMS Campaign"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/set-up-sms-sending"},"children":["Set Up SMS Sending"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/sms/manage-sms-consent-and-opt-outs"},"children":["Manage SMS Consent and Opt-Outs"]}]}]}]},"headings":[{"value":"Troubleshoot SMS Delivery","id":"troubleshoot-sms-delivery","depth":1},{"value":"The SMS Sender Is Not Available","id":"the-sms-sender-is-not-available","depth":2},{"value":"Recipients Are Missing from the Audience","id":"recipients-are-missing-from-the-audience","depth":2},{"value":"Messages Are Recorded as quiet_hours_blocked","id":"messages-are-recorded-as-quiet_hours_blocked","depth":2},{"value":"The Message Uses More Segments Than Expected","id":"the-message-uses-more-segments-than-expected","depth":2},{"value":"The URL Was Not Shortened","id":"the-url-was-not-shortened","depth":2},{"value":"Click Events Are Missing","id":"click-events-are-missing","depth":2},{"value":"Delivery Events Are Missing or Unexpected","id":"delivery-events-are-missing-or-unexpected","depth":2},{"value":"Related Pages","id":"related-pages","depth":2}],"frontmatter":{"seo":{"title":"Troubleshoot SMS Delivery in Engage Studio","description":"Diagnose common SMS campaign, sender, audience, quiet-hours, link, and delivery-event problems in Engage Studio."}},"lastModified":"2026-09-21T16:07:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/marketing-cloud/engage-studio/channels/sms/troubleshoot-sms-delivery","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}