> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.textit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Using WhatsApp

You can integrate a WhatsApp channel with TextIt using a provider such as [Twilio](https://www.twilio.com/en-us/messaging/channels/whatsapp) and [360Dialog](https://360dialog.com/).

### Using Message Templates

WhatsApp providers require templates in order to send messages outside of the 24-hour communication window. For that to work, TextIt syncs those templates so you can configure them in your flow. You must get your templates *approved* by your provider to use them. 

![](https://storage.crisp.chat/users/helpdesk/website/-/7/a/9/f/7a9fc4558a9de000/screenshot-2026-04-22-at-24044_6qy1m6.png =800x583)

You can find all your approved message templates under 'Messages'. If a recently approved template does not appear here, you can hit 'refresh' in the upper-right hand corner of the templates page. Template Approval from Meta can usually take anywhere from a few minutes to 24 hours. 

![](https://storage.crisp.chat/users/helpdesk/website/-/7/a/9/f/7a9fc4558a9de000/screenshot-2026-04-22-at-25014_3pminc.png =300x413)

### Twilio Message Templates

Twilio's implementation for WhatsApp is different than other providers. They do not allow for specification or syncing of templates. Instead, they try to match the messages dynamically. To use templates, you need to have your outbound message in TextIt match an approved template in your Twilio account rather than syncing/specifying it. 

In your first outgoing flow message, use the text of an approved template word for word. It is important that your message match the text of your template as closely as possible, otherwise your messages will fail to send outside of the 24-hr window. 

### Buttons with WhatsApp Templates

You can already send a message with interactive buttons, also called [Quick Replies](https://help.textit.com/en/article/adding-quick-replies-to-your-messages-tt2zy7/). Now, we've added this feature to WhatsApp templates. Whether it's directing users to specific actions or gathering feedback easily, these buttons add another dimension to your communication strategy.

Take note that buttons have a maximum character limit of 20.

### Attachments

Add a professional touch by framing your attachments with personalized headers and footers with quick replies, ensuring clarity in every interaction.

![](https://storage.crisp.chat/users/helpdesk/website/7a9fc4558a9de000/wa-attachment_ez0dvu.png)

* The header is where you can attach documents, images, or videos.

* The body is where you can send the content of your message (1024 characters). The body can also include variables you've already saved for your contacts, such as their name.

* The footer supports 60 characters and Quick Replies are shown underneath it.

### Sending Stickers and GIFs

* To send stickers via the API, the file type should be `image/webp` and the size must be less than 512x512 and less than 100KB for static or 500KB for animated stickers.

* GIF images are not a media format supported for WhatsApp API.

[Here](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types) is a list of all supported media formats for WhatsApp. 

### Template Languages

If you are using WhatsApp templates, you'll need to make sure to create those templates with the correct languages so that they map correctly to the languages in your account. See more information [here](https://help.textit.com/en/article/whatsapp-template-languages-1dagngu/).

### WhatsApp BSUID

Your WhatsApp contacts may now include a new `bsuid:` **URN**. This is a Business System User ID provided by Meta and represents a more stable identifier for a contact than a phone number.

* **Business Specific:** These IDs are unique to your business; a BSUID from one account cannot be moved or used in a different business's account.
* **Format:** You can recognize these identifiers by their fixed structure: they start with a **two-letter country code** followed by a **long alphanumeric string** (e.g., `US.1a2b3c4d5e...`).
**TextIt** is designed to handle this transition automatically. When a BSUID becomes available, it is added to the contact profile as a new URN with no manual action required. Learn more [here](https://help.textit.com/en/article/whatsapp-contact-identity-changes-bsuid-1ovx50i/).
