Developers     System Status    

Articles in this section

See more

Media Templates

Nikki Rosenberg
  • Updated
Follow

Media Messages allow you to send messages containing audio, documents and images to your customers. You can use Media Messages to enrich updates about bookings, payments, appointments, shipping etc. 

 

How do I register a Media Template?

If you are looking to send a Media Message this must first be registered as a Media Template. Depending on which onboarding route you took, you will need to take different steps to register a Media Template. On this page, you can see which onboarding route is applicable based on which steps you took: WhatsApp Business step-by-step onboarding

The classic onboarding route

Customers on this onboarding route are not able to register their own Media Templates at this time. Our team will be able to help you get set up with Media Templates. You can reach out to us on this page, providing the information requested here. 

The embedded onboarding route

Customers on the embedded onboarding route are able to register and manage their own Media Templates. Within your Facebook Business Manager, you can click on Business Settings in the bottom left corner.

From the left hand menu on the new page, select WhatsApp Accounts under Accounts. From here, you can click on Settings > WhatsApp Manager > Message Templates to manage your Templates, including your Media Templates, and create a new one. 

 

What does a Media Template look like? 

WhatsApp media templates have a 3-part structure:

  • The header (optional)
  • The body (required)
  • Buttons (optional)

unnamed.png

The Header 

The Header is optional and can be an image or a document. Currently video is not supported. 
pasted_image_0__10_.png

Images

When using an image, keep the following in mind:

  • The maximum size is 20 MB
  • The following types of images are supported: jpg, jpeg, png, gif

Document

When using a document, keep the following in mind:

  • The maximum size is 20 MB
  • A document header is only possible in .pdf format

The Body

The Body is required and supports only text and emojis. Keep the following in mind: 

  1. Please include parameter placeholders (e.g. {{1}}, {{2}}, etc. At least one {{1}}), as required. Make sure it contains no tabs, or more than 4 consecutive spaces. 
  2. The body can contain a maximum of 1028 characters
  3. All standard emojis are supported
  4. For formatting, please refer to the below:
    1. Bold: Place an asterisk on either side (*bold*)
    2. Italicise: Place an underscore on either side (_italic_)
    3. Strikethrough: Place a tilde on either side (~strikethrough~)
    4. Monospace: Place three backticks on either side (```monospace```)

Buttons 

Buttons are optional and can be Call to Actions and/or Quick Replies

Call To Action button options

    1. Call phone number

      pasted_image_0__11_.png

      For this type of button, you require:
      1. Button text (This is the text that will show on the button to call a number, e.g. "Call now". Up to 20 characters)
      2. Phone number

    2. Visit website

      pasted_image_0__12_.png

      For this type of button you require:
      1. This is the text that will show on the button to the url link e.g. "Visit our website!". Up to 20 characters
      2. Public website url

    3. Call phone number & visit website

      pasted_image_0__13_.png

      For this type of button, please check under 'Call phone number' & 'Visit website' above for the requirements.

Quick Replies

Quick replies allow you to suggest answers for your customer. You can create up to 3 buttons with a maximum of 20 characters each

pasted_image_0__14_.png

 

 

What information do I need to register a Media Template?

Please provide us with the following information when you reach out:

  • A name: The name of the Template Message has to be formatted in small letters only, and spaces need to be replaced with an underscore.
  • A body: Please provide us with the body of your template. 
  • Variable(s)/placeholder(s): The Template Message uses numbered placeholders '{{x}}' for each variable in the message. Each variable can be replaced with text that contains letters, digits, special characters, or spaces. 
  • Language: The language in which the template will be registered. When you send your Media Template, the language registered must match the language in your API call. 
  • Please also provide us with the media you would like to register

Note that at this stage, Media Templates are only available for use via the API or Flow Builder. Media Templates are not available in your template manager and you cannot use this in Inbox.

Related articles