How to create and send a Carousel Template on WhatsApp

what is carousel the carousel templates allow you to send a single text message accompanied by a set of up to 10 carousel cards in a horizontally scrollable view components in the template message bubble a message bubble is required message bubbles are text only and support variables in it one carousel template can only have 1 generic message bubble present which can be used to explain the carousel cards and set the context it supports up to a maximum of 1024 characters carousel cards carousel templates support up to 10 carousel cards header cards must have a mandatory media header (image or video) card body text a card body bubble is required and is text only which supports variables it only supports up to a maximum of 160 characters in each card button it should at least have 1 button for each card it supports a maximum of up to 2 buttons for each card the button types supported are quick reply, website url cta & call phone number cta buttons can be the same type or a mix of quick reply buttons, phone number buttons, or url buttons for each card important note the template will be rejected if we fail to follow the above limitations of the carousel template note the media header format and button types must be the same across all cards that make up a carousel template media assets will be cropped to a wide ratio based on the customer's device the template will be rejected if we fail to follow the above limitations of the carousel template the carousel message template is only supported in the cloud apis create carousel template currently, carousel templates can only be created using the whatsapp template apis it is not supported on the exotel or meta templates dashboard create the template via support for non api users as meta has not made the carousel template creation available on their dashboard and is only supporting it to be created via apis, we are making it available to our customers in an easy way we at exotel are extending our support to make it available to all the customers who mostly rely on exotel or the meta template management dashboard to remove the api only roadblock you can simply raise a ticket to us with all the template message content and we will get this done for you in phase 1, we have limited the creation process via the support ticket customers not integrated with template apis or are not familiar with using the apis can seek assistance from the exotel support team they just need to raise a ticket with the details mentioned below let’s see the process quickly support request submission a support request needs to be raised via email to hello\@exotel in with the filled carousel template sheet attached email subject create the carousel template for waba id \<waba id> under \<account sid> sid sample body hi team, please help us create this carousel template for our account waba \<waba name> waba id \<waba id> api key \<api key> api token \<api token> subdomain \<subdomain> account sid \<sid> the message content is shared below attach the \<create carousel template filled sheet link> (with public access to the sheet) sample sheet please create a copy of this sheet create carousel template fill in all the details with the help of the sample provided in the sheet note please take help from your cx/account managers to fill in the details in the sheet in case of any difficulties or queries create the template via api direct api access things to follow to create the template via api you can access the create template apis from postman collection create carousel template apis developer documentation template apis you will need to have the api credentials to access the apis, get this from your exolite dashboard under the api credentials section exotel dashboard now you need to construct api requests, call the exotel apis, and create carousel templates on the correct waba and exolite accounts please refer to the sample request shared below or the working postman collection has a ready carousel template sample linked above in point 1 i get started use the create templates api to create & submit templates to whatsapp for approval the api supports both single and bulk creation post https //{{​authkey}} {{​authtoken}}@{{​subdomain}}/v2/accounts/{{​accountsid}}/templates?waba id= replace \<api key> and \<api token> with the api key and token created by you replace \<sid> with your “account sid" replace \<subdomain> with the region of your account \<subdomain> of singapore cluster is @api exotel com \<subdomain> of mumbai cluster is @api in exotel com \<api key>, \<api token>, \<subdomain>, and \<sid> are available in the api settings page of your exotel dashboard api key, api token, subdomain, & account sid the api details are present in the exotel account under the api credentials section login to your exotel account, go to the api settings page, and get all the required details as shown below on this page, you will find your \<your sid>, \<subdomain>, \<your api key>, and \<your api token> for the respective account and share it with the support team waba name & id the whatsapp business manager account name from the exotel messaging console or meta dashboard example request for create carousel template { "name" "summer carousel promo 2023", "language" "en us", "category" "marketing", "components" \[ { "type" "body", "text" "summer is here, and we have the freshest produce around! use code {{​1}} to get {{​2}} off your next order ", "example" { "body text" \[ \[ "15off", "15%" ] ] } }, { "type" "carousel", "cards" \[ { "components" \[ { "type" "header", "format" "image", "example" {​ "header handle" \[ "4 \ aw " ] } }, { "type" "body", "text" "rare lemons for unique cocktails use code {{​1}} to get {{​2}} off all produce ", "example" { "body text" \[ \[ "15off", "15%" ] ] } }, { "type" "buttons", "buttons" \[ { "type" "quick reply", "text" "send more like this" }, { "type" "url", "text" "buy now", "url" " https //www luckyshrub com/shop?promo={{​1 }}", "example" \[ " https //www luckyshrub com/shop?promo=summer lemons 2023 " ] } ] } ] }, { "components" \[ { "type" "header", "format" "image", "example" {​ "header handle" \[ "4 \ aw " ] } }, { "type" "body", "text" "exotic fruit for unique cocktails! use code {{​1}} to get {{​2}} off all exotic produce ", "example" { "body text" \[ \[ "20offexotic", "20%" ] ] } }, { "type" "buttons", "buttons" \[ { "type" "quick reply", "text" "send more like this" }, { "type" "url", "text" "buy now", "url" " https //www luckyshrub com/shop?promo={{​1 }}", "example" \[ " https //www luckyshrub com/shop?promo=exotic produce 2023 " ] } ] } ] } ] } ] } the above example helps you create a carousel template with a message bubble text with 2 variables followed up with 2 carousel cards with 2 buttons each quick reply & website cta you can refer to the api sample and construct your type of carousel message content with the help of the below body properties which explains each section and the parameter details with sample values body properties placeholder description example value \<bubble text> string required message bubble text string supports variables maximum 1024 characters summer is here, and we've got the freshest produce around! use code {{​1}} to get {{​2}} off your next order \<bubble text var example> array of strings required if the message bubble text string uses variables array of example variable strings number of strings must match the number of variables included in the string "15off","15%" \<card body text> string required card body text support variables maximum 160 characters rare lemons for unique cocktails use code {{​1}} to get {{​2}} off all produce \<card body text var example> array of strings required if using card body text with variables card body text example variables "15off","15%" \<card header format> enum required card media header format must be image or video image \<card header handle> media asset handle required uploaded media asset handle use the resumable upload api to generate an asset handle important please use the upload sample media api to generate an id and use that id to provide a sample header handle see carousel cards for media asset requirements 4 \ aw \<quick reply button text> string required if using a quick reply button quick reply button label text maximum 25 characters send more like this \<template category> enum required must be marketing or utility marketing \<template language> enum required template language and locale code en us \<template name> string required template name maximum 512 characters summer carousel promo 2023 \<url button text> string required if using a url button url button label text supports 1 variable 25 characters maximum buy now \<url button url> string required if using a url button url of website that loads in the device's default mobile web browser when the url button is tapped by the app user supports 1 variable, appended to the end of the url string maximum 2000 characters https //www luckyshrub com/shop?promo={{​1 }} \<url button var example> string required if using a url button url of website supports 1 variable if using a variable, add sample variable property to the end of the url string the url loads in the device's default mobile web browser when the customer taps the url button maximum 2000 characters https //www luckyshrub com/shop?promo=summer lemons 2023 preview template after creating the carousel template, you should be able to check the template preview before start sending the template the template will be available in the exotel whatsapp dashboard for the interactive preview and here is how you can navigate to see the preview you can log in to your exolite account and navigate to the whatsapp section from the lhs navigation bar go to the template section from the lhs navigation bar search for the provided template name and click on the edit icon on the right hand side this will open the message preview for the selected template please note that we do not support create and edit carousel templates on the console at the moment sending carousel templates now that the carousel templates are created using the apis, the customer should be able to send the templates there are 2 ways to send the carousel templates send via apis send via campaigns let’s try to understand how can a user send the carousel templates as explained below send via apis use the whatsapp business phone number to send a carousel template message using a carousel template with an approved status credentials use the create templates api to create & submit templates to whatsapp for approval the api supports both single and bulk creation post https //\<api key> \<api token>\<subdomain>/v2/accounts/\<sid>/messages replace \<api key> and \<your api token> with the api key and token created by you replace \<sid> with your “account sid" replace \<subdomain> with the region of your account \<subdomain> of singapore cluster is @api exotel com \<subdomain> of mumbai cluster is @api in exotel com \<api key>, \<api token>, and \<sid> are available in the api settings page of your exotel dashboard example request of sending carousel { "messaging product" "whatsapp", "recipient type" "individual", "to" "16505555555", "type" "template", "template" { "name" "summer carousel promo 2023", "language" {​ "code" "en us" }, "components" \[ { "type" "body", "parameters" \[ {​ "type" "text", "text" "20off" }, {​ "type" "text", "text" "20%" } ] }, { "type" "carousel", "cards" \[ { "card index" 0, "components" \[ { "type" "header", "parameters" \[ { "type" "image", "image" {​ "id" "24230790383178626" } } ] }, { "type" "body", "parameters" \[ {​ "type" "text", "text" "10off" }, {​ "type" "text", "text" "10%" } ] }, { "type" "button", "sub type" "quick reply", "index" "0", "parameters" \[ {​ "type" "payload", "payload" "59nqsd" } ] }, { "type" "button", "sub type" "url", "index" "1", "parameters" \[ { "type" "payload", "payload" "last chance 2023" } ] } ] }, { "card index" 1, "components" \[ { "type" "header", "parameters" \[ { "type" "image", "image" {​ "id" "1690627074790615" } } ] }, { "type" "body", "parameters" \[ {​ "type" "text", "text" "30off" }, {​ "type" "text", "text" "30%" } ] }, { "type" "button", "sub type" "quick reply", "index" "0", "parameters" \[ {​ "type" "payload", "payload" "7c4xhy" } ] }, { "type" "button", "sub type" "url", "index" "1", "parameters" \[ { "type" "payload", "payload" "summer blues 2023" } ] } ] } ] } ] } } body properties placeholder description example value \<bubble text variable> string required if the message bubble uses variables message bubble text variable there is no maximum character limit on this value, but counts against the message bubble limit of 1024 characters 20off \<button index> integer required zero indexed order in which button appears at the bottom of the template message 0 indicates the first button, 1 indicates second button, etc 0 \<card index> integer required zero indexed order in which card appears within the card carousel 0 indicates first card, 1 indicates second card, etc 0 \<card body variable> string required if card body text uses a variable card body text variable there is no maximum character limit on this value, but counts against the card body text limit of 160 characters 20off \<header asset id> media asset handle required uploaded media asset id 24230790383178626 \<quick reply button payload> string optional value to be included in messages webhooks (messages button payload) when the button is tapped 59nqsd \<template language code> enum required language and locale code of the template to be sent in the template message en us \<template name> string required name of the template to be sent in the template message summer carousel promo 2023 \<to> string required phone number of customer who the template message should be sent to 16505555555 \<url button payload> string required if the url button uses a variable url button variable value last chance 2023 send via campaigns after creating the template, you can send the carousel template using our campaign console which is explained below you need to log in to the exotel campaign console and click on create campaign provide all the basic information details on the first step and click on next on the second step of template selection, you will be able to see and search the carousel template name select the template and click on next you will land on the third step, configure your message section where you will have to provide all the variable and media details for all your cards present in that carousel once the variables are configured, you can proceed ahead and send the campaign by configuring the schedule you can see the campaign analytics after the campaign completion