Whatsapp Integration - Zoho Desk Knowledgebase

Integrating WhatsApp with Zoho Desk



WhatsApp is the world's most widely used instant messaging (IM) service app, with over 2 billion users. The ubiquity of this app is reason enough for businesses of all sizes to look at it as a channel for customer support. If your customers frequently contact your business through WhatsApp, you'll find significant benefit in integrating your WhatsApp Business Account with your Zoho Desk portal.

By integrating the WhatsApp IM feature, your agents can view WhatsApp conversations within Zoho Desk and respond to them right away. This feature also facilitates the conversion of WhatsApp conversations into tickets for your agents to work upon.



What is an Embedded Signup?

Embedded Signup is a way for Zoho Desk to let you onboard to the WhatsApp Business API directly from our website. This embedded signup process reduces the onboarding time of new and existing customers from days to minutes. With embedded signup, you own your WhatsApp Business Accounts (WABAs) and share access to them with Zoho desk. This allows you to use your WABAs and seamlessly integrate with other Facebook experiences, such as ads that click to WhatsApp. Additionally, the signup process is simplified by having all the steps in a single flow, from connecting your Facebook and WhatsApp business accounts to verifying the business phone number. You can learn more about this in the Onboarding Process section.


Can I start messaging before completing the verification process?

Yes, you no longer need to wait to complete the business verification process to start testing the API. Once signed up, you will have access to a trial experience during which you can send business-initiated messages to two phone numbers, and have up to ten customer-initiated conversations for the first 30 days. This trial is only valid for the first verified phone number for each WhatsApp Business Account.

How much should I pay?

Zoho Desk manages the billing and credit line for your WABAs. That said, there is the new Conversation-Based Pricing model announced by WhatsApp. Click here to know about the new pricing model.

Prerequisites  

The following are the prerequisites for integrating WhatsApp with your Zoho Desk account:
  1. A Facebook Business Manager account
  2. A verified business
  3. A WhatsApp Business account
  4. A registered phone number to access the WhatsApp Business API 
Notes:

  1. After verifying your business, it will be reviewed for compliance with the WhatsApp Terms of Service and WhatsApp Commerce Policy.
  2. If you have rebranded your domain (domain-mapped accounts), you must enable third-party cookies in your browser before starting the integration.
  3. You cannot use WhatsApp phone numbers currently being used on other products. Only unused and registered phone numbers can be used for the integration.
  4. BSP Migration is now supported.

The Onboarding Process

The WhatsApp on boarding and integration flow is a four-step process. It will consist of linking your Facebook and WhatsApp Business accounts, creating your WhatsApp Business profile, verifying your WhatsApp Business number, and configuring WhatsApp as a channel. Make sure you have signed in to your Facebook account on the same browser. 

      1. Log in to your Zoho Desk account with Administrator privileges.
      2. Click the Setup icon (  ) in the top bar.



      3. Under Channels, click Instant Messaging.
      4. Click Configure corresponding to WhatsApp on the Instant Messaging page.



      5. Click Integrate on the WhatsApp page.
      
The Facebook authentication pop-up box will open.

      6. Link your Facebook and WhatsApp Business Account:
    1. Click Continue to link your Facebook account with Zoho Desk.



    2. Click Get Started in the Chat to WhatsApp users window.
    3. Click Continue on the Connect your account to Zoho Corporation window.



    4. Select the Facebook Business account you wish to link, then click Continue.
    5. Select the WhatsApp Business account linked to your Facebook Business account, then click Continue on the following screen.



    6. Click Continue to Step 2.
      7. Create your WhatsApp Business Profile:
    1. Enter the WhatsApp Business Display Name that you will use to message customers and click Continue.



      Make sure the display name meets the guidelines mentioned
      here.
    2. Select your Business Category from the drop-down menu.



    3. Enter a brief description of your business.
      The category and business description will both be visible to customers messaging your business.
    4. Click Continue to Step 3.
      8. Verify your WhatsApp Business Number
