Flow description
Purpose and benefits
This workflow is designed to automate and streamline the process of managing contacts in HubSpot CRM. It provides an interactive chat-based assistant that can help users create, update, and search for contacts, ensuring that the contact list remains clean and up to date. The workflow leverages AI capabilities (OpenAI LLM) and integrates directly with HubSpot’s API, making it a powerful tool for scaling customer relationship management without manual intervention.
Workflow Overview
When a user opens the chat, they are greeted with a friendly welcome message outlining the assistant’s capabilities. The interface then offers actionable buttons for common tasks: searching for an existing contact, creating a new contact, or updating an existing contact. Based on the user’s selection or input, the workflow guides them through the required steps, collects necessary information, and interacts directly with HubSpot to execute the desired operation.
Main Components
Component | Functionality |
---|
Chat Opened Trigger | Detects when a user opens the chat and initiates the workflow |
Message Widget | Displays a customizable welcome/instruction message |
Button Widgets | Presents user with options: “Search for contact”, “Create new contact”, “Update contact” |
Chat Output | Shows messages and responses to the user |
Chat Input | Collects user input for free-form tasks and data entry |
Chat History | Maintains a record of recent chat messages for context-aware responses |
OpenAI LLM | Provides the AI assistant’s conversational and reasoning abilities |
AI Agent | Orchestrates actions, calls tools, and generates responses |
HubSpot Tools | Integrates with HubSpot API to create, update, or search for contacts |
Step-by-Step Flow
- Greeting and Options
- When the chat is opened (
ChatOpenedTrigger
), the user is greeted with a welcome message via the MessageWidget
. - The user sees clickable buttons for the main actions:
- Search for contact
- Create new contact
- Update contact
- User Interaction
- The user can click one of the buttons or type a message to specify their intent.
- Depending on the button clicked, a corresponding message is displayed via
ChatOutput
nodes to confirm the action.
- AI-Powered Assistant
- The workflow maintains recent conversation context using
ChatHistory
(last 5 messages, up to 800 tokens). - It uses an OpenAI-powered LLM (
OpenAILLM
) as the backend for understanding user requests and generating intelligent, context-aware replies. - The
AIAgent
is configured with a clear goal and backstory: it is always to use HubSpot tools for contact management, gather necessary information, and decide the correct action (create, update, or inform about existing contacts).
- HubSpot Integration
- Three tool nodes interface with HubSpot:
CreateContact
: Adds a new contact using provided details.UpdateContact
: Updates an existing contact based on provided information and contact ID.SearchContact
: Looks up contacts by properties (e.g., email, name).
- The AI agent uses these tools to perform the requested task, either by prompting the user for more details or by executing the operation directly.
- Response and Output
- After processing the request (create, update, or search), the AI agent communicates the results back to the user through the
ChatOutput
node, ensuring a seamless conversational experience.
Why is this Workflow Useful?
- Automates Routine CRM Tasks: By facilitating contact management through natural language or button clicks, it removes repetitive manual data entry and lookup tasks.
- Scalable Support: The AI agent can handle multiple concurrent requests, making it suitable for teams or customer support scenarios.
- Consistency and Data Quality: The assistant always uses the correct process, ensuring that contacts are created, updated, or searched in a standardized way.
- Context Awareness: With chat history and AI, the assistant can maintain context across multiple steps, making the conversation more natural and efficient.
- User-Friendly: The combination of guided buttons and free-form chat input makes the experience accessible for users of all technical levels.
Example Use Cases
- Sales Teams can quickly add or update contacts on the go, reducing administrative overhead.
- Customer Support can look up or amend contact records during live conversations with customers.
- Marketing Teams can ensure their lists are always up-to-date with minimal effort.
Summary Table
User Action | Outcome |
---|
Click “Search” | AI asks for search criteria, looks up contact, presents results |
Click “Create” | AI collects info (name, email, etc.), creates contact in HubSpot |
Click “Update” | AI asks for contact to update and new info, updates in HubSpot |
Type a Message | AI interprets intent, asks clarifying questions, performs requested action |
Automation & Scaling Benefits
- Reduces manual errors and omissions
- Frees up human resources for higher-value tasks
- Enables 24/7 self-service for contact management
- Provides a unified, intuitive interface for interacting with HubSpot
By leveraging this workflow, organizations can significantly enhance their CRM data hygiene, responsiveness, and operational efficiency.