FAQs and Troubleshooting
If you encounter issues with Content Templates, use the following diagnostic tips to resolve common problems.
- 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.
See the WhatsApp Message Template Approvals & Statuses article for a summary of the WhatsApp template approval guidelines and common rejections reasons.
Use the following formatting options when inputting a string:
~strikethrough~***bold***italics*
Yes.
- On macOS, press
Control+Command+Spaceto open the emoji picker. - On Windows, press
Windows+;(semicolon) orWindows+.(period).
Press Enter or Return to start a new line, just as you would in a text editor.
No. Each Content Template supports only one language.
URLs must be valid, publicly accessible, and not contain whitespace characters. For WhatsApp, the URL up to the domain name must be static.
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. This is a manual task and will be serviced on a first come, first served basis.
Make a GET request to the following endpoint: https://content.twilio.com/v1/Content?PageSize=1000 (adjust page size as needed).
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:
1curl -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
- 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.