Inserting an image in the message header when creating the template
When you create a new template, you can define an image header. This image needs to be a .jpg, .png or .gif file that has to be publicly accessible from the web, and the link pointing to it mus start with https://.
WhatsApp templates created with our app
If you create the template using our app, you have the option to upload an image for the header (under Advanced Settings). This image will be publicly accessible from the web from an https:// link, and therefore usable in any WhatsApp template.
This image you upload when you create your template acts as a default; if you do not specify an image when sending your WhatsApp messages, that is the image that will be used.
WhatsApp templates created from the WhatsApp Administrator at the Facebook for Business website
You can also define a multimedia header when you define your template in the Facebook for Business (Meta) website:
Please note that the file you are asked to upload when creating the template is just an example; it will not be used as default.
If the image you want to send is accessible from the Internet, you will need the URL to that image. Besides being publicly available, that URL needs to start with https://, and it must point to a .jgp, .png or .gif file. The maximum size is 5MB.
Bear in mind that all images will be resized to 1120px wide by WhatsApp.
Sending single notifications with an image
If you want to send single notifications with images, you need to:
- Select the header type: Image (.jgp, .png, .gif)
- Enter the header link: the value copied from the file upload, which will be at our server, or a valid URL of an image hosted elsewhere.
If you created the template using our app, when you select the template, the Link to resource will be pre-filled for you. You can change this link if you need to.
More information about sending notifications using Single Notifications here.
Sending notifications with images from an Excel or CSV file
If your Facebook template includes an image in the header, you need to specify it in the file. In column ri_header_type, specify "image", and in column ri_header_link, specify the URL of the link.
If you used a template when you created your campaign, and you leave the ri_header_type and ri_header_link blank, the link specified in the template will be used by default.
More information about sending notifications using Excel or CSV files here.
Sending a notification with an image header from a Zendesk trigger or by calling the API
If your Facebook template includes a pdf header, you must specify it in the your triggers, by adding the following parameters to the POST request:
- ri_header_type: "image"
- ri_header_link: Publicly available URL of the image, starting with https://
You can upload files to or server from the Media section, and then get their publicly available links from there to be used at the ri_header_link parameter, by clicking on the copy to clipboard button:
More information about using triggers here. You can find the technical documentation of our API here.
Sending a notification with an image from the ticket sidebar
If your Facebook template includes an image in the header, you must specify it in the form:
Leveraging templates
No matter the way you send your notifications, using our app to create templates can help avoid errors and make your workflows safer and faster.
When you create a template, you can specify the header type and link of that template. If you do, those values will be used as default, so:
- When sending single notifications, from the app or from the ticket sidebar, the header values will be prefilled with what you entered in the template.
- When uploading files and using triggers, if no header link is present, it will be used the one from the template. Therefore you don“t need to include them every time, only when they change.
More information about templates here.