Profile`s About section.

Address of the business

Description of the business. Max 256 characters

Business email

Linked phone number

Industry of the business

Main message text

Header will be located above message text

Footer will be placed under message text

Action for open list

Up to 10 sections from which the client can choose.

Each section is object with fields:

title - Title of section, up to 24 symbols. Required if there are more then 1 section

rows - available options. Required

Each option is object with fields:

id - Unique id for option, up to 200 symbols. Required

title - Title of option, up to 24 symbols. Required

description - Description of option, up to 72 symbols

Example:

[{"title":"Section 1","rows":[{"id":"1","title":"Option 1","description":"Description 1"}]},{"title":"Section 2","rows":[{"id":"2","title":"Option 2","description":"Description 2"}]}]

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

Main message text

Footer will be placed under message text

Up to 3 sections inclusive.

Each section is an object with a fields:

type - always "reply" Required

reply – reply button objects Required

Each button response is an object with fields:

id - a unique identifier of the button, up to 200 characters. Required

title — Button title, up to 20 characters. Required

Example:

"sections": [{"type": "reply","reply": {"id ": "1","title": "1 Button's Title"}},{"type": "reply", "reply": {"id": "2", "title": "2 Button's Title"}}]

Quoted message ID (Cloud API)

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

Message text, UTF-8 or UTF-16 string with emoji 🍏. Can be used with mentionedPhones, example: this text for @556123122026

Quoted message ID (Cloud API)

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

One emoji to add/update or empty string to remove

Quoted message ID (Cloud API)

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

HTTP link https://...

Or base64-encoded file with mime data, for example data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...

File in form-data input field

File name, for example 1.jpg or hello.xlsx

Text under the file. When sending an image сan be used with mentionedPhones, example: this image for @556123122026

Quoted message ID (Cloud API)

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

Message text, UTF-8 or UTF-16 string with emoji 🍏. Can be used with mentionedPhones, example: this text for @556123122026

Quoted message ID (Cloud API)

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

Latitude of the location. Example: 45.018337

Longitude of the location. Example: -73.968285

Address of the location. Only displayed if name is present. Example: 9766 Valley View St., New York, NY 10024

Name of the location. Example: Facebook HQ

Quoted message ID (Cloud API)

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

Array containing contact objects.

Contact object parameters:

name - full contact name. Required. Object with properties:

• formatted_name - Full name, as it normally appears. Example: Lord Adam John Smith Junior. You have to use at least one additional parameter (first_name, last_name, middle_name, suffix, prefix)

• first_name - First name. Example: Adam

• last_name - Last name. Example: Smith

• middle_name - Middle name. Example: John

• suffix - Name suffix. Example: Junior

• prefix - Name prefix. Example: Lord

birthday - YYYY-MM-DD formatted string. Example: 2012-08-18

addresses - array containing address objects with parameters:

• street - Street number and name. Example: 1 Hacker Way

• city - City name. Example: Menlo Park

• state - State abbreviation. Example: CA

• zip - ZIP code. Example: 94025

• country - Full country name. Example: United States

• country_code - Two-letter country abbreviation. Example: us

• type - Standard Values: HOME, WORK. Example: HOME

emails - array containing email objects with parameters:

• email - Email address. Example: test@fb.com

• type - Standard Values: HOME, WORK. Example: WORK

org - object containing parameters:

• company - Name of the contact's company. Example: WhatsApp

• department - Name of the contact's department. Example: Design

• title - Contact's business title. Example: Manager

phones - array containing phone objects with parameters:

• phone - Automatically populated with the wa_id value as a formatted phone number. Example: +1 (940) 555-1234

• type - Standard Values: CELL, MAIN, IPHONE, HOME, WORK. Example: HOME

• wa_id - WhatsApp ID. Example: 19405551234

urls - array containing url objects with parameters:

• url - URL. Example: https://www.facebook.com

• type - Standard Values: HOME, WORK. Example: WORK

Example: [{"addresses":[{"city":"Menlo Park","country":"United States","country_code":"us","state":"CA","street":"1 Hacker Way","type":"HOME","zip":"94025"},{"city":"Menlo Park","country":"United States","country_code":"us","state":"CA","street":"200 Jefferson Dr","type":"WORK","zip":"94025"}],"birthday":"2012-08-18","emails":[{"email":"test@fb.com","type":"WORK"},{"email":"test@whatsapp.com","type":"WORK"}],"name":{"first_name":"John","formatted_name":"John Smith","last_name":"Smith"},"org":{"company":"WhatsApp","department":"Design","title":"Manager"},"phones":[{"phone":"+1 (940) 555-1234","type":"HOME"},{"phone":"+1 (650) 555-1234","type":"WORK","wa_id":"16505551234"}],"urls":[{"url":"https://www.facebook.com","type":"WORK"}]}]

Quoted message ID (Cloud API)

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

Can be found by method /templates

Name of template

Object, containing fields "policy" and "code".

policy - now "deterministic" is only available option;

code - one of supported language codes

Array of localizable parameters to be substituted into the template. Each parameter is object contains the following field:

type - section of parameters - header, body, footer, button

parameters - variables for section.

Each variable is an object that can contain the following fields:

type - can be text, currency, date_time, image, document or video

video- id (mediaId)

document

• id (mediaId)

• filename(optional)

image - object with field link (image url)

currency - object containing parameters currency_code and amount_1000.

• currency_code - Currency code as defined in ISO 4217.

• amount_1000 - Amount multiplied by 1000.

• fallback_value - Default text if localization fails.

date_time - If the date_time object is used, further definition of the date and time is required.

• component - The time is assembled from components (i.e., day of the week, month, hour, etc.) The time specified will be the same, regardless of the time zone the client is in.

• unix_epoch - The time to be displayed is dependent on the time zone the client is in.

• fallback_value - Default text if localization fails.

button - if button has parameter

• sub_type (url/quick_reply)

• parameters (array to fill button variable)

• index - button position.

cards - filled in if you need to send the Carousel template

• card_index - card number

• components - array of card data

  type -  header, body, footer, button 
  
  parameters - variables for the section. 
  
  sub_type - subtype for buttons 
  
  index - button number
  

The number of parameters passed must match the number of parameters in the template

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.

Name of template

Template category

Array of template components

Object containing info about product or catalog. Can contain the following fields:

catalog_id - id of catalog

product_retailer_id - id of product. Only for sending single product.

sections - used for sending multiply products. It`s array containing objects with catalog info. See example below.

Example: {"catalog_id":"{{catalog_id}}","sections":[{"title":"the-section-title","product_items":[{"product_retailer_id":"{{SKU-1}}"},{"product_retailer_id":"{{SKU-2}}"}]},{"title":"the-section-title2","product_items":[{"product_retailer_id":"{{SKU-1}}"}]}]}

Text of message. Example: Some text.

Located under the message text. Example: Footer.

Header of catalog. Example: Header.

Required when sending the catalog.

Required if phone is not set

Chat ID from the message list. Examples: 12020721369@c.us . Used instead of the phone parameter.