Picky Assist Help Desk
Main WebsiteBlogFacebook Community
Picky Assist Help Desk
Picky Assist Help Desk
  • Welcome To Picky Assist 🙏
  • Setting Up Guide
    • Sending First Message
    • Connecting Channels
      • WhatsApp Web Automation to Official API Migration Guide 2024
      • Connecting WhatsApp Web Automation
      • Connecting Facebook Messenger
        • Introduction
        • Getting Start
        • Guidelines & Compliances
        • Messenger Link
      • Connecting WhatsApp Official
        • Introduction
        • Dashboard
        • Profile
        • Templates
      • Connecting WhatsApp Cloud API
      • WhatsApp Official Managed Service
      • Connecting Instagram
      • Phone Bridge (Call Blaze)
      • Connecting SMTP
      • Connecting Amazon SES
      • Connecting Sendgrid
      • Connecting Additional WhatsApp Numbers
      • Porting WhatsApp Number to Picky Assist
      • WhatsApp Official Message Delivery Issues & Solutions
    • Working With Prebuilt CRM Modules
      • Introduction
      • Onboarding
      • Modules
        • Leads
        • Deals
        • Meetings
        • Company
        • Support Cases
        • System Modules
          • Contacts
          • Notes
          • Task
          • Call Logs
          • Tags
          • Activity Logs
      • Automations
        • Workflows
        • Chatbots
        • Funnels
        • Connectors
        • Scheduler
        • Other Prebuilt Features
      • Reports and Dashboard
      • Mandatory Preconditions for Using Prebuilt
      • Testing Prebuilt
    • Managing Organization
    • Setting Up Teambox
      • Introduction
      • Routing Rules
      • Teambox
      • Inbox View
      • Organization Hierarchy
      • Analytics
    • Setting Up Smart Replies
      • Introduction
      • Train Module
        • Training Bot Introduction
        • Topics / Categories
        • Intent & Context
        • Question Variations
        • Uploading Bulk Questions
        • Reply with Media Files
        • Personalising Replies
        • Smart Actions
        • Direct URL
        • Fall Back Response
        • Small Talks
        • Testing the Bot
        • Publishing Bot
      • ChatGPT Integration
      • Learn Module
      • Stats Module
      • Deep Linking
      • Settings
    • Smart Reply V2
      • Introduction
      • ChatGPT Integration
      • Train Module
        • Training Bot Introduction
        • Topics / Categories
        • Intent & Context
        • Question Variation
        • Uploading Bulk Questions
        • Reply with Media Files
        • Personalizing Replies
        • Smart Actions
        • Direct URL
        • Fall Back Response
        • Small Talks
        • Publishing Bot
      • Learn Module
      • Stats Module
      • Deep Linking
      • Settings
    • Setting Up Broadcaster
      • Introduction
      • Creating a Campagin
      • Sending Message to WhatsApp Groups
      • Reports
      • Broadcaster V2
        • Introduction
        • Creating Campaign
        • Reports
    • Setting Up Sequence
      • Introduction
      • Creating New Sequence
      • Sequence Stats
      • Subscribe & Unsubscribe
      • Disabling Sequence Message
    • Setting Up Reminder
    • Setting Up Mobile App
    • Setting Up Connector
      • Introduction
      • Getting Started
      • Steps
        • Introduction
        • Filters
        • Delay
        • Iterator
        • Stats
      • Actions
      • Formatter
        • Date & Time
        • Counter
        • Math Calculation
        • Data Parser
        • Convert File
        • Line Items
      • Building Mini App
      • Email Parser
      • Data Storage
      • Simulate Test
      • Connector Logs
    • Email Builder
    • Setting Up Flow Builder
      • Fundamentals (Must Read)
      • Basic Terminology (Must Read)
      • Guide to Building an Effective Chatbot (Must Read)
      • Create, Manage, Test & Publish Flows
      • Triggering a Chatbot Flow
      • Steps
        • Introduction (Must Read)
        • Send Message
        • Ask A Question
        • Filter
        • Save Data
        • Actions
        • Check WhatsApp Session
        • Delay
        • Smart Delay
        • Formatter
        • Splitter
        • Data Lookup
        • Trigger HTTP API
        • Webhook
        • Apps
        • Match Keywords
        • Route to Chatbot
        • End
      • Saving Data into CRM
      • Analytics
      • Integrations
      • Flow Builder logs and conversational logs
      • Chatbot Best Practices, Ideas & FAQ
    • Setting up Modular CRM
      • Fundamentals (Must Read)
      • Guide to Building and Implementing a Modular CRM (Must Read)
      • Create & Manage Data Modules
      • CRM Macro Buttons
      • Adding Records into CRM
      • Data View & Manage Records
      • Task
      • Workflows
      • Funnels
      • Data Import
      • Integrations
    • Setting Up Scheduler
    • Media Gallery
    • Quick Replies
    • Opt-out Settings
    • Blacklist
    • Global Variables
    • Setting Up Ad-On's
      • Setting Up WhatsMail
      • Setting Up Zendesk
      • Setting Up Zapier
      • Setting Up Zoho CRM
        • Getting Started
        • Working with Extension
        • Integrating with Zoho Workflow
        • Lead Assignment Rules
        • Integrating into Custom Modules
        • Connecting Multiple WhatsApp Numbers into Zoho CRM
        • Integrating WhatsApp with Zoho CRM Mobile App
        • Keyboard Shortcuts
      • Setting Up Facebook Lead Adform
      • Facebook Lead Ad form V2
      • Setting Up WhatsApp Web
      • Setting Up Pabbly Connect
      • Setting Up ChatGPT App
    • Google Chrome Extensions
      • Extension for Sending WhatsApp Messages from any Webpage
      • Chrome Extension V2
      • Extension for Zoho CRM & Teambox
    • Managing Profile
      • Two Factor Aunthentication
      • Login History
      • Delete Account
    • Quick Rollout Guide
      • WhatsApp Official Account
    • Developers & Partners Guide for Deep Integration of Picky Assist
  • API Documentation V2
    • Introduction
    • Quick Start Guide 🏃
    • Global Webhook
      • How Webhook Works
      • Webhook Variables
      • Configuring Webhook URL
      • Webhook Request & Response
      • Getting the Conversation Context
      • Testing Your Webhook
    • Event Webhook
      • How Event Webhook Works
      • Event Webhook Variables
      • Configuring Event Webhook URL
      • Event Webhook Sample Request & Response
    • Push API
      • Introduction
      • API Variables
      • Sending Single Message - Push
      • Sending Dynamic Messages – Push
      • Sending Media Attachments – Push
      • Sending Interactive List & Buttons
      • Sending Stickers
      • Sending Bulk Messages - Push
      • Sending Contacts
      • Sending Location
      • Sending WhatsApp Template Messages
        • Introduction
        • Sending WhatsApp Template Text Messages
        • Sending WhatsApp Template Image
        • Sending WhatsApp Template Document
        • Sending WhatsApp Interactive Buttons
        • Sending WhatsApp Limited Time Offer Templates
      • Sending Message to Groups
      • Sending SMS Using SIM Card
      • Sending Message to Facebook Messenger
      • Normal Post Method
      • Delivery Reports
      • Push API Must Read Instructions
      • Testing API Requests
    • WhatsApp Template API
      • Introduction
      • API Variables
      • Template Request API
      • Template Status API
      • Languages
      • Guidelines
    • WhatsApp Group API
      • Introduction
      • API Variables
      • Create Group
      • Set Group Permission
      • Add Group Admin
      • Add Group Members
      • Fetch Group Details
      • Update Group Info
      • Remove Group Members / Admin
      • Generate New Invite Link
      • Group Delete Actions
    • WhatsApp Settings API's
      • WhatsApp Profile API
      • 2 Step Verification
      • WhatsApp Status Update
      • WhatsApp Contact & Group Fetching
    • Device Manage API’s
      • Fetching Device Status API
      • Device Commands API’s
      • WhatsApp Automation Server Status API
    • Account API
      • Fetch Balance
    • Project Management API
      • Introduction
      • Create Project
      • Get Project Details
      • Set / Update Webhook
      • Create API Token
      • Manage API Token
      • Change Billing Plan
      • Fetch Account Balance
      • Country Code & Timezones
    • References
      • Status & Error Codes
      • Most Frequent Issues & Solutions
      • Formating & Sending Emojis 😊
      • Postman Collection for Picky Assist API's
      • High Volume Messaging Bots - WhatsApp
    • Sample Codes
      • PHP
      • Python
      • Node JS
      • Ruby
      • Java
      • ASP.NET Using C#
      • Javascript
      • Go
      • Swift
      • C
      • C#
      • Objective C
  • General Guidelines
    • Billing
    • Adding Money Into Account
    • Rate Limits
    • Character Limits WhatsApp
    • Best Practices for Media Handling
    • Roadmap
    • Features In the Early Beta Version
  • Changelog
    • 2021
      • February 2021
      • March 2021
      • April 2021
      • May 2021
      • June 2021
    • 2020
      • February 2020
      • March 2020
      • April 2020
      • May 2020
      • June 2020
      • September 2020
      • October 2020
    • 2019
      • November 2019
      • October 2019
      • August 2019
      • September 2019
