Connect WhatsApp to the HubSpot Conversations Inbox
Integrating WhatsApp with your HubSpot conversations inbox lets your team manage customer messages from a single shared workspace while keeping records organized and searchable. This guide walks you through the requirements, setup steps, and key options so you can get your WhatsApp Business account working smoothly inside HubSpot.
Before You Connect WhatsApp to HubSpot
Before you add WhatsApp as a channel, confirm that you meet all technical and account requirements. This helps avoid connection errors and ensures that messages are synced correctly.
Core requirements for HubSpot and WhatsApp
- You must use a WhatsApp Business number, not a personal WhatsApp account.
- The phone number you connect must be able to receive SMS or voice calls for verification.
- You must have the correct role or permissions in your HubSpot account to manage channels and inbox settings.
- Your WhatsApp number cannot be actively connected to another WhatsApp Business Platform integration at the same time.
If you are migrating from another provider, make sure you fully disconnect the number there before connecting it inside HubSpot.
Permissions and access inside HubSpot
Only specific users can add or modify channels for the conversations inbox. Typically you need one of the following:
- Super admin access in HubSpot.
- Permission to edit shared inbox settings and channels.
- Access to the target conversations inbox where WhatsApp will be added.
Check with your portal administrator if you do not see the option to connect WhatsApp in the settings.
How to Add WhatsApp to the HubSpot Inbox
Once you confirm your requirements, you can start the connection process. The steps below describe the standard flow to add WhatsApp as a channel in your HubSpot conversations inbox.
Step 1: Open the conversations inbox settings in HubSpot
- Sign in to your HubSpot account.
- In the main navigation, go to Conversations and select Inbox.
- From the inbox view, click the Settings icon to open channel management.
If you use multiple inboxes, choose the specific inbox where you want WhatsApp messages to appear before proceeding.
Step 2: Start the WhatsApp connection
- In the inbox settings, locate the Channels section.
- Select the option to connect a new channel.
- Choose WhatsApp from the available channel types.
HubSpot will prompt you to sign in with your Facebook account, because WhatsApp Business accounts are managed through Meta’s business infrastructure.
Step 3: Connect your Facebook and WhatsApp Business accounts
- Log in with the Facebook user that has access to the appropriate Meta Business Manager.
- Follow the on-screen wizard to select or create a WhatsApp Business account.
- Choose the phone number you want to use, or register a new one if needed.
- Verify your number by SMS or voice call when prompted.
During this process, you authorize HubSpot to access WhatsApp Business messaging for the selected number. Make sure you pick the correct business and phone number, especially if you manage multiple brands.
Step 4: Match WhatsApp to a HubSpot inbox
After verification, you can finalize the connection inside HubSpot:
- Select the conversations inbox that will receive WhatsApp messages.
- Confirm the channel name and any basic configuration offered by the setup wizard.
- Save your changes to complete the connection.
Once saved, your WhatsApp number appears as a channel in the selected inbox. New customer conversations from WhatsApp will now create threads in that shared workspace.
How WhatsApp Works Inside HubSpot
After setup, your team can work with WhatsApp messages almost like email or chat within the same HubSpot interface.
Routing and team access in the HubSpot inbox
Depending on your inbox configuration, WhatsApp conversations can be:
- Assigned automatically using routing rules.
- Assigned manually by agents.
- Left unassigned in a shared queue for any user with inbox access.
All replies are sent through WhatsApp while remaining visible in the unified thread in HubSpot.
Tracking contacts and conversations in HubSpot
Each WhatsApp message thread is linked to a contact record based on the phone number. Your team can:
- View full conversation history in the contact timeline.
- Add notes and internal comments on the same thread.
- Log follow-up tasks or tickets from the inbox.
This makes it easier to maintain context across channels and keep engagement data in one CRM-driven view.
Manage and Edit WhatsApp Settings in HubSpot
After the initial setup, you can return to the inbox settings to manage your WhatsApp channel.
Update channel settings
In the conversations inbox settings area, you can:
- Review which WhatsApp number is connected to each inbox.
- Adjust assignment rules and availability.
- Update general inbox configuration that affects all channels, including WhatsApp.
If you change roles or team structures, revisit these settings so that WhatsApp messages always reach the right owners.
Disconnect or change your WhatsApp connection
If you need to remove a WhatsApp number from HubSpot or connect a different one:
- Open Conversations > Inbox in HubSpot and go to Settings.
- Locate the WhatsApp channel in the channel list.
- Select the option to remove or disconnect the channel, following the prompts.
After disconnecting, that number will no longer send or receive messages through HubSpot. If you intend to use the number with a different provider, be sure to fully complete the disconnection first.
Troubleshooting the HubSpot WhatsApp Connection
If you encounter issues during connection or while sending messages, review the most common problem areas before escalating to support.
Common connection issues between HubSpot and WhatsApp
- Verification failures: Confirm your phone can receive SMS or voice calls and that you enter the exact code provided.
- Permissions errors: Make sure the Facebook user you log in with has the right access to the relevant Business Manager and WhatsApp assets.
- Number already in use: Check whether the WhatsApp Business number is still connected to another integration or provider.
In many cases, disconnecting the number from other tools and restarting the authorization process resolves these issues.
Messages not appearing in the HubSpot inbox
If customers are sending WhatsApp messages but you do not see them in the HubSpot inbox:
- Verify that the correct WhatsApp number is connected to the expected inbox.
- Confirm that your team members have access to that inbox.
- Check channel status in settings to be sure the connection is active.
Also verify that customers are messaging the exact number you connected, including the correct country code.
Where to Learn More About HubSpot and WhatsApp
For detailed, up-to-date screenshots and step-by-step guidance, review the official HubSpot documentation on connecting WhatsApp to the conversations inbox at this support page. For broader CRM and revenue operations strategies that build on this integration, explore expert resources and services at Consultevo.
Once your WhatsApp Business number is live inside HubSpot, your team gains a central place to track conversations, collaborate on replies, and keep every interaction tied back to contact records and reporting. That unified view makes it easier to deliver responsive, consistent service on one of your customers’ favorite messaging channels.
Need Help With Hubspot?
If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.
“`
