To send WhatsApp messages that include media, it's necessary to:

• Have a message template pre-approved by Meta within Zenvia Customer Cloud.
• Provide a media link during the setup of the message.

⚠️ Attention: This feature is available only for users with the Operator and Admin profiles.

Template registration

Go to Settings > Message templates > WhatsApp > Create new template. Fill in the information for each step:

Settings

Give a name to the template, select the category, language, and phone number. Finally, enter an email to be notified when your template is reviewed by the WhatsApp team.

Message Type

To create templates with media files, select the option Message with header, media, footer, and button.

Template Content

The header text can include text, image, document, or video.

Accepted formats and sizes for template creation are:

• Document: PDF - up to 100MB;
• Image: JPEG and PNG - up to 5MB;
• Video: MP4 - up to 16MB.

Media sending occurs during the message setup. To create the template, simply select the media model to be attached.

⚠️ Attention: The sent media template is not the same as the one you need to use in your messages; it's just a submission template you are presenting to Meta. Check the Accepted Media Types table to know the media files and formats that can be used when sending the message.

Message Body is the content of the message and may contain variables; the Footer is optional and cannot contain variables; and Buttons can be Call to Action (CTA) or Quick Reply.

For detailed information on creating and sending templates for approval, check the article How to register templates for WhatsApp.

With an approved template, the next step is to configure the WhatsApp message setup.

Sending a message with media file

Go to Message broadcast > Broadcast and automation > WhatsApp.

Fill in the information for each step:

Create

Give a name to the dispatch and then select the phone number. It must be the same number selected during registration. Templates registered under this number are automatically displayed.

Set

Add recipients. You can use a contact list or import a CSV file.

Media sending options:

1. Using the Contact List:
   • Different media for each contact: Ensure your contact list has a column with the public and direct URL for each media file. The media variables in the template (e.g., {{videoUrl}}) must correspond to the columns in the contact list with the URLs.
   • Same media for all contacts: Insert the public media URL as a fixed field in the template. All selected contacts (by list, individually, or by segment) will receive the same media.
2. Importing a CSV file:
   • Different media for each contact: In the .csv file, include at least two columns: one for the phone number and another for the public media URL. Each contact will receive the media specified by the respective link.
   • Same media for all contacts: The file does not need to include the media URL column. When mapping variables, choose the Fixed Field option for the media and add the public URL. This way, the same media will be sent to all contacts.

Accepted media types

Then, associate the variables with their respective fields. Regardless of how the recipients were defined, if a message has a variable, it is necessary to select what each field in the table represents.

In the example, see a message template that uses a video with the variable {{videoUrl}}. In the .csv file, the structure is as follows:

During the import, you should:

1. Associate the phone column with the phone field value;
2. Associate the videoUrl column with the {{videoUrl}} field value.

Summary

In the summary of the dispatch, there is an illustrative preview of the message. The media file appears in link format, so make sure it is public.

Select the dispatch method, and you're done! Your media message will be sent.