Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

FAQs and Troubleshooting


If you encounter issues with Content Templates, use the following diagnostic tips to resolve common problems.


FAQs

faqs page anchor

Common terms and definitions

common-terms-and-definitions page anchor
  • Content SID: The unique SID that identifies a content template. A Content SID can be used only by asingle Twilio Account SID. It is a 34-character string that starts with HX.
  • Content variables: The variables used to substitute in values at run time. Variable samples are typically required at creation if a template has variables.
  • Content types: Twilio's omnichannel representation of rich content. Most content types can be used across channels without customization. In a few cases, components that a content type defines for one channel make the template incompatible with another channel that normally supports the type.

My template was submitted to WhatsApp and rejected. What should I do?

my-template-was-submitted-to-whatsapp-and-rejected-what-should-i-do page anchor

See the WhatsApp Message Template Approvals & Statuses article for a summary of the WhatsApp template approval guidelines and common rejections reasons.

How can I format text?

how-can-i-format-text page anchor

Use the following formatting options when inputting a string:

  • ~strikethrough~
  • ***bold**
  • *italics*

Yes.

  • On macOS, press Control + Command + Space to open the emoji picker.
  • On Windows, press Windows + ; (semicolon) or Windows + . (period).

How do I use a newline in my templates?

how-do-i-use-a-newline-in-my-templates page anchor

Press Enter or Return to start a new line, just as you would in a text editor.

Can I include multiple languages in a single template?

can-i-include-multiple-languages-in-a-single-template page anchor

No. Each Content Template supports only one language.

Are there any limitations around URLs?

are-there-any-limitations-around-urls page anchor

URLs must be valid, publicly accessible, and not contain whitespace characters. For WhatsApp, the URL up to the domain name must be static.

Do templates created in the "WhatsApp Templates" area of Console appear within the Content Editor and API?

do-templates-created-in-the-whatsapp-templates-area-of-console-appear-within-the-content-editor-and-api page anchor

Templates created in the Console under WhatsApp Templates are incompatible with templates created using the Content API or Content Editor, known as "Content Templates". Only Content Templates can be sent using the ContentSid and ContentVariables parameters.

You can request to have your existing WhatsApp Templates duplicated and converted to Content Templates by contacting Twilio Support(link takes you to an external page). This is a manual task and will be serviced on a first come, first served basis.

Can I still use my previously created twilio/buttons now that they've been deprecated?

can-i-still-use-my-previously-created-twiliobuttons-now-that-theyve-been-deprecated page anchor

Yes, twilio/buttons that were previously created will still continue to work on WhatsApp and FBM. However, we encourage you to create new twilio/call-to-action and twilio/quick-reply templates to take advantage of template delivery on future channels as they become available. twilio/buttons templates will not support future channels.

How do I see all templates?

how-do-i-see-all-templates page anchor

Make a GET request to the following endpoint: https://content.twilio.com/v1/Content?PageSize=1000 (adjust page size as needed).

Can I use the Content Templates without adding senders to a sender pool or specifying a Messaging Service in the From field?

can-i-use-the-content-templates-without-adding-senders-to-a-sender-pool-or-specifying-a-messaging-service-in-the-from-field page anchor

Yes, you can instead specify a MessagingServiceSid field and a WhatsApp sender From field in the Twilio Programmable Messaging send request. With this workaround, the WhatsApp Sender does not need to be in the Messaging Service sender pool and a unique From can be used for each message. However, a Messaging Service must still be created and specified in the Programmable Messaging request. An example send request would be structured as follows:

1
curl -X POST https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXX/Messages \
2
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN \
3
-H 'Content-Type: application/x-www-form-urlencoded' \
4
-d "To=whatsapp:+15551234567" \
5
-d "MessagingServiceSid=MGXXXXXXXXXXXXXXXXXXX" \
6
-d "From=whatsapp:+15559991111" \
7
-d "ContentSid=HXXXXXXXXXXXXXXXXXXX" \
8
-d 'ContentVariables={"1":"ABC123"}'
9

Limitations of the Content API

limitations-of-the-content-api page anchor
  • Personally identifiable information (PII): PII is not supported in Content API templates. However, PII can be passed in content variable parameters sent via the Programmable Messaging API.
  • Templates limits: The Content API supports an unlimited number of templates, however, WhatsApp limits users to 6000 approved templates.
  • List: The top-most heading in list are not independently configurable.
  • Media: Media hosted on Google Drive is not supported. Google Drive links render a preview page rather than the media file itself. The Content API requires a media URL that resolves directly to the image so that it can download the file during sample submission.