HubSpot Deal Management Template

Enhance your AI assistant with the capability to access HubSpot deals directly during customer calls, update deal statuses, and provide sales pipeline information.

Overview

Deal Query

Automatic access to existing deals
Real-time status updates
Pipeline stage tracking
Deal value and probability

Sales Automation

Automatic deal creation
Status updates based on conversation
Schedule follow-up activities
Send team notifications

Configuring the Deal Query Tool

1. Basic Configuration

Tool Settings
API Configuration

Parameter	Value
Function Name	`get_hubspot_deals`
Description	”Fetches current deals of a contact from HubSpot. Use this when discussing existing projects or proposals.”
HTTP Method	`GET`
Timeout	`6000ms`

URL: https://api.hubapi.com/crm/v3/objects/deals/search

Headers:
  Authorization: "Bearer IHRE_HUBSPOT_API_KEY"
  Content-Type: "application/json"

Method: POST (for Search API)

2. Request Body for Deal Search

{
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "associatedcontactid",
          "operator": "EQ",
          "value": "{contact_id}"
        }
      ]
    }
  ],
  "properties": [
    "dealname",
    "dealstage", 
    "amount",
    "closedate",
    "pipeline",
    "probability",
    "createdate",
    "hs_deal_priority",
    "description"
  ],
  "sorts": [
    {
      "propertyName": "hs_lastmodifieddate",
      "direction": "DESCENDING"
    }
  ],
  "limit": 10
}

3. Parameter Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "description": "HubSpot contact ID for deal search"
    },
    "deal_stage": {
      "type": "string", 
      "description": "Filter by specific deal stage (optional)",
      "enum": ["prospecting", "qualification", "needs-analysis", "proposal", "negotiation", "closed-won", "closed-lost"]
    },
    "include_closed": {
      "type": "boolean",
      "description": "Include closed deals?",
      "default": false
    }
  },
  "required": ["contact_id"]
}

Configuring the Deal Update Tool

1. Updating Deal Status

Tool Configuration

Parameter	Value
Function Name	`update_hubspot_deal`
Description	”Updates the status or details of an existing HubSpot deal based on the conversation flow.”
HTTP Method	`PATCH`
URL	`https://api.hubapi.com/crm/v3/objects/deals/{deal_id}`

Request Body

{
  "properties": {
    "dealstage": "{new_stage}",
    "hs_deal_priority": "{priority}",
    "notes_last_updated": "{current_timestamp}",
    "hs_deal_stage_probability": "{probability}",
    "description": "{updated_description}"
  }
}

Parameter Schema

{
  "type": "object",
  "properties": {
    "deal_id": {
      "type": "string",
      "description": "ID of the deal to update"
    },
    "new_stage": {
      "type": "string",
      "description": "New deal stage",
      "enum": ["prospecting", "qualification", "needs-analysis", "proposal", "negotiation", "closed-won", "closed-lost"]
    },
    "priority": {
      "type": "string",
      "description": "Deal priority",
      "enum": ["low", "medium", "high"]
    },
    "notes": {
      "type": "string",
      "description": "Conversation notes or updates"
    }
  },
  "required": ["deal_id", "new_stage"]
}

Deal Creation Tool

Automatic Deal Generation

Basic Tool
Request Structure
Parameter Schema

FunctionName: create_hubspot_deal
HTTP-Method: POST
URL: https://api.hubapi.com/crm/v3/objects/deals

Description: "Creates a new deal in HubSpot based on the current conversation and customer requirements."

{
  "properties": {
    "dealname": "{deal_name}",
    "dealstage": "prospecting",
    "pipeline": "default",
    "amount": "{estimated_value}",
    "closedate": "{estimated_close_date}",
    "hubspot_owner_id": "{owner_id}",
    "description": "{deal_description}",
    "hs_deal_priority": "medium",
    "leadsource": "phone_call"
  },
  "associations": [
    {
      "to": {
        "id": "{contact_id}"
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 3
        }
      ]
    }
  ]
}

