API Variables

Request Variables

You need to use below variables to request a new WhatsApp Template

Request URL

Method : POST

https://pickyassist.com/app/api/v2/template-request

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