Feature Availability
Vtiger Editions: One Pilot | One Growth | One Professional | One Enterprise | One AI
Introduction
WhatsApp is one of the most widely used communication platforms globally, especially in India, where it is extensively used for both personal and business interactions.
With WhatsApp CRM integration, you can streamline interactions by sending automated messages, notifications, and personalized communication. This makes it a powerful and effective channel for engaging with customers and managing conversations efficiently.
WhatsApp Integration with Vtiger CRM
With WhatsApp integrated in Vtiger CRM, you can:
- Send messages directly from the CRM.
- Receive notifications and personalized template-based messages.
- Track conversations and customer interactions from a central location - the CRM.
WhatsApp Messaging from Different CRM Modules
In Vtiger CRM, the WhatsApp messaging feature is available by default for the following modules:
-
Cases
- Contacts
- Deals
- Internal Tickets
- Invoice
- Leads
- Organizations
- PhoneCalls
- Quotes
- Services
- Vendors
Note: WhatsApp messaging can be availed for any module, including custom modules, by creating a relationship with the Contact module. To learn more about creating a relationship with the Contact module,
click here. For example, if you want to use the WhatsApp feature in the Products module, you will need to create a One-to-One, One-to-Many, or Many-to-One relationship with the Contact module.
Key Features
The following are the key features of using WhatsApp:
- Send and receive WhatsApp messages to and from your contacts directly from the CRM.
- Send WhatsApp messages in the form of notifications, alerts, approvals, and standard messages.
- Use customizable templates to create custom messages. Customize your messages and relate them to different modules in the CRM.
- Attach relevant documents like invoices and quotes along with your messages.
- Manage and track your messages. Check message status, view details, etc.
- Create workflows for automated messages.
Service Providers for Integrating WhatsApp
You can integrate your WhatsApp account with Vtiger CRM, along with a service gateway or provider to send messages. You can send messages only when these intermediate gateways are configured in the CRM. You can configure the following service providers for WhatsApp in Vtiger CRM:
- Ampala
- Clickatell
- Gupshup
- IMI Mobile
- Pinnacle
- Twilio
- Wablas
- Wati
Requirements
Before configuring WhatsApp in Vtiger CRM, ensure the following steps are completed on Facebook and WhatsApp Platforms:
- Create a business account in Meta Business Manager
- Create a WhatsApp Business Account (WABA)
- Add and verify your phone number
- Configure WhatsApp with a service provider
WhatsApp messaging fees or pricing: Additional fees apply for sending messages via WhatsApp Business API. Please check the service provider's website for pricing.
Benefits of WhatsApp Integration
The benefits of integrating WhatsApp with Vtiger are:
- Create a superior customer experience: Use images, videos, and hyperlinks to create smart and engaging conversations.
- Connect with people globally where they already are: Maximize your outreach by connecting with global customers.
- Enable two-sided conversations: Use customizable templates and themes to build high-converting and conversational campaigns.
- Message privately and securely: Send end-to-end encrypted messages. Send OTPs and other time-critical messages directly from CRM.
In this article, you will learn about:
- Configuring and Setting Up WhatsApp
- Installing WhatsApp in Vtiger CRM
- Using WhatsApp through Vtiger CRM
- Views in the WhatsApp module
- WhatsApp opt-in/opt-out setting
Key Terminology
| Key Term | Definition |
| Meta Business Manager | A platform from Meta used to manage business accounts, WhatsApp Business Accounts, and related assets. |
| Facebook Business Page | A business profile on Meta used to represent a company and connect business services like WhatsApp Business. |
| Twilio Console | The dashboard in Twilio used to configure messaging services, APIs, and WhatsApp settings. |
| WhatsApp Template | A pre-approved message format used to send standard WhatsApp messages to customers. |
| Opt-in | Permission given by a customer to receive WhatsApp messages from a business. |
| Opt-out | A customer’s choice to stop receiving WhatsApp messages from a business. |
| WhatsApp Service Provider | A service provider that enables businesses to integrate and manage WhatsApp communication through APIs and messaging services. |
| Gateway | A gateway is a system or service that connects two applications or networks and enables communication and data exchange between them. |
Installing WhatsApp
WhatsApp is not available by default in your CRM. You will need to install it from the Add-ons section.
Follow these steps to install WhatsApp:
- Log in to the CRM.
- Click the User Menu in the top left corner of the screen.
- Click Settings. The Settings page opens.
- Go to the Extensions section.
- Select Add-ons under the Extensions section.
- Type WhatsApp in the search bar.
- Click Install.
The WhatsApp module will be available under Essentials > Conversations.
Configuring WhatsApp in Vtiger CRM
To configure WhatsApp in Vtiger, we will use the Pinnacle gateway as an example.
Follow these steps to configure Pinnacle in Vtiger’s WhatsApp module:
- Log in to the CRM.
- Click the main Menu.
- Go to Essentials > Conversations.
- Select WhatsApp. The WhatsApp module opens.
- Click Settings. The Settings page opens.
- Select Provider Configuration from the drop-down.
- Click +Add. The Add Configuration window opens.
- Enter or select the following information to configure the Pinnacle in the WhatsApp module:
- Provider Name: Enter Pinnacle or a custom name to identify the configuration.
- Active: Enable Yes to activate the configuration.
- Default Provider: Enable Yes to set as the default provider if needed.
- API Key: Enter the API key shared by the Pinnacle team.
- From Number: Enter the phone number used during account creation.
- Status Callback: It is automatically generated and used for status updates.
- Incoming Callback: It is automatically generated and used for return calls.
- Click Save.
Note: The following are auto-generated once you click Save.
- WABA ID: The ID is auto-generated once the API Key and From Number are saved.
- Phone Number ID: The ID is auto-generated once the API Key and From Number are saved.
Upon saving the Pinnacle configuration, the webhook settings are also configured.
To learn more about WhatsApp integration with Pinnacle, click here.
After the configuration, Pinnacle will be available in the WhatsApp > Settings > Provider Configuration screen as a provider.
Accessing the WhatsApp Module
Follow these steps to access the WhatsApp module
- Log in to the CRM.
- Click the main Menu.
- Go to Essentials.
- Select WhatsApp under Conversations.
A List View of WhatsApp records opens.
Actions in a WhatsApp Record
Once you select a record from the ListView, you will be able to see the summary view of that particular record.
The following actions can be performed on the WhatsApp record:
- Follow: You can follow a record by clicking on the star icon.
- Tags: You can add tags to that particular record by clicking on the ‘+Add’ icon.
- Open in New tab: You can open the record in a new tab by clicking this icon.
- Copy Link: You can click on this icon to copy the link.
- More: Click on the icon to see the attached documents.
Actions on Documents
When you click on the More icon, you will find documents.
Follow these steps to perform actions on documents:
- Log in to the CRM.
- Click the main Menu.
- Go to Essentials > Conversations.
- Click WhatsApp. The WhatsApp module opens.
- Select a WhatsApp record. The Summary View of the record opens.
- Click on the More Icon.
- Select Documents. A What do you want to do window will appear.
- Click Select Documents. A document window will open where you can find a list of documents.
- Click on a record. The record will appear on the main page of that particular record.
- When you hover over that record, you will see the following options that can be performed on that record
- Print
- Preview
- Share
- Download
- Edit
- Unlink
- Link Document: You can link documents with one another.
- Add Document: You can create a new document or upload a file.
- Record List: Displays a list of documents.
Using WhatsApp in Vtiger CRM
WhatsApp Templates
WhatsApp template messages are pre-written, pre-approved messages that are sent by businesses to opted-in customers via the WhatsApp API. Some of the examples 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 in your service provider instance and get it approved by WhatsApp for use in your CRM.
- Secondly, use standard approved templates when you have to send the message within 24 hrs.
Let us see an example of creating WhatsApp Message templates with Twilio as the 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 by WhatsApp:
- Log in to the Twilio website using your Twilio credentials.
- Click on Messaging.
- Click on Senders.
- Click on the WhatsApp Templates.
- Go to the WhatsApp Message Templates section on the right-hand side.
- Click New Message Template.
- A Submit a New Message Template section will appear. Update the details here.
- Type the required message in the General Information and Message Template section so that WhatsApp approves it.
- Click Submit Message Template.
- The WhatsApp Message Templates section displays approved templates.
- The Message Template Status column will display the templates approved and rejected by WhatsApp.
- 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:
- Log in to the CRM.
- Click the main Menu.
- Go to Tools.
- Click on the WhatsApp Templates option.
- Click on the +Add Template button.
- Enter or select the following details in the Create WhatsApp Template window:
- Message Textbox on the left: We can create our template for all the modules. The standard message displays certain numbers in brackets. Replace these numbers with actual merge tags in the template.
- The fields on the right side of the window:
- Template Name - Enter the name of the template. The message textbox on the left displays standard messages along with numbers in brackets. Replace these numbers with merge fields.
- Assigned To - Select the employee to whom the template is assigned.
- Module - The module to which the template is attached. For example, you can create templates for Invoices or Deals and so on.
- Merge Fields - You can select and add standard merge fields. From this section. For example, you can choose salutations, phone numbers, primary email addresses, etc., and they will appear in the message textbox.
- 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.
Note:
- 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 module other than Contacts.
- Approved templates without variables can be synchronized with any module in the CRM.
Sending a WhatsApp Message
From the List View (of different modules)
Follow these steps to send a WhatsApp message from the List View of your CRM.
- Log in to the CRM.
- Click the main Menu.
- Go to Essentials > Contacts. A List View of Contact records opens.
- Hover over the record you want to send a WhatsApp message to.
- Click on the WhatsApp icon that is visible on the extreme right of the screen. The Send WhatsApp Message window opens.