:
    1. Select an existing WhatsApp Business number or enter a new number to register.
      Note: You cannot register a number actively registered to either WhatsApp Messenger or the WhatsApp Business App.



    2. Select a verification method of your choice. You can choose between Text Message or Voice Call.
    3. Click Send Code.



    4. In the following window, enter the 6-digit verification code received on your WhatsApp Business Phone Number.
    5. Click Verify.
      9. Configure WhatsApp Channel:
    1. Back on the WhatsApp settings page, click Create Channel.
      Note: The number of channels you create cannot exceed the departments in your account.



    2. On the Add Channel page, follow the below steps:
      1. Upload an icon for the channel.
        Note: The icon size cannot exceed 1 MB and should be in the .jpg, .png, or .jpeg format.
      2. Enter a name for the channel.
      3. Select the WhatsApp phone number added under Step 3.
      4. Select the department in which you want to receive messages.
      5. Click Save.



      10. You have now completed the setup process and are ready to use the trial experience.

Business Verification

During the unverified trial experience, you can only send business-initiated messages to two phone numbers, and have up to ten customer-initiated conversations for the first 30 days. After 30 days, you will no longer be able to send messages until you complete Business Verification and pass all WhatsApp checks.

In order to establish a fully-fledged instant messaging live conversation platform, you must get your Facebook Business Manager Account verified by providing all the necessary documents, including proof of legal entity and proof of access to the business. Only then will your expanded trial version be enabled, which allows a two-way conversation between you and a customer with 1500 customer-initiated messages. Please remember that a conversation is a 24-hour session of unlimited messaging with a given phone number.

WhatsApp Channel Statuses

Once you add a WhatsApp channel, its Edit page will indicate one of the following statuses based on your integration progress.

 Status
  Indicates
You are now in unverified trial experience. To start your extended chat experience, visit the Facebook Messenger account and get your business number verified soon.
You can use the unverified trial experience (sandbox) to send messages to test the functionality.
Oops, process failed! Click here for assistance.
Something went wrong while configuring your Whatsapp phone number and requires our intervention.
Hooray! Your Whatsapp Business Phone number is connected successfully.
Your Facebook Business Manager account has been verified and enabled with the expanded trial version.
Whatsapp business account rejected! The documents that were submitted for validation have been rejected.
Facebook rejected your Business account since it didn't meet the criteria they have determined. You must resubmit for verification after 35 days of the last submission. 

Deactivating a WhatsApp Channel

You can deactivate a WhatsApp channel if you wish to stop sending or receiving messages in it. The channel's existing conversations will stay intact, and you can activate it again when required.
To deactivate a channel:
  1. Click the Setup icon (  ) in the top bar.
  2. Under Channels, click Instant Messaging.
  3. Click WhatsApp on the Instant Messaging page.
    The channels created in your account will be displayed.



  4. Turn off the toggle corresponding to the channel you want to deactivate.
  5. Click Deactivate on the confirmation dialog box.
    The channel will be deactivated.

Delete a WhatsApp Channel

You can delete a WhatsApp channel if you wish to stop sending or receiving messages in it. The channel's existing conversations will stay intact, but the agents will not be able to respond, transfer or block the associated chats.

To delete a channel:
  1. Click the Setup icon (  ) in the top bar.
  2. Under Channels, click Instant Messaging.
  3. Click WhatsApp on the Instant Messaging page.
    The channels created in your account will be displayed.
  4. Then, click on the horizontal ellipsis at the right corner of your channel, followed by Delete Channel.


      5. Click Yes, Delete on the confirmation dialog box.

           The channel will be deleted.
Notes Once the channel is deleted, you will not be able to send or receive messages. Even though the chats are intact (read-only), the agents cannot transfer or block the existing chats. For the deleted WhatsApp channel, the configured business number will get de-associated, and the same number will be listed and can be used to re-configure for another channel.

How to Edit the WhatsApp API Business Profile

Your WhatsApp Business Profile is important to your company’s growth. It acts as the digital storefront of your business, displaying key information that helps customers identify and trust your brand. Keeping it accurate and up to date can go a long way in establishing credibility and building strong customer relationships.

Supported file formats and attachment limits for WhatsApp

Direction

Media Type

Supported Formats

Maximum File Size

Outgoing

Image

.jpg, .jpeg, .png

5MB

 

Document

.pdf, text/plain, .xls, .xlsx, .pptx, .doc, .docx

50MB

 

Video

.3gp, .mp4

16MB

 

Audio

.mp3, .mpeg, .ogg, .amr, .acc, .vorbis

16MB

Incoming

Image

.jpg, .jpeg, .png

50MB

 

Document

