Helpdesk migration
Field-level mapping, validation, and rollback between TrueEngage and HubSpot Service Hub. We move data and schema; workflows are rebuilt natively in HubSpot Service Hub.
TrueEngage
Source
HubSpot Service Hub
Destination
Compatibility
9 of 12
objects map 1:1 between TrueEngage and HubSpot Service Hub.
Complexity
BStandard
Timeline
3-5 weeks
Overview
Moving from TrueEngage to HubSpot Service Hub is a split-source migration. TrueEngage holds no independent contact database — it is a widget overlay on top of Genesys Cloud, meaning contact records, call recordings, and interaction dispositions live in Genesys Cloud while Widget configurations, routing rules, Feedback form schemas, and Cobrowse session logs live in TrueEngage itself. We extract from both sources, map interaction history into HubSpot Tickets and Conversations tied to Contacts, and preserve Feedback form submissions as survey records. Widget targeting rules, routing logic, and Cobrowse session context have no export API; we document the current GUI configuration during discovery and deliver a written rebuild guide for your admin. We do not migrate Genesys Cloud routing flows, TrueEngage automations, or WebRTC SIP infrastructure as these are non-transferable vendor-owned assets requiring new provisioning in HubSpot Service Hub.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Source platform
TrueEngage platform overview
Scorecard, SWOT, gotchas, and pricing for TrueEngage.
Destination platform
HubSpot Service Hub platform overview
Scorecard, SWOT, gotchas, and pricing for HubSpot Service Hub.
Data migration guide
The complete HubSpot Service Hub migration guide
Data model, import mechanisms, field mapping strategy, pitfalls, and cutover — by the engineers running it.
Destination checklist
HubSpot Service Hub migration checklist
Pre- and post-cutover tasks for moving onto HubSpot Service Hub.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a TrueEngage object lands in HubSpot Service Hub, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
TrueEngage
Contact (via Genesys Cloud)
HubSpot Service Hub
Contact
1:1Contact records do not live in TrueEngage — they live in Genesys Cloud. We extract contact data (name, email, phone, organization) from Genesys Cloud's Contact object via the Genesys Cloud API and map it to HubSpot Contact. The Genesys Cloud conversation participant data serves as the source of truth for contact identity. We resolve duplicates by email address during import and flag unresolved duplicates in a reconciliation report for the customer's admin.
TrueEngage
Organization (via Genesys Cloud)
HubSpot Service Hub
Company
1:1Genesys Cloud organization records map directly to HubSpot Company. The organization's primary domain becomes the Company website field. Where Genesys Cloud stores multiple divisions as separate organization records, we map each to a distinct HubSpot Company and preserve the Genesys division identifier in a custom field for reporting continuity.
TrueEngage
Interaction (chat, voice, video)
HubSpot Service Hub
Ticket + Conversation
1:1Genesys Cloud interaction records (chat, voice, video) map to HubSpot Tickets with Conversation threads. The Genesys conversationId becomes a custom field te_conversation_id__c on the HubSpot Ticket. The Genesys interaction disposition, queue, and agent assignment map to Ticket status, owner, and custom properties. Chat messages migrate as Conversation messages within the Ticket. Voice call metadata (duration, disposition code) migrates to custom ticket properties.
TrueEngage
Callback Request
HubSpot Service Hub
Ticket
1:1TrueEngage Callback Requests queued into Genesys Cloud as appointments map to HubSpot Tickets with a callback_request__c flag and the scheduled time preserved in a custom date field. The visitor's contact context (name, phone, reason) migrates as ticket properties. Where the customer used TrueEngage's immediate callback feature, we create a Ticket with status set to follow-up and attach a note with the original callback context.
TrueEngage
Cobrowse Session
HubSpot Service Hub
Ticket (as interaction note)
1:1Cobrowse session outcomes, shared-screen session IDs, and session timestamps stored in TrueEngage do not map to a native HubSpot object. We extract the session summary (session ID, outcome, duration, agent, visitor context) and append it as a private note on the associated HubSpot Ticket. If the destination HubSpot account uses a Cobrowse integration (like Acquire or Pine), we provide a field mapping template for session records to migrate there as a secondary step.
TrueEngage
Feedback Form Submission
HubSpot Service Hub
Survey Submission
1:1TrueEngage Feedback form responses (CSAT scores, NPS, custom form fields) export as a row per submission with visitor context and timestamp. We map each form schema to a HubSpot Survey (Professional and Enterprise) or to custom Ticket properties on Starter. Form question text is preserved as property labels and response values as property values. The original Feedback form schema (questions, branching logic, styling) is documented as a text artifact for manual rebuild in HubSpot Service Hub's survey builder.
TrueEngage
Widget Configuration
HubSpot Service Hub
Conversational Bot + Chatflow
lossyTrueEngage Widget settings (channel assignment, targeting rules, scheduling, branding, routing queue assignment) have no export API. We conduct a joint GUI documentation session during discovery where we capture screenshots, configuration settings, and targeting rule logic for each Widget. We deliver a written rebuild guide mapping each TrueEngage Widget to the equivalent HubSpot Conversational Bot trigger condition, Chatflow routing logic, and Inbox assignment. The customer's admin rebuilds in HubSpot Service Hub settings using the guide.
TrueEngage
Routing Rule
HubSpot Service Hub
Workflow + Inbox Routing Rule
lossyWidget-level routing rules (geographic, time-based, page-based, visitor-segment conditions) stored in TrueEngage are GUI-only with no API export. We document every active routing rule during discovery: the trigger condition, the queue or agent assignment, and the fallback action. We deliver a written routing matrix that the customer's admin uses to configure HubSpot Workflow triggers (based on contact property, ticket source, or conversation channel) and Inbox routing rules. Routing rules do not migrate as code.
TrueEngage
Agent Transfer Log
HubSpot Service Hub
Ticket (as activity note)
1:1Cross-channel transfer and escalation events during a TrueEngage interaction (chat-to-voice, voice-to-video) are recorded as transfer history in TrueEngage with Genesys Cloud handling the routing disposition. We extract transfer events from the Genesys interaction detail API, reconstruct the channel-switch sequence as a structured note on the corresponding HubSpot Ticket, and preserve the original queue and agent assignments as custom ticket properties. This preserves the session continuity context that would otherwise be lost in a flat ticket timeline.
TrueEngage
WebRTC Session
HubSpot Service Hub
Ticket (calling metadata)
1:1WebRTC voice and video calls routed through TrueEngage use a SIP trunk provisioned by TrueEngage in the customer's Genesys Cloud org. This trunk is non-transferable and must be decommissioned when migrating away. We flag the SIP termination date in the migration plan and include a telco readiness checklist for provisioning a new SIP provider (Aircall, JustCall, or a direct carrier) for HubSpot's calling feature. Historical WebRTC session records (call ID, duration, disposition) migrate as custom properties on the associated HubSpot Ticket from the Genesys interaction export.
TrueEngage
Contact Center Schedule
HubSpot Service Hub
Business Hours + Holiday Calendar
lossyTrueEngage business hours, holiday calendars, and queue availability rules are exported as schedule definitions during the discovery documentation session. We provide a written schedule inventory mapping TrueEngage queue availability windows to HubSpot Business Hours configuration and HubSpot Service Hub Holiday objects. The customer configures these manually in HubSpot Service Hub settings using the schedule inventory as the source of truth.
TrueEngage
Visitor (session-scoped)
HubSpot Service Hub
Contact
1:1TrueEngage Visitor records are ephemeral browser/app identities scoped to active Widget sessions. They are not persistent contact records. We do not migrate Visitors as standalone records. Where a Visitor record has been associated with a Genesys Cloud Contact (via a named visitor session), we migrate the Contact from Genesys Cloud. Anonymous session data (page views, session duration, proactive chat triggers) is not persisted as a persistent HubSpot object.
| TrueEngage | HubSpot Service Hub | Compatibility | |
|---|---|---|---|
| Contact (via Genesys Cloud) | Contact1:1 | Fully supported | |
| Organization (via Genesys Cloud) | Company1:1 | Fully supported | |
| Interaction (chat, voice, video) | Ticket + Conversation1:1 | Fully supported | |
| Callback Request | Ticket1:1 | Fully supported | |
| Cobrowse Session | Ticket (as interaction note)1:1 | Fully supported | |
| Feedback Form Submission | Survey Submission1:1 | Fully supported | |
| Widget Configuration | Conversational Bot + Chatflowlossy | Fully supported | |
| Routing Rule | Workflow + Inbox Routing Rulelossy | Fully supported | |
| Agent Transfer Log | Ticket (as activity note)1:1 | Fully supported | |
| WebRTC Session | Ticket (calling metadata)1:1 | Fully supported | |
| Contact Center Schedule | Business Hours + Holiday Calendarlossy | Fully supported | |
| Visitor (session-scoped) | Contact1:1 | Fully supported |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
TrueEngage gotchas
No standalone data export API for TrueEngage objects
Per-widget package billing with no prorated adjustments
Cobrowse and video session logs stored in TrueEngage, not Genesys
WebRTC SIP trunk provisioned by TrueEngage is non-transferable
HubSpot Service Hub gotchas
Rate limits throttle large migration API calls
Side conversations and Zendesk macros have no HubSpot equivalent
HubSpot stores ticket history as fragmented engagement objects
Custom Objects require Enterprise tier in HubSpot
Ticket pipeline stage probability values do not export cleanly
Pair-specific challenges
Migration approach
Discovery and source inventory
We conduct a joint discovery session to inventory the TrueEngage deployment: Widget count and channel assignment (chat, voice, video, cobrowse), active routing rules and targeting logic, Feedback form schemas and submission volume, and the Genesys Cloud configuration (queues, contact list, interaction history retention period). We also inventory the Genesys Cloud export capability: API availability, contact list size, interaction history date range, and recording storage location. The discovery output is a written scope document specifying what migrates via API, what migrates via GUI documentation, and what requires manual rebuild in HubSpot Service Hub.
Genesys Cloud contact and interaction export
We extract contact records, organization records, and interaction history from Genesys Cloud via the Genesys Cloud API (purecloud REST API v2). We export Interactions (with disposition, queue, agent, duration, and transcript where available) as a flat CSV, then enrich each record with the associated contact's HubSpot-ready properties. We run deduplication on contacts by email and flag unresolved duplicates. We also export call recordings as audio files for re-hosting on the customer's chosen storage (HubSpot Files, S3, or a CDN) with links embedded as custom Ticket properties.
TrueEngage GUI documentation session
We schedule a joint documentation session with the customer's TrueEngage admin to capture Widget configurations, routing rules, Feedback form schemas, schedule definitions, and Cobrowse session log formats. We document by walking through each active Widget in the TrueEngage GUI, capturing screenshots, rule logic, and queue assignments. This session produces the written rebuild guide that the customer's HubSpot admin uses post-migration to reconstruct Widget-equivalent functionality in HubSpot Service Hub (Conversational Bots, Chatflows, Inbox routing rules, and Business Hours). This step cannot be automated and is scoped as a fixed-time workshop rather than an open-ended audit.
HubSpot Service Hub schema preparation
We configure the HubSpot Service Hub destination portal: Ticket pipelines and stages (matching the Genesys queue structure), custom ticket properties for interaction metadata (te_conversation_id__c, cobrowse_session__c, call_disposition__c), Business Hours and Holiday Calendars (mapped from the TrueEngage schedule inventory), Survey objects (mapped from Feedback form schemas), and Inbox routing rules (prepared by the customer using the rebuild guide). We deploy custom properties via the HubSpot API before any record import. We also verify the HubSpot calling plan or third-party SIP integration is provisioned so that web calling is active at cutover.
Sandbox migration and reconciliation
We run a full migration into HubSpot Service Hub using a test portal or sandbox-like import run. We import Contacts and Companies first (with deduplication report), then Tickets with Conversation threads, then Survey submissions. The customer's admin reconciles record counts (contacts imported vs source count, tickets imported vs interaction count), spot-checks 25-50 random records against the Genesys Cloud source, and validates that Genesys conversation IDs map correctly to HubSpot Ticket IDs. Any field mapping corrections, custom property additions, or pipeline stage adjustments happen here before production migration.
Production migration and Widget rebuild handoff
We run the production migration in dependency order: Contacts and Companies first, then Tickets with Conversations, then Survey submissions. Interaction batch imports run as rate-limited overnight jobs. We run a delta migration to capture any records created or updated in Genesys Cloud during the production migration window. At cutover, we deliver the Widget rebuild guide to the customer's HubSpot admin and schedule a handoff call to walk through the routing rule and targeting logic equivalencies. We do not rebuild Widgets or routing rules in HubSpot Service Hub; that is an admin rebuild task guided by our documentation. We support a one-week hypercare window for reconciliation issues raised during the first production week.
Platform deep dives
TrueEngage
Source
Strengths
Weaknesses
HubSpot Service Hub
Destination
Strengths
Weaknesses
Complexity grading
Standard Helpdesk migration. 2 of 7 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across TrueEngage and HubSpot Service Hub.
Object compatibility
2 of 7 objects need a mapping; the rest are 1:1.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
7-object category — typical timelines run 2–7 days end-to-end.
API constraints
TrueEngage: Not publicly documented.
Data volume sensitivity
TrueEngage doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during TrueEngage to HubSpot Service Hub migration scoping. Not seeing yours? Book a call.
Walk through your TrueEngage to HubSpot Service Hub migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave TrueEngage
Other ways to arrive at HubSpot Service Hub
Same-Helpdesk migrations
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.