Integrations
Integrations extend your voice agents by connecting to external services. This section covers all available integrations and how to configure them.
Available Integrations
| Integration | Purpose | Status | Plans |
|---|---|---|---|
| Phone Numbers | Phone numbers and calls | Available | All |
| SIP Trunk | Bring your own carrier (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom) | Available | All — requires compliance approval |
| Google Calendar | Appointment scheduling via Google | Available | All |
| Outlook Calendar | Appointment scheduling via Microsoft Outlook | Available | All |
| HubSpot CRM | Read/write contacts and deals from your voice agent | Available | All |
| MCP servers | Bring your own MCP-compatible tool server and expose its tools to agents — see MCP Servers | Available | All |
| API Keys | External application access | Available | All |
| Webhooks | Real-time event notifications | Available | All |
Calendar integrations, SIP, HubSpot, MCP servers, API access, and webhooks are available on all plans, including Free. SIP trunking requires a one-time compliance approval before the connection wizard unlocks.
Phone Number Setup
Phone numbers allow your agents to receive and make real phone calls.
Setup Steps
- Go to Phone Numbers in the sidebar
- Click "Buy Number"
- Select country and number type
- Complete purchase
- Assign an agent to the number
Numbers are automatically configured and ready to use after purchase.
SIP Trunk Integration
Bring your own SIP carrier — HANC speaks SIP natively and routes inbound calls into your voice agent (and outbound calls back through your trunk). Available on all plans including Free after a one-time compliance approval.
Supported Carriers
HANC has tuned adapters for the following carriers, plus a generic option for anything else:
| Carrier | Auto-import numbers via API | Notes |
|---|---|---|
| sipgate | Yes (Personal Access Token) | EU SIP trunking |
| Placetel | Manual | German VoIP, Webportal credentials |
| TENIOS | Manual | European SIP |
| easybell | Manual | German carrier, Kundencenter credentials |
| Zadarma | Yes (optional API key) | Global numbers |
| Twilio (BYO) | Yes | Account SID + Auth Token |
| Telnyx | Yes | API-driven SIP and DIDs |
| Custom SIP trunk | Manual | Any other provider — supply host, port, transport |
Compliance Approval
SIP carrier connections share the same compliance flow as outbound campaigns. Until your account is approved, the Connect SIP button opens a showcase modal listing all supported carriers with a mailto:support@hanc.ai CTA. Approval is usually same-business-day.
Setup Steps (after approval)
- Go to Phone Numbers → Connect SIP.
- Pick your carrier.
- Enter SIP credentials (and optional API key/secret if your carrier supports auto-import).
- For Custom SIP, also supply host, port (default 5060), and transport (UDP / TCP / TLS).
- Click Connect — HANC registers your SIP user and, where supported, lists your phone numbers.
- Select numbers to import (or add manually by E.164).
- Assign an inbound and/or outbound agent on each number.
When to Use SIP vs. Buying a Number
| Scenario | Recommendation |
|---|---|
| New to phone service | Buy numbers through HANC (simpler — no compliance step) |
| Existing PBX or carrier contract | Connect via SIP — keep your number |
| Enterprise telephony with strict carrier requirements | SIP for full control |
| Multiple regions / number pools | SIP for flexibility |
Google Calendar Integration
Connect Google Calendar to enable your voice agents to check availability and book appointments during calls.
Setup Steps
- Go to Integration → Calendars
- Click "Connect Google Calendar"
- Sign in with Google
- Authorize Hanc.AI access
Permissions requested:
- View calendar events (to check availability)
- Create calendar events (to book appointments)
Calendar Configuration
After connecting, configure the calendar tool on your agent:
| Setting | Description |
|---|---|
| calendar_id | Which Google Calendar to use for scheduling |
| timezone | Timezone for appointment scheduling (e.g., Europe/Vienna) |
| work_hours | Available hours for booking (e.g., Monday-Friday 9:00-18:00) |
| slot_duration | Default appointment length (e.g., 30 minutes) |
| buffer | Buffer time between appointments (e.g., 15 minutes) |
Calendar Usage in Agents
Once connected and configured, agents can:
- Check availability for specific dates and times
- Book appointments automatically
- Respect work hours and buffer times
- Handle rescheduling requests
Example conversation:
Customer: "Can I book an appointment for Tuesday at 3pm?"
Agent: [Checks calendar]
"Yes, Tuesday at 3pm is available.
May I have your name to complete the booking?"
Outlook Calendar Integration
Connect Microsoft Outlook Calendar to enable appointment scheduling through your voice agents.
Setup Steps
- Go to Integration → Calendars
- Click "Connect Outlook Calendar"
- Sign in with your Microsoft account
- Authorize Hanc.AI access
Permissions requested:
- View calendar events (to check availability)
- Create calendar events (to book appointments)
Calendar Configuration
After connecting, configure the calendar tool on your agent:
| Setting | Description |
|---|---|
| Calendar | Which Outlook calendar to use for scheduling |
| Timezone | Timezone for appointment scheduling (e.g., Europe/Vienna) |
| Work Hours | Available hours for booking (e.g., Monday-Friday 9:00-18:00) |
| Slot Duration | Default appointment length (e.g., 30 minutes) |
| Buffer | Buffer time between appointments (e.g., 15 minutes) |
Differences from Google Calendar
Both calendar integrations work identically from the agent's perspective. The only difference is the sign-in process — choose whichever calendar service you already use.
You can connect both Google and Outlook calendars at the same time, but each agent can only use one calendar tool.
Cancelling Appointments
Callers who booked an appointment receive a cancellation link. They can cancel their appointment directly without needing to call back.
HubSpot CRM Integration
Connect your HubSpot workspace so your voice agents can read and write contacts and deals during the call, and so HANC's built-in CRM can mirror your HubSpot pipelines.
What It Enables
- Live tool —
HubSpot CRMin the agent's Actions tab. The agent can match the caller to a HubSpot contact by phone, fetch deal stage, and update properties from the live conversation. See Actions & Tools. - Pipeline mirroring in HANC's CRM. Your HubSpot deal stages show up in the Deals kanban so you can see calls and HubSpot context side-by-side.
- Per-pipeline AI toggle — decide which HubSpot pipelines the AI is allowed to act on; everything else stays read-only.
Setup Steps
- Open the Integrations page and click Connect HubSpot.
- Authorise HANC in your HubSpot account.
- Pick which pipelines should be mirrored (visible under CRM → Pipeline settings) and which should allow agent stage updates.
- Add the HubSpot CRM tool to any agent that should touch HubSpot during the call.
You don't have to use HubSpot to use HANC's CRM. The built-in CRM works standalone — HubSpot integration is purely for organisations that already live in HubSpot and want both worlds in sync.
MCP Servers
The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external tools. If you run an MCP-compatible server, you can register it once on the Integration page and have your agents call its tools mid-conversation.
Setup Steps (overview)
- Go to Integration → MCP servers.
- Click Connect MCP server, enter a label and the HTTPS URL of your server, choose authentication (None or Bearer token), and save.
- Open the agent you want to use the tools, go to Actions → Add Action → MCP servers, and toggle on the connections this agent should use.
The agent will discover and use the server's tools at the start of every call.
See the full MCP Servers page for detailed setup, troubleshooting, and how MCP fits alongside built-in tools.
API Keys
Generate API keys to integrate Hanc.AI with your own applications.
Creating an API Key
You can create up to 3 API keys per user.
- Go to Integration → API Keys
- Click "Create API Key"
- Enter a name (e.g., "CRM Integration")
- Set permissions (read, write, admin)
- Copy the key immediately (shown only once)
API Key Security
- Store keys securely (environment variables, secrets manager)
- Never commit keys to version control
- Rotate keys periodically
- Delete unused keys
Using API Keys
Include in API requests:
curl -X GET "https://api.hanc.ai/v1/agent/list" \
-H "x-api-key: YOUR_API_KEY"
API Key Permissions
| Permission | Access |
|---|---|
| Read | View agents, calls, analytics |
| Write | Create/modify agents, upload KB |
| Admin | All operations, delete, settings |
Available endpoints
The full list of API endpoints, grouped by resource (Calls, Agents, Knowledge Base, Phone Numbers, Voices, Subscription, Customers, Workspaces) lives on its own page:
Webhooks
Configure webhooks to receive real-time notifications about events in your Hanc.AI account.
Setup
- Go to Integration → Webhooks
- Enter your webhook endpoint URL
- Select events to subscribe to
- Save configuration
Webhooks send HTTP POST requests to your endpoint with event data in JSON format.
Post-Call Actions
Post-call actions trigger automatically after a voice agent conversation ends. Configure these on individual agents.
Available Action Types
| Action | Description |
|---|---|
| Send an email summary of the call (to business owner, customer, or both) | |
| SMS | Send an SMS notification after the call |
| Send a WhatsApp message after the call | |
| API Call | Make an HTTP request to an external endpoint with call data |
Setup
- Go to Voice Agents → select your agent
- Open the Actions tab
- Click "Add Action"
- Select action type and configure:
- Trigger: When the action fires (e.g., after every call, only on specific outcomes)
- Recipients: Who receives the notification
- Content: Message template with call data variables
Custom Integrations
Using the API
Build custom integrations using the Hanc.AI API:
Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON
API Documentation
See the API Reference for the full list of available endpoints.
Integration Best Practices
Security
- Store credentials securely
- Rotate API keys regularly
- Limit permissions to minimum needed
Reliability
- Log all integration events
- Monitor integration health
Testing
- Test integrations in staging first
- Verify data flow both directions
- Test error scenarios
- Document integration setup
Troubleshooting
Integration won't connect
- Verify credentials are correct
- Check for typos
- Ensure third-party account is active
- Try disconnecting and reconnecting
Calendar not syncing
- Re-authorize calendar access
- Check calendar permissions
- Verify selected calendar is correct
- Check for sync delays (up to 5 minutes)
Related Topics
- Phone Numbers — Phone number management
- Voice Agents — Using integrations in agents
- Analytics — Integration event tracking