.pdf, text/plain, .xls, .xlsx, .pptx, .doc, .docx

50MB

 

Video

.3gp, .mp4

50MB

 

Audio

.mp3, .mpeg, .ogg, .amr, .acc, .vorbis

50MB



      Create. Review. Publish.

      Write, edit, collaborate on, and publish documents to different content management platforms.

      Get Started Now


        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







                              Quick LinksWorkflow AutomationData Collection
                              Web FormsRetailOnline Data Collection Tool
                              Embeddable FormsBankingBegin Data Collection
                              Interactive FormsWorkplaceData Collection App
                              CRM FormsCustomer ServiceForms for Solopreneurs
                              Digital FormsMarketingForms for Small Business
                              HTML FormsEducationForms for Enterprise
                              Contact FormsE-commerceForms for any business
                              Lead Generation FormsHealthcareForms for Startups
                              Wordpress FormsCustomer onboardingForms for Small Business
                              No Code FormsConstructionRSVP tool for holidays
                              Free FormsTravelFeatures for Order Forms
                              Prefill FormsNon-Profit
                              Forms for Government
                              Intake FormsLegal
                              Mobile App
                              Form DesignerHR
                              Mobile Forms
                              Card FormsFoodOffline Forms
                              Assign FormsPhotographyMobile Forms Features
                              Translate FormsReal EstateKiosk in Mobile Forms
                              Electronic FormsInsurance
                              Drag & drop form builder

                              Notification Emails for FormsAlternativesSecurity & Compliance
                              Holiday FormsGoogle Forms alternative GDPR
                              Form to PDFJotform alternativeHIPAA Forms
                              Email FormsWufoo alternativeEncrypted Forms
                              Accessible FormsTypeform alternativeSecure Forms

                              WCAG

                                          Create. Review. Publish.

                                          Write, edit, collaborate on, and publish documents to different content management platforms.

                                          Get Started Now






                                                            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

                                                                  Use cases

                                                                  Make the most of Zoho Desk with the use cases.

                                                                   
                                                                    

                                                                  eBooks

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

                                                                   
                                                                    

                                                                  Videos

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

                                                                   
                                                                    

                                                                  Webinar

                                                                  Sign up for our webinars and learn the Zoho Desk basics, from customization to automation and more

                                                                   
                                                                    
                                                                  • Desk Community Learning Series


                                                                  • Meetups


                                                                  • Ask the Experts


                                                                  • Kbase


                                                                  • Resources


                                                                  • Glossary


                                                                  • Desk Marketplace


                                                                  • MVP Corner



                                                                    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 Demo

                                                                                                      Get a personalized demo or POC

                                                                                                      REGISTER NOW


                                                                                                        Design. Discuss. Deliver.

                                                                                                        Create visually engaging stories with Zoho Show.

                                                                                                        Get Started Now









                                                                                                                            • Related Articles

                                                                                                                            • Zoho Desk's IM migration to the WhatsApp Cloud API

                                                                                                                              The WhatsApp Cloud API can be implemented by businesses of any size, for free-of-cost messaging. In the past, Desk supported fewer than 30 messages per second. But with the migration to the WhatsApp Cloud API, we can now support up to 80 messages per ...
                                                                                                                            • Getting started with WhatsApp Sandbox

                                                                                                                              Zoho Desk's WhatsApp Sandbox enables you to prototype both sending and receiving messages in a test environment. You can start testing Sandbox with test numbers even before WhatsApp approves your business number and verifies your WABA. WhatsApp ...
                                                                                                                            • Introduction to Zoho Desk

                                                                                                                              Help Desk is a department in an organization that is in charge of providing the support needed by customers while using the company's product or a service. Customers contact the help desk when they have a question or a problem and a product expert ...
                                                                                                                            • Managing Payments for IM through Zoho Desk

                                                                                                                              Managing IM Credits     •    Among the most widely used messaging channels, only WhatsApp charges its user for sending messages. Soon, other platforms might follow suit and charge their users for sending messages to customers. Note: WhatsApp charges ...
                                                                                                                            • FAQs: WhatsApp Business

                                                                                                                              How to configure a Phone Number for the WhatsApp Embedded Sign-up. The business phone number must be configured manually by adding the number on the Facebook Business Manager console and verifying it. Login here Once WhatsApp approves the phone ...
                                                                                                                              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