Pre-requisites
- Email forwarding configured — see Connect Email.
- HubSpot credentials saved — see Connect HubSpot.
How conversations land in HubSpot
Setting up
Confirm email forwarding works
Open Channels → AI Email in the OpenCX dashboard. Your forwarding address should be listed and verified. Send a test email and confirm it reaches the Inbox.
Confirm HubSpot is connected
In Settings → Integrations, open HubSpot. The status should show the integration is active and the webhook URL is configured.
Set up email signatures (optional)
If you want branded signatures on outgoing replies, configure them now. See Email signatures.
Trigger a test handoff
Send a test email to your connected address and respond with something that causes the AI to escalate. Or go to the Inbox and manually hand off the session.
Verify in HubSpot
A ticket should appear tagged
opencx_handedoff with the conversation summary and transcript. Reply publicly from HubSpot and confirm:- The reply arrives in the customer’s email inbox.
- Your email signature is appended (if configured).
- The reply shows as an agent message in the OpenCX Inbox.
What the rep sees
- A HubSpot ticket tagged
opencx_handedoffwith the conversation summary as the description. - A conversation thread in the HubSpot inbox with the full AI-to-customer exchange.
- The contact’s HubSpot record linked to the ticket (name, email, company, deals).
- An internal handoff note with the AI’s escalation reason, sentiment, and language.
- Public replies are delivered to the customer’s inbox with the configured email signature.
Channel-specific details
Per-domain email signatures
Per-domain email signatures
Outgoing email replies through HubSpot automatically append the signature configured for the sender’s email domain. Exact domain matches take priority over wildcard patterns. Set up signatures at Settings → Integrations → HubSpot — see Email signatures.
HTML formatting preserved
HTML formatting preserved
AI-generated replies are converted to HTML before sending through HubSpot’s email channel. Formatting — bold, lists, links — renders correctly in the customer’s email client.
Ticket-append on returning contacts
Ticket-append on returning contacts
If the same contact re-engages before the ticket is closed, OpenCX appends to the existing ticket instead of creating a new one. Your reps keep context and your reports don’t inflate.
Public vs internal replies
Public vs internal replies
Only public replies from HubSpot are delivered to the customer. Internal notes stay private — they never reach the customer’s inbox. Double-check you’re posting publicly, not as an internal comment.
Related Documentation
AI Email Support
The channel itself — forwarding setup, flow, troubleshooting.
Connect HubSpot
Credentials, webhook, and email signatures.
HubSpot Overview
What else HubSpot lights up across every channel.
Troubleshooting
Tickets not created, replies not syncing, signatures missing.