Skip to main content

How Hanc.AI Works

This page explains how the Hanc.AI platform works — how you speak, the AI understands, and responds naturally.

How It Works: The Simple Version

The Hanc.AI platform handles all the complexity behind the scenes. You configure your agent's personality, knowledge, and behavior — the platform takes care of everything else.


Call Flow: Step by Step

Scenario: Customer Calls Your Business

Here's what happens when a customer calls your phone number connected to a Hanc.AI agent:


What Your Agent Can Do

Tools (During Call)

While the AI is processing a conversation, it can trigger tools in real time:

ToolDescription
Call Forwarding / Agent TransferTransfer the call to a human operator, another number, or a specialist sub-agent
Google / Outlook CalendarCheck availability and create calendar events
Appointment BookingBook appointments with SMS/email confirmations
HubSpot CRMRead and write HubSpot contacts and deals during the call
MCP serversCall tools exposed by your registered MCP-compatible servers
API ToolCall external APIs to fetch or send data in real time
End CallGracefully end the conversation

Actions (Three Phases)

Actions run automatically across three phases — they are not post-call only:

PhaseWhen it runsExamples
Pre-fetchBefore the call startsLook up the caller in a CRM or API to personalize the greeting
LiveDuring the callSend an SMS or email in real time, push data to an external system
Post-callAfter the call endsFollow-up email, SMS, WhatsApp message, or an API call (e.g. update CRM, create a ticket)

Each action can carry data the agent extracted during the conversation (Retrieval Variables).

Data Retrieval

During the call, the agent can collect structured data from the caller using data retrieval fields (e.g., name, email, phone number, preferred date). This data is saved with the call log and can be used in actions or exported.

Knowledge Base

Your agent uses a knowledge base to answer questions accurately. When a caller asks something, the AI searches your uploaded documents to find the right answer.


Data Flow

What Data is Stored?

Data Privacy

Data TypeStorageRetentionAccess
Call recordingsEncrypted cloud storageConfigurableWorkspace admins only
TranscriptsDatabaseConfigurableWorkspace members
Knowledge BaseDatabase + Vector storeUntil deletedWorkspace members
User accountsDatabaseUntil account deletionUser + admins
AnalyticsAggregated database12 monthsWorkspace members

Integration Points

Phone Integration

Connect phone numbers to your agents so customers can call and speak with your AI assistant.

Calendar Integration

Webhook Integration


Performance

Response Time

Typical end-to-end response time is 1-3 seconds — fast enough for natural conversation.

Scalability

The platform handles:

  • Concurrent calls: Hundreds of simultaneous conversations
  • Knowledge base size: Millions of document chunks
  • Global availability: Multi-region deployment

Security Architecture


The Complete Call Flow

Here is the full flow of a voice conversation on Hanc.AI:

  1. Before the call — Pre-fetch actions can look up the caller (CRM/API) to personalize the greeting
  2. Customer speaks — via phone call or website widget
  3. AI understands — the platform converts speech to meaning in real time
  4. AI processes — using the system prompt, conversation history, and relevant knowledge base context
  5. Tools triggered — if needed, the AI can call tools during the conversation (check Google/Outlook Calendar, forward the call or transfer to a sub-agent, read/write HubSpot, call an MCP server or API, book an appointment)
  6. Live actions — the agent can send an SMS or email or push data mid-call
  7. AI responds — the response is delivered as natural-sounding speech
  8. Customer hears response — the conversation continues naturally
  9. After the call — Post-call actions fire (email, SMS, WhatsApp, API calls) and data retrieval results are saved

Summary

The Hanc.AI platform combines multiple technologies:

  1. Voice Processing — Real-time speech understanding and natural voice responses
  2. AI Intelligence — Advanced AI for understanding and response generation
  3. Knowledge Retrieval — Business-specific information lookup
  4. Telephony — Phone number management and call routing
  5. Tools — Call forwarding, agent transfer, Google/Outlook Calendar, HubSpot CRM, MCP servers, and API tools during calls
  6. Actions — Pre-fetch, live, and post-call automations (email, SMS, WhatsApp, API triggers)
  7. Data Retrieval — Structured data collection during conversations

All these work together seamlessly so you can focus on configuring your agent's personality and knowledge, while the platform handles the technical complexity.


Next Steps