Skip to main content

HubSpot CRM & Support Integration Guide

Connecting Vibemap Hub user workflows with enterprise CRM customer success and support channels.

Executive Overview & Value Proposition​

Customer success for municipal and district partners requires rapid, contextual support. When a district director or DMO marketer has a question about map configuration or event approval, switching between email, ticketing portals, and third-party chat creates friction.

Vibemap integrates HubSpot CRM directly into the authenticated Hub shell:

  • Contextual In-App Chat: One-click live chat drawer powered by the HubSpot Conversations SDK.
  • Automated Identity Enrichment: User email, name, organization, and role are passed automatically to HubSpot on login.
  • Intelligent Knowledge Deflection: Users can search self-serve guides or transition to a live agent in one fluid drawer.
  • Unified Ticket Routing: Conversations automatically associate with the client’s organization record in HubSpot.

Technical Implementation​

flowchart TD
A["User Signs Into Vibemap Hub"] --> B["identifyHubSpotUser() Hook"]
B --> C["HubSpot Conversations SDK\n(NEXT_PUBLIC_HUBSPOT_PORTAL_ID)"]
D["User Opens Help Drawer"] --> E{"Need Live Assistance?"}
E -->|"Self-Serve"| F["Browse In-Hub Guides & Docs"]
E -->|"Live Chat"| G["openHubSpotChat() Drawer Launcher"]
G --> H["HubSpot CRM Help Desk &\nSupport Inbox"]

1. Portal Configuration & Programmatic Launcher​

To prevent intrusive floating chat bubbles and greeting prompt overlays from cluttering administrative tables and map views, the HubSpot Conversations integration sets loadImmediately: false in window.hsConversationsSettings.

Chat sessions are loaded on-demand and opened programmatically via openHubSpotChat() (triggered from the in-app Help Drawer), and torn down via widget.remove() when the chat window is closed.

2. User Identification (identifyHubSpotUser)​

When an authenticated user session is active, the Hub triggers identity tracking:

identifyHubSpotUser({
email: user.email,
name: user.name,
organization: activeTenant.name,
role: user.role,
});

This ensures tickets, chat transcripts, and engagement history are automatically linked to the proper district account in HubSpot CRM.

3. Programmatic Chat Launcher​

The in-app Help Drawer (modules/admin/src/components/help/HelpDrawer.tsx) features a "Start Chat" action that programmatically opens the HubSpot drawer using openHubSpotChat().