Send Promotion Template Messages via WhatsApp with Zoho Creator

Send Promotion Template Messages via WhatsApp with Zoho Creator

1. Requirement

Increase customer engagement and sales efficiency by sending promotions and advertisements directly to customers via WhatsApp by integrating Zoho Creator with WhatsApp Business Platform.

2. Use Case

A sales organization uses Zoho Creator for customer management and related operations. To enhance customer engagement and sales efficiency, the organization wants to send promotions and advertisements directly to customers through WhatsApp. This can be accomplished by integrating Zoho Creator with WhatsApp Business.

3. Pre-requisites

3.1. Initial Setup - Creating App in Meta Developer Account

  1. Create a Facebook account or use your existing Facebook account and register yourself as a Meta Developer with your Facebook account.
  2. Create a WhatsApp Business account with your existing phone number.
  3. Note: WhatsApp Business Platform operates on a conversation-based pricing system, where a conversation is initiated when you send a template message, which incurs a cost. Refer this link to learn more about this pricing model.
  4. Create an app in your Meta Developers account with WhatsApp product by following the instructions in this help document. Follow the on-screen instructions to configure WhatsApp for your app, including setting up a business phone number and verifying it.
You can find your created app listed in the My Apps section of your Meta Developers Account.


Click on the listed app to view its dashboard and other properties.

3.2. Configure API and Generate Permanent Access Tokens

  1. From the App Dashboard, navigate to API Setup under WhatsApp in the left pane.

  2. You will be prompted to select an existing Meta Business Account or request the platform to create a new one and click Continue. Learn how to create a Meta Business Account.

  3. You will receive a temporary access token and a test phone number for testing purposes, which will expire within 24 hours. To create a permanent access token, you need to add a system user to your business account.

3.3. Create Template

WhatsApp message templates allow you to use existing and pre-approved templates to send structured messages to customers. Learn how to create a  message template.
Here, we have created a template named 'promotion' and configured it as shown below.

4. Steps to Follow in Zoho Creator

4.1. Create Custom Connector for WhatsApp

  1. Navigate to the Custom Connectors page from the Microservices tab of your Creator account dashboard and click Create New Custom Connector.

    1. If you have previously created custom connectors, they will be displayed as cards on the custom connectors page. Click the +Create New icon in the top-right corner.

  2. Specify the Connector Name as 'WhatsApp' and the Description as 'Creator WhatsApp Integration' and click Create Custom Connector.

  3. Upload a WhatsApp logo for our custom connector for easy identifications, then click Save & Continue.

  4. Select API key Authentication, then click Save & Continue.

  5. On the next page, select Parameter Location as 'Query String'. Enter the Parameter Name as 'Enter Access Token' and the Parameter Key as 'access_token' as shown.

  6. Click Save and mark the connector as ready to use. This will allow you to create a WhatsApp connection.

  7. Click Add Connection. You will be prompted to create a connection using this connector.
  8. Note: Once you mark the connector as ready, it will appear under the Custom   Connectors section when you create a connection. You can then use it to create multiple WhatsApp connections with the same connector. Learn More

  9. Enter Connection Name as 'WhatsApp Connection' and select Connection Authorization Level as 'Administrators', then click Create and Authorize.

  10. Enter the permanent access token that you generated previously, then enter the Name for the Authorized Account as 'WhatsApp Account'

  11. Select the desired environments to use this authorization and click Authorize.

  12. Enable connection access to the applications where the connection will be used.

4.2. Create Form to Collect Customer Details

  1. Create a form with the following details to collect customer details.

Form

Form Link Name

Field Type

Field Name

Field Link Name

 

Customer Details

 

Customer_Details

Name

Customer Name

Customer_Name

Email

Email

Email

Phone

Phone

Phone

Address

Address

Address

4.3. Configure Workflows

  1. Create a workflow to execute on the successful submission of the Customer Details form, then select the Record Event as 'Created'. Name the workflow as 'Send Promotion' and click Create Workflow. This workflow will send the template message to the customer's phone number stored in the Phone field via WhatsApp.

  2. Click Add New Action > Deluge Script and add the following code to the Deluge editor.
  1.   //Send template message to customer's phone number using invokeURL task.
  2.   response = invokeUrl
  3.   [
  4.    url: "https://graph.facebook.com/v19.0/<PhoneNumberID>/messages"
  5.    type: POST
  6.    parameters: { "messaging_product": "whatsapp", "to": input.Phone_Number, "type": "template", "template": { "name": "promotion", "language": { "code": "en_US" } } }
  7.    connection: "whatsapp_connection"
  8.  ];
where,

''https://graph.facebook.com/v19.0/<PhoneNumberID>/messages"

is the URL mentions in the WhatsApp API documents for API calls to send messages.

<PhoneNumberID>

is the ID of the Phone number added in your WhatsApp Business Account. You can find it in the API Setup under WhatsApp in your App Dashboard of Meta application. Example : 328562393673662


"whatsapp_connection"

is the name of the WhatsApp connection created using Custom Connector.


5. See How it Works


  1. WhatsApp Business Platform - Cloud API
  2. Understand Connectors
  3. Create Custom Connector
  4. Understand Connections
  5. Create and Authorize Connections
  6. invokeURL task for API calls

    Access your files securely from anywhere

      Zoho CRM Training Programs

      Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

      Zoho CRM Training
        Redefine the way you work
        with Zoho Workplace

          Zoho DataPrep Personalized Demo

          If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

          Zoho CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION









                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Send Page as PDF Attachment via Email

                                                                                                                Requirements Schedule an email to send a Zoho Creator page as a PDF attachment at defined time intervals using Deluge's sendMail task. Use Case To support customer engagement and business promotion, an organization uses the Pages feature in Zoho ...
                                                                                                              • Send Record Template as an Attachment in Mail

                                                                                                                Requirement Send a record summary as a PDF attachment via mail using the Deluge's send mail task. Use Case Consider an organization using Zoho Creator to manage POS operations. Whenever an invoice is generated, the invoice record template is promptly ...
                                                                                                              • FAQs: Zoho Creator - Starter Guide

                                                                                                                This page covers essential insights into Zoho Creator, a low-code platform offering support for multiple languages, shared responsibility models, and the unique Deluge coding language, providing comprehensive assistance for your business needs. What ...
                                                                                                              • GDPR and Zoho Creator

                                                                                                                This article covers what EU's GDPR is about, as well as the features and capabilities of Zoho Creator that can help you build GDPR compliant custom apps. Note: The content presented in this page is not to be construed as legal advice. Please contact ...
                                                                                                              • Encryption in Zoho Creator

                                                                                                                Encryption is primarily used to safeguard the contents of a message so that only the intended recipient could read it. This is done by replacing the contents with unrecognizable data, which could be understood only by the intended recipient. This is ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources