API Variables
Request Variables
You need to use below variables to request a new WhatsApp Template
Request URL
Method : POST
Variable
Date Type
Description
Required
token
string
Unique token for the project
Mandatory
message_type
numeric
Specify the message type, in the document only PDF is supported
1 = Text
2 = Image (.jpg, .jpeg, .png)
3 = Document (.pdf)
4 = Video
Mandatory
category
numeric
Specify the the category which the message belongs to , please make sure you pass the correct category based on your nature of business.
12=TRANSACTIONAL
13=MARKETING
14=OTP
Mandatory
name
string
Template name. Can only contain lowercase alphanumeric characters and underscores ( _ ). No other characters or white space are allowed. Template name can't duplicate
Mandatory
sample_message
array
Sample value of the dynamic content you use in array
Optional (But recommended for speedy approval)
sample_button_value
string
Sample value of the dynamic url in the call to action button
Optional (But recommended for speedy approval)
sample_url
string
Sample Public Media URL of the media you are going to send
Optional (But recommended for speedy approval)
messages
Array
This is an array in which you need to pass the message and language , you can pass multiple messages by specifying the language
Mandatory
message
string
Message content with dynamic variable starting from {{1}}
Text Template maximum character limit is 1024
For Media template maximum character limit is 160.
Mandatory
language
string
Object through which you can pass multiple number and its personalised message
Mandatory
header
string
If you wish to add a header then please pass here, only 60 character allowed and supports one dynamic variable Make sure the dynamic variable value not exceeds the 60 characters limit of the header when sending message
Optional
footer
string
Pass the footer text here maximum 60 characters and dynamic value not supported
Optional
buttons
array
Array contains of WhatsApp Interactive Buttons Values
Optional
type
numeric
This is the type of button to be requested
1 = Quick Reply
2 = URL
3 = Phone Number
Mandatory for buttons
text
string
Button Text Name
1) Maximum 20 characters allowed
Not possible to change once its approved
Mandatory for buttons
url
url
Website URL should pass
Must have {{1}} at the end of the URL like https://pickyassist.com/t/{{1}}
Only one dynamic variable is allowed and its should be at the end of the URL
Not possible to change once its approved
Mandatory if type=2
phone_number
string
Phone Number which needs to be dialed when clicking the Call to Action button
Not possible to change once its approved
Mandatory if type=3
Response Variables
Variable
Description
template_id
Alpha numeric unique template id , this template id need to pass when sending templated messages
template_status
Status of the Templates,
1 = Pending Review
2 = WA Pending Review
3 = Approved
4 = Rejected
category
Category of the template
1 = ACCOUNT_UPDATE
2 = PAYMENT_UPDATE
3 = PERSONAL_FINANCE_UPDATE
4 = SHIPPING_UPDATE
5 = RESERVATION_UPDATE
6 = ISSUE_RESOLUTION
7 = APPOINTMENT_UPDATE
8 = TRANSPORTATION_UPDATE
9 = TICKET_UPDATE
10 = ALERT_UPDATE
11 = AUTO_REPLY
message_type
Message type
1 = Text
2 = Image (.jpg, .jpeg, .png)
3 = Document (.pdf) 4= Video
header
Header text of the template only applicable for document templates
footer
Footer of the template only applicable for media templates
template_name
Name of the template you requested
templates
This is an array presents only if you are not passing the template id
template_message
This is an array which gives template message and language
message = template message language = language of the template
status
100=>’Success’, 401=>Authentication Failed 801=>Official WhatsApp Account Not Active 405=>API Is Not Active For This Plan 804=>Invalid Template ID
817=>No Templates Found
883 => Sample Message not matched with the Count of the Dynamic Variable 884 => Sample Values are Mandatory For All Dynamic Variables And Media 885 => Header Is Missing 886 => Footer Is Missing
887 => 'Only One Dynamic Variable Allowed In Header'
888 => 'Header Parameters Count Not Matching'
message
Detailed Status Message (description of any error message)
Last updated