What This Integration Does
This integration connects your WhatsApp Business account to HubSpot, so every WhatsApp conversation is logged against the correct contact record in your CRM. When a customer messages your business on WhatsApp, the conversation appears on their HubSpot timeline. When your team sends a WhatsApp template message — an order confirmation, appointment reminder, or follow-up prompt — the delivery status and any replies are tracked in HubSpot alongside every other interaction with that contact.
WhatsApp is often the preferred communication channel for customers, particularly in international markets and service-oriented industries. But without integration, those conversations live in the WhatsApp Business app or a shared inbox, disconnected from the CRM where your team manages the relationship. A sales rep checks HubSpot for context before calling a customer and sees emails and meeting notes but nothing about the WhatsApp conversation their colleague had yesterday. This integration eliminates that blind spot.
The connection works through the WhatsApp Business API (not the consumer app), which provides the programmatic access needed for automated message delivery, webhook-based message receipt, and template message management. HubSpot receives the data as custom timeline activities, giving your team a single view of the entire customer relationship regardless of channel.
The Workflow
The integration operates bidirectionally through the WhatsApp Business API and HubSpot’s CRM APIs.
Outbound template messages are triggered by HubSpot workflows. When a contact meets enrolment criteria — deal stage change, ticket update, upcoming appointment — the workflow fires a request to the integration. The endpoint selects the pre-approved WhatsApp template, populates dynamic variables from the HubSpot record, and submits through the WhatsApp Business API. Delivery status (sent, delivered, read) is written back to the contact timeline.
Inbound messages arrive via WhatsApp webhooks. The integration matches the sender’s phone number to a HubSpot contact (or creates one), and logs the message as a timeline activity. If the 24-hour service window is open, your team can reply freely. If it has closed, the integration enforces template-only messaging to prevent policy violations.
Media messages — images, documents, voice notes — are downloaded, stored, and linked from the HubSpot activity record. Session state is tracked per contact and surfaced in HubSpot so reps always know whether they can reply freely or must use a template.
Before and After
Before: WhatsApp conversations happen in a shared Business app or a third-party inbox tool. When a team member discusses pricing, answers a product question, or handles a support issue over WhatsApp, that conversation is invisible to HubSpot. Account managers reviewing a contact record before a call see emails and notes but have no idea what was discussed on WhatsApp last week. Template messages (appointment reminders, order updates) are sent through a separate tool with its own contact list that has to be manually synchronised with HubSpot.
After: Every WhatsApp message — inbound and outbound — appears on the HubSpot contact timeline with timestamps and delivery status. Template messages are triggered by HubSpot workflows using live CRM data for personalisation. The 24-hour session window is tracked and visible, so your team knows when they can reply freely. Media attachments are accessible from the contact record. WhatsApp becomes another channel in HubSpot’s communication history, not a separate silo.
Who Needs This
This integration is for businesses that use WhatsApp as a significant communication channel with customers and manage their relationships in HubSpot. It is particularly relevant for:
- Service businesses where customers prefer WhatsApp for queries, appointment changes, and status updates
- International businesses where WhatsApp is the dominant messaging platform
- Sales teams that use WhatsApp for prospect communication and need conversations visible in the CRM
- Support teams handling issues across multiple channels who need a unified interaction history
- Any team sending template messages that should be triggered by CRM events rather than managed manually
If your customers are already messaging you on WhatsApp and that conversation history disappears when someone leaves the team or a colleague takes over the account, this integration solves that problem.
How We Build This
We start with your WhatsApp Business API setup. If you are already using the API through a Business Solution Provider (BSP), we integrate with your existing configuration. If you are on the standard WhatsApp Business app, the first step is migrating to the API, which we handle as part of the project.
Template messages are defined and submitted for WhatsApp approval during setup, each mapping to a HubSpot workflow use case with dynamic variables from contact and deal properties.
The middleware handles message routing, phone number matching, session tracking, and media management. HubSpot receives data through custom timeline event types configured to display WhatsApp messages with visual distinction from other activity types.
Compliance is built in. Opt-in status is tracked per contact. The session window is enforced programmatically. Template messages go through WhatsApp’s approval process. Your team cannot accidentally violate policy because the integration prevents it at the system level.
Testing covers template delivery, inbound logging, media handling, session enforcement, and contact matching including edge cases like multiple phone numbers per contact.
Make WhatsApp Part of Your CRM
If WhatsApp conversations are happening outside your CRM, your team is working with an incomplete picture of every customer relationship. Get in touch to connect WhatsApp to HubSpot and bring those conversations into one place.
Related pages:
Alex
I’m a software developer and CEO of Digital Royalty, helping growing teams scale their SaaS platforms without losing quality, visibility, or control. I focus on building structured, maintainable systems with clear processes, reporting, and accountability. With over a decade of experience across agency and in-house roles, I specialise in delivering long-term, scalable solutions that support complex, evolving products.