Home  >   Articles   >  WhatsApp Integration - Overview
Articles in this section

WhatsApp Integration - Overview

Lavanya R
17 May, 2024 - Updated 2 months ago
Table of Contents


Integration is bringing together smaller components into a single system that functions as one. In an IT context, integration refers to the result of a process that aims to stitch together different, often disparate, subsystems so that the data contained in each becomes part of a more extensive, more comprehensive system that, ideally, quickly and easily shares data when needed. 

WhatsApp is probably the most used means of communication across the planet. In India, WhatsApp is widely used for business also. Your customers also use WhatsApp for communication. WhatsApp CRM integration can be an extremely effective means of communication, especially by using Templates and automated transactional WhatsApp messages.

This article provides information about WhatsApp and the WhatsApp Integrations under Vtiger CRM.

WhatsApp Module Availability

In Vtiger CRM, the WhatsApp feature:

  • Is available by default for the below modules:
    • Cases
    • Contacts 
    • Deals
    • Internal Tickets
    • Invoice
    • Leads
    • Organizations
    • PhoneCalls
    • Quotes
    • Services
    • Vendors
  • Can be availed for any module including the custom module by creating a relationship with the Contact module. To learn how to create a relationship with the Contact module click here
    • For example, if you want to avail the WhatsApp feature for the Products module, you will have to create a One to One or One to Many or Many to One relationship with the Contact module for it.

Service Providers for Integrating WhatsApp

WhatsApp business messaging is a feature by its owner, Meta (formerly Facebook). The service is enabled through intermediate gateways. Here are the service providers you can integrate WhatsApp with Vtiger CRM:

Note about requirements:

  • You will need a Facebook Business Manager Account.
  • If you already have a Facebook Business Manager account, look for your Business Manager ID in the Business Settings > Business Info section.
  • You need to create one if you do not have a Facebook Business Manager ID.
  • WhatsApp uses approved Business Manager accounts to identify your business and associate your phone numbers with it. 
WhatsApp messaging fees or pricing:
  • Additional fees apply for sending messages via WhatsApp Business API. Please check the website of the service provider for the pricing.

Benefits of WhatsApp Integration

By connecting systems and providing a central pipeline through which both old and new systems can communicate, integration allows you to save costs, keep using your existing infrastructure, and add functionality piecemeal, using separate applications and services.

Following are the benefits of integrating WhatsApp Integration:

  • Collect customer feedback
  • Automate keyword-based actions
  • Follow-Ups
  • Assign labels for seamless communications
  • Order Tracking
  • Initiate conversations
  • Create workflow-based drip-marketing campaigns
  • Send Time-Based Messages
  • Improve Customer Support
  • Send team Notifications

In this article, you will learn about, 

  • Configuring and Setting Up WhatsApp
  • Installing WhatsApp
  • Navigation
  • Using WhatsApp through Vtiger CRM
  • Views in the WhatsApp module
  • WhatsApp opt-in/opt-out settings

Configuring and Setting Up WhatsApp

Before configuring, you need to first set up the service provider with WhatsApp. You need to have a service provider and a WhatsApp account.
For example, After you have bought and set up your Twilio account(service provider), you need to configure WhatsApp on the Twilio Console. To send and receive messages WhatsApp messages from the registered Twilio number, you also need Vtiger instance URL in Twilio. Let us see how.

Follow these steps to configure WhatsApp from your Twilio console:

Step 1: Go to the Twilio homepage.

Step 2: Click Programmable SMS.

Step 3: Click on WhatsApp.

Step 4: Click on the Senders option. WhatsApp: 1234XYZ Configuration window opens. 

Step 5: Add the Vtiger instance URL in Twilio. This helps you to send and receive messages from Vtiger CRM.    

   Step 6: Enter the following details: 
  1. CONFIGURE WITH: Select Webhooks



  4. FALLBACK URL: Enter the URL

  Step 7: Click Save.

Installing WhatsApp

A WhatsApp CRM tool eliminates repetitive tasks from your to-do list. By automating workflows- assigning incoming conversations to specific users and labeling conversations - your team has more time to focus on what is important to customers.

If you are not able to see the WhatsApp icon on your CRM, it is because WhatsApp is not available by default. You can install it yourself with just a few clicks.