Powered by GitBook
On this page
  • Change Log April 19 2022
  • Full Funnel Promotional Messages
  • Understanding Templates
  • Template Category
  • Template Name
  • Dynamic Variable
  • Template Types
  • Language
  • Template Limitations

Was this helpful?

  1. API Documentation V2
  2. WhatsApp Template API

Introduction

PreviousWhatsApp Template APINextAPI Variables

Last updated 3 years ago

Was this helpful?

WhatsApp Templates are used to send notifications after 24 hours window. All templates structure must be pre-approved by WhatsApp before using it. WhatsApp Templates are also known as HSM (Highly Structured Messages).

Change Log April 19 2022

  1. It's possible to request video templates

  2. It's possible to pass one dynamic variable in header of the message

  3. It's possible to pass sample contents and sample media url for speedy approval of WhatsApp templates

  4. Character limit of the body when passing header and footer is removed, now you can pass 60 characters in header and footer also 1024 characters in body

  5. Dynamic value for the Interactive Template Button (Call to Action Website) is not mandatory

Full Funnel Promotional Messages

From September 15,2021 onwards WhatsApp supports sending full funnel promotional messages to opt-in customers i.e brands can send marketing or promotional pre-approved messages to opt-in customers after 24 hours window.

Every templates approved by WhatsApp will carry a unique template id and you need to pass the unique template id along with value of dynamic variable in order to send a templated message. Please note template messages are billed based on your destination country and plan opted, there are no free template messages included in any of the plan so your account should have enough balance to send templated messages. Once a template is approved currently it's not possible to edit.

