Skip to content
Try Free →

HubSpot integration use cases

Last updated: · 5 min read

1. Auto-create CRM leads from chat

The most common pattern. When the collect_lead skill captures contact info, AskVault pushes a new contact to HubSpot within 60 seconds.

How it works:

  1. Visitor shows buying intent ("how much does this cost?", "I want to demo").
  2. The collect_lead skill fires and asks for name, email, and optionally phone.
  3. AskVault posts to HubSpot's Contacts API with the visitor's info.
  4. A new HubSpot contact record is created with source = "AskVault Chat".
  5. The conversation transcript attaches as an activity on the contact.

Pattern works for marketing-site chat, hosted page, WhatsApp, and other channels. Conversion rate from chat-to-CRM-record: typically 5 to 15% for visitors who engage with the bot.

Setup: connect HubSpot via HubSpot setup, enable collect_lead skill, map fields under Integrations > HubSpot > Field Mapping.

2. Sync conversation history to contact records

After every conversation, AskVault writes the full transcript to the matched HubSpot contact:

  • Activity type: "Chat conversation" (custom HubSpot activity).
  • Body: Full message-by-message transcript.
  • Properties: Channel, duration, agent (if escalated), conversation outcome.
  • Attachments: Any files shared during the conversation.

Useful for sales reps to see context before reaching out:

Acme Inc. asked about pricing on the widget on May 10. They mentioned a 50-person team and integration with Slack. Lead score: 75.

Sync latency: about 30 seconds from conversation end.

3. Qualify leads via BANT before CRM sync

Pushing every chat visitor to HubSpot clutters the CRM. Better pattern: qualify first, then sync only qualified leads.

The sdr_lead_qualifier skill asks BANT questions:

  • Budget. "What's the rough budget range for this?"
  • Authority. "Are you the decision-maker, or part of an evaluation team?"
  • Need. "What problem are you trying to solve?"
  • Timing. "When are you looking to make a decision?"

Based on answers, the lead gets a 0-100 score. Only leads above a threshold (default 50) sync to HubSpot. Lower-scored conversations stay in AskVault for marketing nurture but don't pollute the CRM.

Configure the threshold under Skills > sdr_lead_qualifier > Sync Threshold.

4. Route hot leads to sales reps

For leads scoring above 80 (or any custom threshold), trigger HubSpot's lead-routing:

  1. AskVault flags the contact with a custom property askvault_hot_lead = true.
  2. HubSpot workflow picks it up and assigns the contact to the appropriate sales rep based on territory, deal size, or industry.
  3. Rep gets notified via HubSpot, Slack, or email within 60 seconds.
  4. Optionally, the bot offers a demo booking via the demo_scheduler skill before the rep even reaches out.

Faster speed-to-lead is a strong predictor of closed-won. Industry research finds responding within 5 minutes is 8x more likely to convert than responding after 30 minutes.

5. Update existing contacts on return visit

When a known HubSpot contact returns to the chat, AskVault:

  • Matches by email (with identity verification) or by name+ip heuristic.
  • Pulls the contact's stage from HubSpot (Subscriber, Lead, MQL, SQL, Opportunity, Customer).
  • Personalizes the conversation:
    • Subscribers see educational content.
    • MQLs see product demo offers.
    • Customers see support-routed answers.
  • Updates the contact's lifecycle stage based on conversation outcome.

Personalization lifts conversation engagement noticeably; segment-aware responses convert 2 to 3x better than generic ones.

Field mapping

By default, AskVault syncs these fields to HubSpot:

AskVault fieldHubSpot property
Visitor namefirstname, lastname
Emailemail
Phonephone
Source channellead_source (custom)
Conversation transcriptActivity body
Lead scoreaskvault_lead_score (custom property)
BANT databudget, authority, need, timing (custom properties)

Override mappings under Integrations > HubSpot > Field Mapping. Add custom properties to capture industry-specific data (company size, use case, etc.).

Webhook events from HubSpot

Two patterns for the reverse direction (HubSpot → AskVault):

Lifecycle stage change. When a HubSpot contact moves from MQL to SQL, fire a webhook to AskVault. AskVault updates the visitor's audience tag so subsequent conversations get sales-routed content.

