Home » Use Cases

Send Instructional Videos over API

WhatsApp use case - Send Instructional Videos over API high-level overview

It’s all about helping your customers receive the right information in an easy to digest format. So why send how-to guides in PDF when you can simply share a short instructional video to your customers? People are busy and sometimes when they need things done, they don’t have the time to go through the 20+ pages of how-to guide.  

The idea is for your customers to quickly start using your services or products, as well as to use them with ease. Also, this is a great way to provide relevant information in a concise form—whether it’s an instructional video or video guide. 

This use case shows you how to send videos over API by using WhatsApp Media Message Templates.

Process Workflow

WhatsApp use case - Send Instructional Videos over API process workflow


Steps over API


Before you can start sending message templates, your template needs to be approved by WhatsApp. Once you create the instructions_video template and it has been approved by WhatsApp, you can reuse it and personalize it for other customers.

Template name

Template header

Template body




Media - Video

Your registration has been successful. Check out this instructional video on how to start using our service 😊


To send an instructional video as a WhatsApp media message template, follow the instructions below:  

1. Log in to the Infobip API Developer Hub and copy your base URL. 

(e.g., your personal base URL is: https://{{BASE_URL}}.api.infobip.com/) 



The personal BASE URL is a simple way to identify who sent out the API request. This means we can identify the request through DNS and then find the optimal route for API requests. 

2. Open Postman (or a similar tool) and choose the POST method. 

3. Replace endpoint with https://{{BASE_URL}}.api.infobip.com/omni/1/advanced 

4. Add the Authorization header. 

For example, Basic: Base64 encoded username and password  

Learn more about Security and Authorization methods on the Infobip API Developer Hub. 

5. Copy the scenarioKey you previously created.

Learn more about Creating a scenario. 

6. Specify the destinationphoneNumberyou wish to send the notification to. 

7. Replace the templateName, templateData, and language fields with registered ones (refer to the table above).   

The  videoUrl  field contains the video URL, while the placeholders in the template body are contained in the  placeholders field.

POST /omni/1/advanced HTTP/1.1 
Host: {base_url}
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== 
Content-Type: application/json 
    "scenarioKey": "CC9F01A5DC7BEE2C2B829D203482A654",
    "destinations": [
            "to": {
                "phoneNumber": "41793026727"
    "whatsApp": {
        "templateName": "instruction_video",
        "mediaTemplateData": {
		"header": {
		  "videoUrl": "https://www.filehostserver.com/instructions_video.mp4"
		"body": {
			"placeholders": []
        "language": "en"

Refer to these related WhatsApp use cases for additional ideas what you can send with media message templates:

Related Products

Communicate with your customers over the world’s most used Chat app