Template Bypass using Business Manager

With the bypass template feature, you can create templates directly from the WhatsApp Business Manager website (BM) and use these templates through Kaleyra’s Send Message API to send messages to the end customers.

The Bypass Template functionality is an alternative way of creating and using templates for your communication over the kaleya.io WhatsApp channel. Of course, you can still create templates through Kaleyra APIs.

The Bypass Template feature supports the following four types of buttons in any template created through BM:

URL Buttons
Copy Code (Coupon) Button
Quick Reply Buttons
Phone Number Buttons

The following types of headers can be added to any of the templates:

Text
Image
Video
Document

📘
Note:
URL (Static or Dynamic), Phone Number, and Quick Reply can be bypassed only if the header value is set as none.

Prerequisites

Prerequisites for using the Bypass Template feature are:

Active Kaleyra.io account.
A WhatsApp business number.
A WhatsApp verified and approved profile.
Activated and verified WhatsApp Business Account (WABA).

Parameters and Data Types

Following is the list of parameters and data types that have been added to the sendMessage API:

Parameter	Data Type	Description	Example	Mandatory
`media_type`	String	This will hold the value indicating the type of media being attached while sending the message.	media_type: image/video/document	If used at the header level, then it is mandatory, else not.
`coupon_code`	String	This field will hold the text that needs to be copied when the COPY CODE button is clicked.	coupon_code: “250OFF”	If the template has a copy code, then it is mandatory.
`coupon_code_index`	Integer	This will hold the index/position of the COPY CODE button in the buttons array. (Indexing always starts from 0)	If the template has two buttons: PHONE_NUMBER, COPY_CODE, then coupon_code_index : 1 If the template has three buttons: PHONE_NUMBER, URL, COPY_CODE, then coupon_code_index : 2	If the template has a copy code, then it is mandatory.
`dynamic_url_index`	Integer	This will hold the index/position of the DYNAMIC URL button in the buttons array. (Indexing always starts from 0)	If the template has two buttons: URL(Dynamic), COPY_CODE, then dynamic_url_index : 0 If the template has three buttons: PHONE_NUMBER, URL(DYNAMIC), COPY_CODE, then dynamic_url_index : 1	If the template has a dynamic URL, then it is mandatory.
`quick_reply_buttons`	Integer	This will hold the number of QUICK_REPLY buttons in the template MAXIMUM - 3	If the template has three QUICK_REPLY buttons {"type":"QUICK_REPLY", "quick_reply1":"Yes", "quick_reply2":"No", "Quick_reply3":"NA" } quick_reply_buttons : 3	If the template has quick reply buttons, then it is mandatory.
`quick_reply_index`	Integer	This will hold the index/position of the QUICK REPLY button in the buttons array. (Indexing always starts from 0)	If the template has four buttons: URL(Dynamic), COPY_CODE, PHONE_NUMBER, QUICK_REPLY, then, quick_reply_index : 3 If the template has three buttons: QUICK_REPLY, URL(DYNAMIC), COPY_CODE, then quick_reply_index : 0	If the template has quick reply buttons, then it is mandatory.

📘
Note:
A maximum of one COPY_CODE button and one URL BUTTON(STATIC/DYNAMIC) per template are supported currently.

Sample Code

Following is the sample header text with one variable, body with one variable, coupon code as first button, dynamic URL as second button, phone number as third button, and quick reply as fourth button including one button count:

curl --location 'https://api.kaleyra.io/v1/HXINxxxxxxxxxx4IN/messages' \
--header 'api-key: A5afcxxxxxxxxxxxxxxx6cb1dc' \
--form 'to="91xxxxxxxx74"' \
--form 'type="mediatemplate"' \
--form 'template_name="textvar1bodyvar1_couponcode_dynamic_phone_quickreply1"' \
--form 'params="\"abc\""' \
--form 'channel="whatsapp"' \
--form 'from="+918xxxxxxx27"' \
--form 'callback_url="https://webhook.site/a2axxxxx-0c1d-xxxx-axxa-12d9xxxxxf70"' \
--form 'param_header="\"value\""' \
--form 'quick_reply_buttons="1"' \
--form 'param_url="images"' \
--form 'dynamic_url_index="1"' \
--form 'quick_reply_index="3"' \
--form 'coupon_code="\"250OFF\""' \
--form 'coupon_code_index="0"'

Updated 13 days ago