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