Understanding Templates

WhatsApp have some specific guidelines to be followed for requesting and sending templated messages.

Template Category

WhatsApp will check wether the templates requesting by you is relevant to your business category, below are currently supported category , please select the appropriate category

ACCOUNT_UPDATE PAYMENT_UPDATE PERSONAL_FINANCE_UPDATE SHIPPING_UPDATE RESERVATION_UPDATE ISSUE_RESOLUTION APPOINTMENT_UPDATE TRANSPORTATION_UPDATE TICKET_UPDATE ALERT_UPDATE AUTO_REPLY

Please make sure the template message context is relevant to the category you selected

Template Name

You have to mention the name of the templates, please make sure the template name

Can only contain lowercase alphanumeric characters and underscores ( _ ). No other characters or white space are allowed.

Make your message template name clear. Instead of using a name like "template_014," use "bus_ticket_details".

Dynamic Variable

Dynamic variable is one of the important part of the templates which allows you to pass dynamic contents to the message, while requesting message templates you can specify the dynamic variable like {{1}} , {{2}}

Your One Time Password (OTP) to {{1}} is {{2}}

In the above template you can replace {{1}} and {{2}] with your own value when sending message.

Please dont request template with floating variables i.e lines with just variables not any text , in the below example {{3}} and {{4}} are floating variables and similar templates will be rejected

--
TICKET NO: {{1}}
PASSENGER NAME: *{{2}}*
--
{{3}} - {{4}}

Starting from April 2022 onwards it's possible to pass one dynamic variable in Header text.

New Lines, Tabs, 4 consecutive spaces are not allowed in the dynamic variable actual message content.

Template Types

Currently WhatsApp Supports only following template types , you need to specify the type of template you want to request

Text Templates This is a plain text templates, you can specify links, emoji's as well, maximum characters for text template is 1024

Media Templates Media templates are structured messages where you can pass header, body and footer , currently only images, videos & documents are allowed in media templates. Refer Media Size Limitations

Sample Image with Body & Footer

For images you must pass body text along with variables while requesting templates, footer is optional , if you use footer then the body text character is limited to 160 and footer text is limited to 60 characters. You can't pass dynamic variables in footer text.

Sample PDF Document with Header, Body & Footer

For Documents only PDF is supported now

Language

You can specify the language of the template, one template can be requested in many languages supported by WhatsApp, WhatsApp will not translate your templates into any local languages instead you need to specify the language so that WhatsApp approval team can easily review and approve the same.

For multiple languages you dont need to request multiple templates, you can request multiple languages through a single template by specifying the language. Please go through the supported language by clicking the below URL.

Template Limitations

  1. Currently its not possible to edit an approved WhatsApp template however can add new language variation to an existing template

  2. All templates are subjected to approval from WhatsApp and we dont have any role in the this process.

  3. New Line, Tabs, 4 consecutive spaces are not allowed in the dynamic variable actual message content.

  4. Character in the body of the template is limited to 1024, Header & Footer character is limited to 60 and buttons character is limited to 20, emoji is support only in the body text.

  5. Only Video, Image & Document (PDF) is supported in media template.

  6. Footer is fixed and no option to pass dynamic data (Footer is optional) If a template carries a footer it will auto append with messages.

Interactive Buttons WhatsApp Template supports sending message with Interactive buttons mainly with Quick Replies & Call to Action,

Read More
Read More How it Works
Languages