Deal stage change. When a deal moves to "Closed Won", AskVault tags the contact as customer for future support-routed conversations.

Configure under Integrations > HubSpot > Webhooks > Inbound Events.

Lead deduplication

HubSpot deduplicates contacts by email. AskVault relies on this:

  • Same email, multiple conversations. AskVault appends each conversation as a new activity on the existing contact.
  • Different emails, same person. HubSpot's "merge contacts" workflow handles. AskVault re-points to the surviving record post-merge.
  • No email captured. AskVault holds the conversation locally; sync triggers only after email capture.

Avoids duplicate contact pollution.

Plan considerations

Use cases by plan:

  • Free. No HubSpot integration.
  • Starter. Basic contact sync (no lead scoring or BANT).
  • Growth. Full lead capture, BANT qualifier, transcript sync. Growth+
  • Business. Adds custom property mapping, custom workflows, larger query quota. Business+
  • Enterprise. SSO between AskVault and HubSpot, dedicated infra.

Most B2B SaaS teams settle on Growth or Business depending on deal volume.

Sample sales workflow

End-to-end pattern:

  1. Visitor lands on pricing page. Widget greets with a context-aware welcome.
  2. Visitor asks about Enterprise plan. Bot answers, then triggers collect_lead.
  3. Visitor provides email, name, company.
  4. sdr_lead_qualifier asks BANT questions. Visitor reveals: $50k budget, decision-maker, replacing legacy tool, 6-month timeline.
  5. Lead score = 88. Above threshold.
  6. AskVault creates HubSpot contact with all data within 60 seconds.
  7. HubSpot workflow assigns to Enterprise AE Sarah based on territory rules.
  8. Sarah gets a Slack notification. Reviews context, reaches out within 5 minutes.
  9. Bot offers Calendly slot via demo_scheduler. Visitor books for tomorrow.
  10. Sarah joins demo prepared. Closes faster because she had full context.

This flow lifts demo-bookings noticeably vs traditional form-based lead capture.

Privacy and GDPR

What we send to HubSpot:

  • Contact data (name, email, phone) only after the visitor provides it.
  • Conversation transcripts only for matched contacts.
  • Custom property values per your mapping.

Compliance:

  • GDPR data deletion. Deleting a contact in HubSpot doesn't delete in AskVault. Delete in both, or use the bidirectional-sync option (Enterprise feature).
  • EU data residency. AskVault supports EU-region storage for Enterprise contracts.
  • HubSpot's own GDPR posture applies on their side.

See GDPR compliance.

Planned features (on the roadmap)

Documented for accuracy:

  • Bidirectional contact sync. Today, AskVault → HubSpot is real-time; HubSpot → AskVault is webhook-triggered. Full bidirectional sync planned.
  • Deal-stage automation. Today, manual workflow setup in HubSpot. Native deal-stage actions from AskVault planned.
  • Custom-object support. Today, contacts and activities. Custom-object sync (companies, deals, custom records) planned.

Common pitfalls

Duplicate contacts in HubSpot. Same person captured twice with different emails. Use HubSpot's contact-merge tool, or enable AskVault's email-normalization (lowercase, strip plus-aliases) under field mapping.

Lead score not appearing in HubSpot. Custom property not created in HubSpot. Create the property manually (HubSpot doesn't auto-create from inbound API).

Conversation transcripts not syncing. OAuth scope missing. Re-authorize HubSpot with all required scopes.

Hot-lead routing fires too often. Threshold too low. Bump from 50 to 75 under Skills > sdr_lead_qualifier.

FAQ

Does this work with HubSpot Free?

Yes for basic contact sync. Custom properties and workflows require HubSpot Starter or above.

Can I use this with Salesforce instead?

Yes, via Salesforce integration. The patterns are the same.

How long does setup take?

About 30 to 60 minutes including OAuth, field mapping, and testing with a sample conversation.

Can I send conversations to HubSpot only for qualified leads?

Yes. Set the sync threshold on sdr_lead_qualifier to control which conversations push to CRM.

What if my HubSpot is full-funnel (marketing + sales + service)?

Works the same. Conversations route to the appropriate hub based on the contact's lifecycle stage.

Was this page helpful?