{
  "type": "object",
  "properties": {
    "deal_name": {
      "type": "string",
      "description": "Name of the new deal"
    },
    "contact_id": {
      "type": "string", 
      "description": "HubSpot contact ID"
    },
    "estimated_value": {
      "type": "number",
      "description": "Estimated deal value in euros"
    },
    "estimated_close_date": {
      "type": "string",
      "format": "date",
      "description": "Expected close date (YYYY-MM-DD)"
    },
    "owner_id": {
      "type": "string",
      "description": "HubSpot user ID of the responsible sales staff"
    },
    "deal_description": {
      "type": "string",
      "description": "Description of the deal based on the conversation"
    }
  },
  "required": ["deal_name", "contact_id"]
}

Combined Workflow Tool

Intelligent Deal Management

Practical Use Cases

Scenario 1: Existing Customer Calls

Customer Identification

AI identifies customer by email/phone
Automatically fetch deals for this contact

Intelligent Conversation Guidance

If active deals exist:
  "I see we currently have a proposal for [Deal Name]. 
   How can I assist you with this?"

If deal is in negotiation:
  "Do you have any questions regarding our proposal from [Date]? 
   The deal value is [Amount]."

If no active deals:
  "How can I help you today? Are you planning a new project?"

Automatic Updates

Update deal stage based on conversation
Add conversation notes
Define next steps

Scenario 2: Lead Qualification with Deal Creation

BANT Qualification

Budget Identification:

AI recognizes budget statements:
  "Our budget is approximately €50,000"
  → create_hubspot_deal with amount: 50000

"We don't have a fixed budget yet"
  → Deal with amount: 0, note: "Budget to be clarified"

Authority Check

Check decision-making authority:

Decision maker identified:
  → Deal priority: "high"
  → Owner: Senior Sales Rep

Influencer / Gatekeeper:
  → Deal priority: "medium" 
  → Next step: Decision maker meeting

Need & Timeline

Needs and timeline:

Urgent need:
  → closedate: +30 days
  → hs_deal_priority: "high"

Long-term planning:
  → closedate: +6 months
  → dealstage: "prospecting"

Response Processing

Deal Query Response

{
  "results": [
    {
      "id": "deal123",
      "properties": {
        "dealname": "Website Redesign Project",
        "dealstage": "proposal",
        "amount": "15000",
        "closedate": "2024-03-15",
        "pipeline": "sales-pipeline",
        "probability": "60",
        "createdate": "2024-01-15T10:00:00.000Z",
        "hs_deal_priority": "high",
        "description": "Complete website redesign with CMS"
      }
    }
  ]
}

Natural Language Usage

Deal Status Updates
Automatic Updates

Deal in Proposal Stage:
  "I see our proposal for the Website Redesign Project 
   is still under evaluation. Do you have any questions?"

Deal in Negotiation:
  "Regarding the €15,000 offer - can we finalize the last details today?"

Deal Close to Completion:
  "Perfect! The planned project start is March 15th. 
   Should we prepare the contract documents?"

Customer shows interest:
  → update_deal: dealstage = "needs-analysis"
  → add_note: "Customer very interested, discussed details"

Customer raises objections:
  → update_deal: hs_deal_priority = "medium"  
  → add_note: "Objections: budget concerns, follow-up needed"

Positive signals:
  → update_deal: probability = "80"
  → add_note: "Green light from customer, close likely"

Advanced Features

Pipeline Management

Multi-Pipeline Support

Different sales processes:

Standard Sales Pipeline
Enterprise Sales Pipeline
Partner/Channel Pipeline
Renewal Pipeline

Custom Deal Properties

Industry-specific fields:

Project scope
Technical requirements
Compliance requirements
ROI expectations

Deal Forecasting

Intelligent close prediction:
  Factors:
    - Current deal stage
    - Historical conversion rates
    - Customer engagement level
    - Competitive situation
  
  Output:
    - Adjusted close probability
    - Recommended next steps
    - Risk assessment

Integration with Other HubSpot Tools

Workflow Combination

Error Handling & Best Practices

Robust Error Handling

Catch API Errors

Deal not found (404):

Cause: Deal ID does not exist or was deleted
Fallback: "It seems this project is no longer current. 
          Let’s talk about your current needs."

Permission Error (403)

Cause: API key lacks permission for deals
Fallback: "I currently can't access our project database. 
          I’ll still be happy to assist you."
Action: Notify admin about permission issue

Rate Limiting (429)