Follow these steps to install WhatsApp:

  1. Click on the Main Menu in the top left corner of the screen.
  2. Click on Settings.
  3. Go to the Extensions section.
  4. Select Extension Store under the Extensions section.                              
  5. Type WhatsApp in the search bar and press Enter.
  6. You can now install WhatsApp by clicking on the install button.

Navigating to WhatsApp

Follow these steps to go to the WhatsApp module

  1. Log into your CRM account.
  2. Click Main Menu.
  3. Go to Essentials under the Apps section.
  4. Select WhatsApp under Conversations.
  5. Select any record from the List View.

Adding or removing WhatsApp Columns

You have the flexibility to customize your List View by adding and removing columns in the WhatsApp List View.

 Follow these steps to add or remove columns:

  1. Click the Menu icon.
  2. Select and open any module. 
  3. Click the Manage Columns icon on the left side of column names.                           
  4. A Configure Columns window appears.
  5. Remove the columns by clicking the X button on the field name in the Selected Fields section.
  6. Add the columns of your choice by selecting the columns from the Available Fields section by clicking Search Fields.
  7. Click the Update List button to view the changes in your List View. 

Actions in the WhatsApp record

Once you select a record from the List View, you will be able to see the summary view of that particular record.

Here are the actions that can be performed on the WhatsApp record.

  1. Follow: You can follow a record by clicking on the star icon.
  2. Tags: You can add tags to that record by clicking the ‘+Add’ icon.
  3. Open in New tab: You can open the record in a new tab by clicking this icon.
  4. Copy Link: You can click on this icon to copy the link.
  5. More: Click on the icon to see the attached documents.      

Actions on Documents

When you click on the More icon, you will find documents.

Here are the actions that can be performed on documents

  1. Click on the More Icon. Select Documents.
  2. A What do you want to do window will appear.
  3. Click on Select Documents.
  4. A document window will open where you can find a list of documents.
  5. Click on a record.
  6. That record will appear on the main page of that particular record.
  7. When you hover on that record, you will see the following options that can be performed on that record.
    1. Print
    2. Preview
    3. Share
    4. Download
    5. Edit
    6. Unlink
  8. Link Document: You can link documents with one another.
  9. Add Document: You can create a new document or upload a file.
  10. Record List: Displays a list of documents.

Using WhatsApp Through Vtiger CRM

WhatsApp Templates

WhatsApp message templates are standard, reusable messages that companies can use to contact their customers. They are semi-automated conversation starters where most of the message is pre-written and you have to add a few details for that personal touch.

 WhatsApp template messages are pre-written, pre-approved messages that are sent by businesses to opted-in customers via WhatsApp API. Some of the examples might include confirmations, delivery updates, and support-related automatic replies.

Creating and setting up standard message templates in Vtiger CRM is a two-step process.

  • First, create a standard message template on your service provider instance and get it approved by WhatsApp to use from your CRM.
  • Secondly, use standard approved templates when you send the message within 24 hrs.

Let us see an example of creating WhatsApp Message templates with the Twilio service provider.

Step 1: Setting up a standard message on the Twilio Console.

Follow these steps to add standard message templates on the Twilio console and get them approved from WhatsApp:

  1. Log in to the Twilio website using your Twilio credentials.
  2. Click on Messaging.
  3. Click on Senders.
  4. Click on the WhatsApp Templates.
  5. Go to the WhatsApp Message Templates section on the right-hand side.
  6. Click on New Message Template.
  7. A Submit a New Message Template section will appear. Update the details here.
    1. Type the required message in the General Information and  Message Template section so that WhatsApp approves it.
  8. Click Submit Message Template.
  9. The WhatsApp Message Templates section displays approved templates.
  10. The Message Template Status column will display the template approved and rejected by WhatsApp.
  11. Copy the approved message you created and paste it into the WhatsApp template record in the CRM.

Step 2: Creating a WhatsApp template in the CRM (for the approved message).

Note: Copy the approved message from the Twilio console and keep it ready.

Follow these steps to create standard message templates:

  1. Go to the Main menu.
  2. Go to Tools.
  3. Click on the WhatsApp Templates option.
  4. Click on the + Add Template button.
  5. Enter the following details in the Create WhatsApp Template window -
    1. Message Textbox on the left:
      1. We can create our template for all the modules.
      2. The standard message displays certain numbers in brackets. Replace these numbers with actual merge tags in the template.

b. The fields on the right side of the window:

i. Template Name - Enter the name of the template.
ii. Assigned To - Select the employee to whom the template is assigned.
iii. Module - The module to the template is attached. For example, you can create templates for Invoices or Deals and so on.
iv. Merge Fields - You can select and add standard merge fields. from this section. For example, you can choose salutation, phone numbers, primary email addresses, etc., and they will appear in the message textbox.

  • The message textbox on the left displays standard messages along with numbers in brackets. Replace these numbers with merge fields.
  1. Click Save.

The new template will appear in the WhatsApp Templates List View.

Remember, WhatsApp needs to approve all standard message templates you create before you can use them.  


  • WhatsApp templates are available for all modules.
  • By default, WhatsApp templates were available for the Contacts module only. You can now make them available by enabling the Any module option in WhatsApp templates. Selecting this option will let you send a message (direct or automated) from any module in the CRM.
  • Limitation:  
    • Approved templates with variables cannot be used by any other module other than Contacts. 
    • Approved templates without variables can be synchronized with any module in the CRM.

From Where in CRM can you send WhatsApp messages?

Sending a WhatsApp Message

From the ListView (of different modules)

Follow these steps to send a WhatsApp message from the List View of your CRM.

  1. Go to the ListView of a module.
  2. Hover on the record you want to send a WhatsApp message to.
  3. Click on the WhatsApp icon that is visible on the extreme right of the screen.
  1. Enter or select the following in the Send WhatsApp Message window: 

a.  Phone Number - Select a phone number to send the WhatsApp message.

  1. Note - The number has to be a mobile number registered with the respective service provider installed to receive and send messages.

  2. Select WhatsApp Template - Select WhatsApp templates to send messages.

Approved templates will be used only to send the message within 24hrs. This behavior is only for Twilio providers. 

  • Note: You can select this option only if you have a template that has been approved by WhatsApp.

    • Message window - Type your message in this textbox. Don’t forget the following.

i. Make your message fun - You can include emojis in your message by clicking the emoji icon in the top right corner of the textbox.

ii. Don't forget to add documents - You can upload documents with your message by clicking the Attach Files link. You can attach only one document of size 16MB. 

  1. Click the Send button.


From the Summary View of a record

Follow these steps to send a WhatsApp message from the Summary View of your CRM.

  1. Click on a record to go to its Summary View.
  2. Click on the More option. 
  3. Under the Reach Out Now option.
  4. Click on the WhatsApp option.
  5. Enter or select the following in the Send WhatsApp Message window: 
    1. Phone Number - Select a p
    2. Select WhatsApp Template - Select a message template if you want to send a standard message. This is optional.
    3. Message window - Type your message in the textbox.

 i. Make your message fun: You can include emojis in your message by clicking the emoji icon in the top right corner of the textbox.
Don't forget a document: You can upload documents along with your message by clicking the Attach Files link. The maximum size of a document is limited to 16 MB.

  1. Click the Send button.

Sending WhatsApp messages (From WhatsApp Widget View CRM modules)

You can also send WhatsApp messages from the widgets view. 

When you select a record from the List View, you will find icons(widgets) on the right-hand side. You can find the WhatsApp icon. When you click on the icon, a message text box will appear on the left-hand side of the icon. You can now start sending messages to that contact. 

Outgoing messages are marked in blue and Incoming messages are marked in grey.


Checking the Message Delivery Status of WhatsApp messages

Once you have sent a message on WhatsApp, you can check its status by heading to the Information section. 

Here, you can view the API Response and Failed Reason. If your message wasn't successfully delivered, the API Response field will display authentication failed. The Failed Reason field will also give you more information on why the message was not sent.

Views in the WhatsApp module

The following are the WhatsApp views:

  • List 
  • Summary
  • Detailed

List View of WhatsApp module

The List View of the WhatsApp module displays the list of all WhatsApp messages that have been sent and received. From the ListView, you can:

  • Check sent and received messages.
  • Check the status of messages.
  • Open individual messages to view details.

The Activity section of individual records displays the details for each record.

Status of WhatsApp Messages

 WhatsApp messages are visible in the following statuses in the List View: 

  1. Sent
  2. Received
  3. Delivered
  4. Read
  5. Queued
  6. Undelivered 

Summary View of the WhatsApp module

When you click on a record from the List view, you can see the Summary View of that record. Here, when you click on the More () option in the right corner, a drop-down menu will appear. You can select WhatsApp under the Reach Out Now section.

Will this message be available in a contact record and if it is, where is it available?

