Pre-requisites
- SMS number connected and verified — see Connect SMS and, for US numbers, SMS compliance.
- HubSpot credentials saved — see Connect HubSpot.
How conversations land in HubSpot
Setting up
Confirm SMS is connected
Open Channels → SMS in the OpenCX dashboard. Your SMS 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
Text 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
US number compliance
US number compliance
US SMS numbers require or before they can reliably deliver outbound messages. Complete this on the OpenCX side — see SMS compliance. The HubSpot integration doesn’t change the requirement.
Message length and segmentation
Message length and segmentation
SMS messages are split into 160-character segments by carriers. The full conversation appears as one logical thread in the ticket transcript. Keep follow-up replies tight — carrier costs scale per segment.
Following up from HubSpot
Following up from HubSpot
HubSpot does not have a native two-way SMS conversation thread. To reply via SMS, use the OpenCX inbox or contact the customer directly. The HubSpot ticket provides visibility and tracking.
MMS
MMS
Media sent by the customer (MMS) is included in the ticket context when the carrier supports it. Outbound MMS support depends on your SMS provider’s capabilities.
Related Documentation
AI SMS Support
The channel itself — connect, routing, compliance.
Connect HubSpot
Credentials, webhook, and email signatures.
HubSpot Overview
What else HubSpot lights up across every channel.
Troubleshooting
Missing tickets, contact not linked.