Handling: 
  - Automatic retry with exponential backoff
  - Temporary fallback: "One moment, loading your project data..."
  - After 3 attempts: graceful degradation

Performance Optimization

Selective Loading
Smart Caching

Load only relevant deal properties:
  Standard: dealname, dealstage, amount, closedate
  As needed: description, custom_properties
  Avoid: associations, notes (large data volumes)

Deal cache strategy:
  Active deals: cache for 5 minutes
  Closed deals: cache for 1 hour  
  Recently modified: invalidate via webhooks

Analytics & Reporting

Key Performance Indicators

Metric	Description	Target
Deal Conversion Rate	Conversation → Deal creation	>15%
Stage Progression	Average stage movement	+1 stage per conversation
Close Rate Improvement	Improvement via tool usage	+20%
Response Time	Deal tool performance	<3 seconds

Success Tracking

Establish Baseline

Measure conversion rates before tool implementation
Document average deal sizes
Capture sales cycle lengths

Measure Tool Impact

Compare conversations with vs. without tool usage
Analyze deal quality scores
Collect customer experience feedback

Continuous Optimization

Weekly performance reviews
Monthly tool configuration adjustments
Quarterly business impact assessments

Further Integrations

Expand your HubSpot deal management with additional tools:

HubSpot Contact Retrieval for customer data
HubSpot Lead Creation for lead nurturing
Webhook Integration for complex workflows

Important Note: Deal updates directly affect sales forecasting and team performance. Ensure your sales team is informed about the automatic updates and define clear rules for critical deal changes.

Mid-Call Tools

Mid-Call Tool Integrations

HubSpot Deal Management

HubSpot Deal Management Template

Overview

Deal Query

Sales Automation

Configuring the Deal Query Tool

1. Basic Configuration

2. Request Body for Deal Search

3. Parameter Schema

Configuring the Deal Update Tool

1. Updating Deal Status

Deal Creation Tool

Automatic Deal Generation

Combined Workflow Tool

Intelligent Deal Management

Practical Use Cases

Scenario 1: Existing Customer Calls

Scenario 2: Lead Qualification with Deal Creation

Response Processing

Deal Query Response

Natural Language Usage

Advanced Features

Pipeline Management

Multi-Pipeline Support

Custom Deal Properties

Deal Forecasting

Integration with Other HubSpot Tools

Workflow Combination

Error Handling & Best Practices

Robust Error Handling

Performance Optimization

Analytics & Reporting

Key Performance Indicators

Success Tracking

Further Integrations

Mid-Call Tools

Mid-Call Tool Integrations

​HubSpot Deal Management Template

​Overview

Deal Query

Sales Automation

​Configuring the Deal Query Tool

​1. Basic Configuration

​2. Request Body for Deal Search

​3. Parameter Schema

​Configuring the Deal Update Tool

​1. Updating Deal Status

​Deal Creation Tool

​Automatic Deal Generation

​Combined Workflow Tool

​Intelligent Deal Management

​Practical Use Cases

​Scenario 1: Existing Customer Calls

​Scenario 2: Lead Qualification with Deal Creation

​Response Processing

​Deal Query Response

​Natural Language Usage

​Advanced Features

​Pipeline Management

Multi-Pipeline Support

Custom Deal Properties

​Deal Forecasting

​Integration with Other HubSpot Tools

​Workflow Combination

​Error Handling & Best Practices

​Robust Error Handling

​Performance Optimization

​Analytics & Reporting

​Key Performance Indicators

​Success Tracking

Further Integrations

HubSpot Deal Management Template

Overview

Configuring the Deal Query Tool

1. Basic Configuration

2. Request Body for Deal Search

3. Parameter Schema

Configuring the Deal Update Tool

1. Updating Deal Status

Deal Creation Tool

Automatic Deal Generation

Combined Workflow Tool

Intelligent Deal Management

Practical Use Cases

Scenario 1: Existing Customer Calls

Scenario 2: Lead Qualification with Deal Creation

Response Processing

Deal Query Response

Natural Language Usage

Advanced Features

Pipeline Management

Deal Forecasting

Integration with Other HubSpot Tools

Workflow Combination

Error Handling & Best Practices

Robust Error Handling

Performance Optimization

Analytics & Reporting

Key Performance Indicators

Success Tracking