When you click on a record, you will be able to see the Summary view of that particular record. 
When you select the TouchPoints tab next to Filters, you will find the following information regarding that record:

  • Events
  • Portal
  • Documents
  • Email Campaigns
  • Emails
  • Cases
  • Phone Calls
  • SMS Messages

When you select the SMS messages tab, you can find dispatched and failed, messages against the count of each category.


WhatsApp opt-in settings


WhatsApp opt-in is the agreement of your lead or client to receive messages and notifications from your business via WhatsApp.

An opt-in cannot happen via WhatsApp. That is, users must provide you with their number via another 3rd-party channel your business uses (website, app, email, SMS, etc.). You must obtain an opt-in before you engage with customers via the messaging app. It’s your responsibility to store your opt-ins and ensure that users are only receiving what they signed up for.

Opting out of information sharing does not appear to be conceivable, but rather WhatsApp is putting forth a partial opt-out — particularly for Facebook promotion and product-related purposes.

The WhatsApp opt-in is a field available in a few CRM module records under Basic Information > WhatsApp opt-in in the Summary View and Detailed View. It provides WhatsApp opt-in options. WhatsApp opt-in options are WhatsApp messaging options available for sending and receiving WhatsApp messages. You can select the following WhatsApp opt-in options for your contacts, leads, organizations, and vendors based on your preferences:

  1. Single opt-in:  It lets you send outgoing messages and receive incoming messages from WhatsApp.
  2. User opted out: It lets you receive incoming messages and does not let you send outgoing messages from WhatsApp.
  3. None:  It lets you send outgoing messages and receive incoming messages from WhatsApp.

The WhatsApp opt-in options are available for the following modules:

  • Contacts
  • Leads
  • Organization
  • Vendors

Follow these steps to select a WhatsApp opt-in option while creating or editing a record for a contact, lead, organization or vendor:

Note: For instance, we have considered the Contacts module, you can go to any module mentioned above.

  1. Log into your CRM account.
  2. Click the User Menu.
  3. Click Essentials.
  4. Look for Lead & Contact Management.
  5. Select Contacts.
  6. Click +Add Contact.


  1. Select a Contact record.
  2. Go to the Summary View or Detailed View of the record.
  3. Go to Basic Information.
  4. Look for the WhatsApp opt-in field. Select a suitable WhatsApp opt-in option.

You have now successfully selected a WhatsApp opt-in option for contact in CRM.

Note: The WhatsApp opt-in options are available for all the WhatsApp providers Vtiger CRM is integrated with.

Why is Opt-in/Opt-out important?

Opt-in compliance serves as a solid foundation for improving email campaign performance and ensuring compliance with global privacy laws. We become better senders when we learn how the underlying infrastructure works and how we are affected by its rules.

Besides the fact that an Opt-out button is a must, the option serves your business well. It shows your contacts you value your interaction with them – Giving them the option to opt out of your newsletters and emails whenever they choose, avoiding the invasion of space. With this empathetic-like gesture, your readers can feel comforted.

Viewing WhatsApp Records

Once you send or receive a WhatsApp message you can view it from the:

  • WhatsApp module, or
  • Related module

Viewing WhatsApp Records from the WhatsApp module

Follow these steps to view WhatsApp records from the WhatsApp module:

  1. Log in to your CRM account.
  2. Click the Main Menu.
  3. Click Essentials.
  4. Look for Conversations.
  5. Click WhatsApp. You can view all WhatsApp records in the List View.
  6. In the Source field, type the name of the WhatsApp provider.
  7. Hit Search or Enter.
  8. WhatsApp records for the specified WhatsApp provider are displayed.
  9. Click on a record to view its details.  

Viewing WhatsApp Records from a module

You can view WhatsApp conversations from the module where you have initiated them.

Follow these steps to view WhatsApp records from a module:

  1. Log in to your CRM account.
  2. Go to the module from where you have initiated the WhatsApp conversation.
  3. Click the customer record. The Summary View opens.
  4. Under Activities, you can view the WhatsApp conversation with delivery statuses Delivered, Failed, and Read.


  1. Log in to your CRM account.
  2. Go to the module from where you have initiated the WhatsApp conversation.
  3. Click the customer record. The Summary View opens.
  4. In the Widget View, click WhatsApp.
  5. You can view the WhatsApp conversation.
Was this article helpful?
0  out of  0  found this helpful.
Comments 0
Be the first to comment
© Copyright 2023 Vtiger. All rights reserved.