WhatsApp integration
The WhatsApp integration lets you manage your WhatsApp conversations directly in Pipedrive, keeping your sales communication organized and connected to your deals and contacts.
This feature allows you to view conversations, send template messages, reply in real time and link chats to your pipeline so your team always has full context.
What you can do with WhatsApp messaging
Bring all your sales conversations into Pipedrive.
Respond to new leads, follow up on conversations and use message templates when re-engaging a contact.
Send reminders, share next steps and stay on top of renewals or upgrades.
Meet the customers where they’re at, respond faster and follow up smarter, all while staying on top of every deal.
React to messages with emojis and see the reactions your customers send.
View images inline and play audio messages directly in the conversation. You can download videos and documents from the message.
Receive in-app notifications for new messages on conversations linked to your deals, so you never miss a customer reply.
With real-time chatting, you can reduce missed connections and slow or crowded email inboxes, enabling lightweight back-and-forth conversations that feel more natural.
Keep in mind that Meta charges businesses for using the WhatsApp business platform. These charges are per message for messages delivered to users. The final cost is determined by two main factors:
The charge is applied upon message delivery, not when it’s sent.
The message category, which is one of four types: marketing, utility, authentication, or service.
Note: Rates vary by market and category pair. You can review Meta’s rate calculator to estimate your charges by using Meta‘s rate calculator.
Where to find WhatsApp conversations
You can access WhatsApp messaging within the Sales Inbox and the detail views of deals and contacts.
Sales Inbox
Open the Sales Inbox and click the WhatsApp integration to view a list of WhatsApp conversations associated with your assigned number. Conversations are ordered by most recent activity.
You can filter the conversation list using the tabs at the top:
All – every conversation on your assigned number
Unread – conversations with unread messages
Unlinked – conversations not yet linked to a deal or contact
A counter next to the WhatsApp inbox in the navigation bar shows your total unread messages and updates in real time. From here, you can open any conversation, read messages, reply and link conversations to deals or contacts.
Detail view
Open a deal or person and click the “WhatsApp” tab to see all WhatsApp conversations linked to that item. This gives you full visibility into past interactions without leaving the context of your pipeline.
How to start a WhatsApp conversation
Go to Sales Inbox > WhatsApp and click “+ Conversation”, then either select a person or enter a WhatsApp number to start a conversation. If the contact already has a phone number with a country code saved in Pipedrive, it will be pre-filled automatically.
If the contact has multiple phone numbers, you can choose the right one from the dropdown.
If the contact doesn’t have a number in Pipedrive, or the number is missing a country code, you can enter the correct WhatsApp number manually in the input field.
To continue chatting with a customer, click an existing conversation in the list.
If a conversation with a specific contact already exists, Pipedrive will prompt you to open the existing thread rather than create a new one.
How to reply with free text messages
Starting a new conversation always requires selecting an approved template first. WhatsApp only allows businesses to initiate conversations using pre-approved templates.
Once the customer replies, you can continue in free text within the first 24 hours of their first message. The composer indicates whether the service window is currently open.
Open any active conversation and type your message in the text field to continue the discussion. Once your message is ready, send it directly from the conversation view.
After 24 hours, you won’t be able to send free text messages, and you’ll be prompted to select a template to comply with WhatsApp’s policy.
If your WhatsApp account is configured for coexistence, you’ll also see a link to open the conversation directly in the WhatsApp app.
Working with WhatsApp templates
WhatsApp templates let you start new conversations or continue existing ones with pre-approved messages.
WhatsApp policy also dictates that you can only reply in free-form text within 24 hours after receiving a message from a customer. After that period, you‘re required to use a template.
Creating templates
To create a template, go to Tools and apps > WhatsApp > Templates and click “+ Template”.
In the Add template modal, you can define the template‘s category (marketing or utility), name, language, an optional text header and the message contents.
You can also include name (e.g., {{name}}) or positional (e.g., {{1}}) variables in both the header and body by clicking their respective “+ Add variable” button.
If your variables are not mapped to Pipedrive fields or if those fields are empty, you must manually enter the values before sending the message.
You can see how your message will appear in the preview pane.
Once the template is created, it needs to be approved by Meta before it becomes available for sending, which can take up to 48 hours.
You can see the current status of your newly created template in the template page.
You can also create templates using WhatsApp Manager.
Template requirements and limitations
When creating and using templates, keep the following in mind:
Templates must be approved by Meta before they can be sent
Templates are required to start or continue conversations after 24 hours of the last customer message
If variables aren’t mapped or fields are empty, you must enter values manually before sending
Template structure and content must comply with WhatsApp business platform guidelines
Meta limits the total number of templates per account. Unverified businesses can create up to 250 templates, whereas verified businesses can create up to 6,000.
Sending a template
To send a template, open a conversation and click “Send template”.
You can search and select a template based on its name, category, language or content.
After selecting a template, click “Next” and review the content to fill in any required variables. A preview will show how the message will appear to the recipient.
Click “Send” to deliver the message.
Managing templates
If you’re an admin user, you can view and manage templates in Tools and apps > WhatsApp > Templates.
To edit a template, click the “...” button at the right and select “Edit”.
The template form opens with the current content pre-filled. After saving, the updated template is submitted to Meta for review and its status returns to pending until approved again.
You can also delete a template by selecting the “Delete” option in the same menu.
Linking conversations to deals and contacts
Linking conversations lets your team see all communication in the right context. After linking the conversations, they become visible to anyone who has access to those linked items.
How conversations are linked automatically
Pipedrive automatically links new incoming messages to the matching person in your contacts (based on their phone number) and to their most recent open deal.
If multiple contacts share the same number, the conversation remains unlinked until you manually link it.
Automatic linking is enabled by default. Global admins can toggle it in Tools and apps > WhatsApp > General.
Linking to an existing deal or person
When you open a conversation that still hasn‘t been linked to a deal, you‘ll see the following buttons on the right-hand side. Choose “Link deal” or “Link person”.
The button will turn into a search field, where you can find the relevant item and select it to create the connection.
Creating and linking a new item
From the same linking options, you can create a new deal or person. Just type in the name of the new contact, and Pipedrive automatically uses the typed name as the name for the person. The same thing applies to deals.
The WhatsApp number is also saved as the contact‘s phone number, helping you keep contact data accurate without extra steps.
Changing or removing a link
To point a conversation to a different deal or person, you first need to remove the current link and then establish a new one.
You can also remove a link entirely by selecting “Unlink” from the linking options. This detaches the conversation from all Pipedrive entities.
The conversation and its messages remain accessible from the inbox.
Messaging
Working with files and media
Pipedrive archives inbound media files automatically so they remain accessible beyond WhatsApp’s original 7-day retention window.
- Images are shown inline in the conversation. Click an image to preview or download it.
- Audio messages play directly in the conversation.
- Videos and documents appear as file entries with the file type shown. You can download them directly from the message.
File browser
To view all media and documents shared in a conversation, expand the contextual sidebar and click “See files”.
The file browser opens with two tabs:
Media – shows images, videos, and audio clips grouped by month. Click any thumbnail to open a full-size preview.
Documents – lists documents in chronological order with the filename, file type, and a download link.
Scroll down in either of them to load older files.
Message delivery status
Each message you send shows its current delivery state:
Sent – WhatsApp has accepted your message
Delivered – the message has reached the customer’s device
Read – the customer has opened the message
If a message fails to send immediately, it shows an error state with a “Try again” button. Click it to resend the same message.
If WhatsApp reports a failure after the message has already left Pipedrive (for example, the recipient’s account is restricted), the message updates to an error state with the reason shown.
In this case, there is no retry option. You’ll need to compose and send a new message manually.
Message reactions
You can react to messages using emojis directly in the conversation. When a customer reacts to one of your messages, it appears in real time.
To react to a message, hover over the message and select an emoji from the reaction picker. Each message supports one active reaction per user. Sending a different emoji replaces the previous one.
To remove your reaction, click it again in the conversation.
Notifications
When a new WhatsApp message arrives on a conversation linked to a deal you own or follow, Pipedrive shows you a feed notification. The notification includes the sender‘s name and a message preview.
Click the notification to open the conversation directly in your Sales Inbox.
Was this article helpful?
Yes
No