Pre-requisites
- WhatsApp Business number connected — see Connect WhatsApp.
- HubSpot credentials saved — see Connect HubSpot.
How conversations land in HubSpot
Setting up
Confirm WhatsApp is connected
Open Channels → WhatsApp in the OpenCX dashboard. Your WhatsApp Business number should be listed and active.
Confirm HubSpot is connected
In Settings → Integrations, open HubSpot. The status should show the integration is active.
Trigger a test handoff
Send a WhatsApp message to your connected number and ask to speak to a human. The AI should hand off.
What the rep sees
- A HubSpot ticket tagged
opencx_handedoffwith the conversation summary and full transcript. - The contact’s phone number and any prior HubSpot history linked to the ticket.
- An internal handoff note with the AI’s escalation reason, sentiment, and language.
- A link to the full OpenCX session for detailed AI reasoning and tool call history.
Channel-specific details
24-hour messaging window
24-hour messaging window
WhatsApp limits free-form replies to 24 hours after the customer’s last message. Outside that window, outbound messages require an approved . This constraint applies to follow-up from any channel, not just HubSpot.
Media messages
Media messages
Images, audio, and documents the customer sends on WhatsApp are included in the ticket as context. Size limits follow WhatsApp’s per-media-type limits.
Following up from HubSpot
Following up from HubSpot
HubSpot does not have a native two-way WhatsApp conversation thread. To reply on WhatsApp, use the OpenCX inbox or contact the customer directly. The HubSpot ticket provides visibility and tracking.
Related Documentation
AI WhatsApp Support
The channel itself — connect, messaging rules, templates.
Connect HubSpot
Credentials, webhook, and email signatures.
HubSpot Overview
What else HubSpot lights up across every channel.
Troubleshooting
Missing tickets, contact not linked.