- Enter or select the following in the Send WhatsApp Message window:
- Phone Number - Select a phone number to send the WhatsApp message.
- Note - The number has to be a mobile number registered with the respective service provider installed to receive and send messages.
- Select WhatsApp Template - Select a WhatsApp template from the drop-down to send messages.
- You can select this option only if you have a template that has been approved by WhatsApp. Templates need to be approved by WhatsApp before you can use them to send messages.
- Message - Type your message in this textbox. Don’t forget the following.
- 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 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.
- Click Send.
From the Summary View of a record
Follow these steps to send a WhatsApp message from the Summary View of your CRM.
- Log in to the CRM.
- Click the main Menu.
- Go to Essentials > Contacts. A List View of the Contact record opens.
- Select a Contact record to which you want to send a WhatsApp message.
- Click on the More option.
- Under the Reach Out Now option.
- Click the WhatsApp option.
- Enter or select the following in the Send WhatsApp Message window:
- Phone Number - Select a phone number to send the WhatsApp message. Note: The number has to be a mobile number installed with WhatsApp to receive and send messages
- Select WhatsApp Template - Select a message template if you want to send a standard message. This is optional.
- Message window - Type your message in the textbox.
- 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.
- Click Send.
Sending WhatsApp messages (From the 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.

Saving Customer WhatsApp Responses
You can now save customer interactions from their responses to your WhatsApp messages directly in the CRM. For example;
- If your WhatsApp message is a feedback query, the customer's response will be automatically recorded in the CRM. This ensures that feedback data is centralized and easily accessible.
- When your message pertains to a task, case, or ticket, and you request specific details from the customer, their replies will now be automatically linked to the corresponding record in the CRM.
This functionality is enabled by a new custom field, Reply Message, introduced in the WhatsApp module.
- When a customer replies to your WhatsApp message, the API checks for a Reply Context ID in the incoming message.
- If the Reply Context ID matches the Message ID of your original WhatsApp message, the Reply Message field is updated automatically.
Receiving WhatsApp Messages in Vtiger CRM
You can view incoming WhatsApp messages directly within Vtiger CRM through alerts and notifications. When a new message is received, a notification appears in the CRM.
Clicking the notification takes you to the related Contact’s chat view or the Live Chat window, where you can read the message and respond immediately.
Views in the WhatsApp module
The following views are available in the WhatsApp module:
- List View
- Kanban View
- Calendar View
- Summary View
List View
The WhatsApp module's List View displays all WhatsApp messages sent and received. From the List View.
You can:
- Check sent and received messages.
- Check the status of messages.
- Open individual messages to view details.
WhatsApp messages are visible in the following statuses in the List View:
- Sent
- Received
- Delivered
- Read
- Queued
- Undelivered
Adding or Removing Columns
You can customize your WhatsApp List View by adding and removing columns.
Follow these steps to add or remove columns:
- Log in to the CRM.
- Click the main Menu.
- Go to Conversations > WhatsApp. The WhatsApp module opens.
- Click the Manage Columns icon on the left side of column names. A Configure Columns window appears.
- Remove the columns by clicking the X button on the field name in the Selected fields section.
- Add the columns of your choice by selecting the columns from the Available fields section by clicking Search Fields.
- Click the Update List button to view the changes in your List View.
Kanban View
You can view WhatsApp records in the Kanban View, where each record is displayed as a Kanban card. The information shown on each card depends on the module configuration.
In the WhatsApp module, the Kanban cards display:
- The name of the contact who sent or received the message
- The current status of the message
Calendar View
Using the Calendar View, you can view WhatsApp records and activities scheduled for:
- The current date
- A single day
- Three days
- A week
- A month
You can also search and filter WhatsApp records based on the Created Time and Modified Time.
Summary View
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.
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.
Status of WhatsApp Messages
WhatsApp messages are visible in the following statuses in the List View:
- Received
- Sent
- Delivered
- Read
- Queued
- 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.
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
Opt-in/Opt-out
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:
- User opted out: It lets you receive incoming messages and does not let you send outgoing messages from WhatsApp.
- Single opt-in: It lets you send outgoing messages and receive incoming messages from WhatsApp.
- 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.
- Log in to the CRM.
- Click the main Menu.
- Click Essentials.
- Look for Lead & Contact Management.
- Select Contacts.
- Click +Add Contact.
or
- Select a Contact record.
- Go to the Summary View or Detailed View of the record.
- Go to Basic Information.
- 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 the Contact in CRM.
Note:
- The WhatsApp opt-in options are available for all the WhatsApp providers Vtiger CRM is integrated with.
- The Timezone field can be configured to show date and time information based on the Contact’s time zone rather than the assigned user’s time zone.
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:
- Log in to the CRM.
- Click the main Menu.
- Click Essentials.
- Look for Conversations.
- Click WhatsApp. You can view all WhatsApp records in the List View.
- In the Source field, type the name of the WhatsApp provider.
- Hit Search or Enter.
- WhatsApp records for the specified WhatsApp provider are displayed.
- 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:
- Log in to the CRM.
- Go to the module from where you have initiated the WhatsApp conversation.
- Click the customer record. The Summary View opens.
- Under Activities, you can view the WhatsApp conversation with delivery statuses Delivered, Failed, and Read.
Or
- Log in to the CRM.
- Go to the module from where you have initiated the WhatsApp conversation.
- Click the customer record. The Summary View opens.
- In the Widget View, click WhatsApp.
- You can view the WhatsApp conversation.
Limitations
- You can send direct messages to a customer only if they have replied within the last 24 hours.
- Approved WhatsApp templates can be sent even outside the 24-hour messaging window.
- Media files larger than 16 MB are not supported.
- Only one media file can be sent at a time. Supported media formats include:
- Images: JPG, JPEG, PNG
- Audio: MP3, OGG, AMR
- Documents: PDF
- Videos: MP4 (H.264 video codec with AAC audio)
References