Aircall AI can connect with your tools in two directions. Your AI Voice Agent and AI Messaging Agent can use your content and tools during a conversation. And AI assistants such as Claude or ChatGPT can use your Aircall data. This article is your entry point: it explains your options and points you to the right guide for each one.
Use this page to:
- Understand the ways to connect Aircall AI and your tools, in both directions.
- Choose the right option for what you want to do.
- Follow the setup order for your AI agent and find the right guide for each step.
Ways to connect your AI agent and your tools
Which option you need depends on the direction: your Aircall AI agent can use your content and tools, or an AI assistant can use your Aircall data.
Let your Aircall AI agent use your content and tools
- Knowledge sources are the content your agent reads to answer questions, such as your website, help center articles, notes, or files you upload (AI Voice Agent only). Your agent never changes anything in the source.
- AI Actions are pre-built actions that Aircall builds and maintains. During a conversation, your agent uses them to look up or update information in a connected tool, such as checking the status of an order. A few are native Aircall actions, such as Send SMS, that need no integration.
Knowledge sources and AI Actions work with both the AI Voice Agent and the AI Messaging Agent. You can share a knowledge source across both.
Let your AI assistant use your Aircall data
Aircall MCP (Beta) works in the other direction. Instead of your Aircall agent connecting to your tools, an AI assistant such as Claude or ChatGPT connects to your Aircall account and reads your call data, such as transcripts, summaries, and sentiment. It’s read-only, and you set it up in the AI assistant, not in your agent’s configuration.
For more details, please see Using Aircall MCP with AI assistants (beta).
What do you want your AI agent to do?
| You want your agent to... | Use | Start here |
|---|---|---|
| Answer questions from your website, help center, notes, or files (AI Voice Agent) | Knowledge sources | Using knowledge sources for your AI Agents |
| Look up or update information in a tool during the conversation, such as an order status, a contact, a ticket, or a meeting | AI Actions | Using AI Actions with AI Agents |
| Text the caller during a call | The Send SMS action | Using AI Actions with AI Agents |
| Let an AI assistant such as Claude or ChatGPT read your Aircall data | Aircall MCP (Beta) | Using Aircall MCP with AI assistants |
| Log calls and sync contacts with your CRM or helpdesk | Classic integrations | Navigating the Integrations section |
Don’t mix these up
- Knowledge source or AI Action? A knowledge source is content your agent reads to answer a question. An AI Action lets your agent do something in a tool, such as look up an order or create a ticket.
- Connected tool or AI Actions? Connecting a classic integration logs your calls and syncs your contacts. To let your agent look things up in the tool, you also turn on its AI Actions and add them to your agent.
- AI Actions or Aircall MCP? With AI Actions, your Aircall agent works in your tools. With Aircall MCP, it’s the other way round: an AI assistant such as Claude or ChatGPT reads your Aircall data. You can’t set up Aircall MCP from your agent’s configuration.
Before you start
Requirements depend on the feature, so check the guide for each step. Admins and Owners can usually use all of these features. Supervisors can use only some of them. Aircall MCP is in beta, so check its article for the requirements and how to get access.
To connect a tool, you also need an account in that tool, with permission to authorize the connection.
Set up your AI agent in this order
-
Create your agent:
- For an AI Voice Agent, see Creating your AI Voice Agent, then Configuring your AI Voice Agent. To follow the whole journey, see AI Voice Agent launch guide: from creation to performance.
- For an AI Messaging Agent, see AI Messaging Agents: Overview and setup.
- Add knowledge sources: In the left menu of your agent, under Configure, select Knowledge sources. For detailed instructions, please see Using knowledge sources for your AI Agents.
- Turn on AI Actions for your tool: Go to Integrations > Apps, open your tool, and select the AI Actions tab. Find your tool’s guide in AI Actions setup guides.
-
Add the actions to your agent and write rules:
- In the left menu of your agent, under Configure, select AI actions (AI Voice Agent) or AI Actions (AI Messaging Agent). See Using AI Actions with AI Agents.
- To determine when each action is used for your AI Voice Agent, please see Writing the conversation flow of your AI Voice Agent
- To run an action before the inbound call starts in your AI Voice Agent, please see Capturing call data with extraction variables and precall AI actions
- Test: Check your AI Actions in the AI Actions Testing tab of your integration. Then select Test agent call on the AI Voice Agent, or Test message on the AI Messaging Agent. On the AI Voice Agent, you can also run simulations. For more details, please see Testing your AI Voice Agent with Simulations.
- Go live:
- AI Voice Agent: connect your agent to a number and add it to your call flow. See Configuring your AI Voice Agent
Note: Changes to the Knowledge base apply automatically once processing is complete. Other changes to an active AI Voice Agent only take effect after you publish them.
For complete worked examples, see AI Voice Agent use cases, or Using AI Messaging Agents with HubSpot Workflows for messaging.
If something doesn’t work
- An action isn’t in the Add action list, or the agent doesn’t use it: see the tip in Step 2 and the FAQs of Using AI Actions with AI Agents.
- An Attio, Calendly, Front, or Help Scout action returns an error: see Troubleshooting AI Actions for Attio, Calendly, Front, and Help Scout.
- Your Salesforce articles don’t appear as a knowledge source: see the Salesforce checklist in Using knowledge sources for your AI Agents.
- Still stuck? Contact Aircall Support.