This article answers the most common questions about AI Messaging Agents in Aircall. For setup instructions, see the AI Messaging Agent overview.

General

What is an AI Messaging Agent?

AI Messaging Agents are conversational AI designed to handle inbound customer messages on SMS and WhatsApp. They can qualify leads, answer common questions using your knowledge base, collect information through intake questions, and hand off conversations to a human agent when needed.

Which channels do AI Messaging Agents support?

AI Messaging Agents support SMS and WhatsApp, handling inbound messages on any phone line where they are activated.

Note: Using WhatsApp requires the “WhatsApp in Aircall” add-on.

Are AI Messaging Agents the same product as AI Voice Agents?

They are part of the same AI product family and share the same knowledge base and AI Actions. The underlying technology is optimized for each channel, but from a user perspective, they function as a unified AI product across voice and messaging.

Can I use AI Messaging Agents without AI Voice Agents?

Yes. AI Messaging Agents can be activated independently. You do not need to enable AI Voice Agents to use them.

Do AI Messaging Agents require a specific add-on?

No. AI Messaging Agents are available as a standalone product for all Aircall customers.

Note: The “WhatsApp in Aircall” add-on is required to use WhatsApp.

Setup and configuration

How do I set up the AI Messaging Agent?

Steps:

  1. Go to Aircall Dashboard > AI Agents > AI Messaging Agents.
  2. Select Create AI Agent.
  3. In the left menu, under Configure, set up Profile, Messaging script, Knowledge sources and Intake questions. You can also add AI Actions.
  4. Under Deploy, select Connect number, click a number and set when the agent is active in the Assign number panel. Repeat for each SMS or WhatsApp line.
  5. Select Publish to make your changes live.
  6. Assign the agent to one or more SMS or WhatsApp lines

Setup typically takes less than 45 minutes.

Can I use the same knowledge base for AI Messaging and AI Voice Agents?

Yes. Both agents use the same knowledge base. Any updates apply across both channels. Only share common information between both agents. A knowledge base with voice-specific content, such as how to pronounce or spell words on calls, gives bad results when the AI Messaging Agent uses it. Create a separate knowledge source for anything specific to one channel and don’t share it with the other agent.

What should I include in the knowledge base?

Focus on frequently asked customer questions. Structure content in a clear Q&A format so the AI can retrieve accurate answers.

Tip: Keep the knowledge base concise and focused. Avoid special characters, as they may confuse the AI.
Avoid sharing knowledge source with Voice AI Agent that contain specific rules and prompts for the voice channel, as they may confuse the AI messaging agent.

How many intake questions should I configure?

Limit the intake flow to 3 to 4 questions. This helps keep conversations short while still capturing essential information.

Can I customize the messages the AI sends?

Yes. Use the Messaging script setting to customize greetings, closing messages, and escalation messages to match your brand voice. You can also add conversation guidelines to tell the agent how to message with customers.

Can I analyze the volumes of messages sent by my AI messaging agents ?

The Messages tab of the Overview dashboard shows the volumes of messages sent and received handled by your AI messaging agent. The overall SMS and WhatsApp volumes in this section include all messages (human or AI agent).

To see how each agent performs, use the Performance tab in your agent’s settings. Go to Aircall Dashboard > AI Agents > AI Messaging Agents, select your agent and, under Monitor, select Performance.

Do AI Messaging Agents support AI Actions?

Yes. AI Actions are available for the AI Messaging Agent and work the same way as in the AI Voice Agent. They allow the agent to trigger actions in connected tools during a conversation, including platforms such as HubSpot, Shopify, Zendesk, and Salesforce. For setup details, please see Using AI Actions with AI Messaging Agents.

Note: When configuring AI Actions, you do not need to repeat the fields required by each action in your agent goal. The model handles these automatically.

Can the AI Messaging Agent read images and PDFs sent by customers?

Yes. When image and PDF recognition is turned on, the agent can read the images and PDF files a customer sends. It then continues the conversation or passes it to your team with full context. This setting is off by default and is turned on during setup.

To turn it on please follow these steps:

Steps

  1. Go to Aircall Dashboard > AI Agents > AI Messaging Agents and select your AI Messaging Agent from the list
  2. In your AI Messaging Agent settings, go to the Messaging script
  3. Turn the Attachments interpretation toggle on and configure your media context and handoff message.

Channels and distribution

How does the AI Messaging Agent work on WhatsApp?

The AI responds to inbound WhatsApp messages within the standard 24-hour session window using custom messages, not templates.

Important: If the 24-hour session expires, a new inbound message from the customer is required to start a new session.

Can the AI Messaging Agent initiate conversations?

No. AI Messaging Agents handle inbound messages only. They do not initiate conversations or send WhatsApp template messages.

Can I use the AI Messaging Agent with outbound SMS workflows?

Yes. This is a core use case.

If you send outbound SMS via HubSpot workflows or the Aircall API “send message in agent conversation”, the AI Messaging Agent can be activated on the same line to handle incoming replies. It complements existing workflows rather than replacing them.

If you have configured your phone number to send and receive messages completely outside Aircall apps, then you cannot use the AI messaging agent (use of “send message skipping Aircall inbox”).

What happens to messages when the agent is paused??

The AI Messaging Agent can be set to respond to all inbound messages at all times (always on), or only during specific hours using the scheduled option, which is configurable by time zone and day of the week.

When the agent is paused, incoming messages route to your human team.

Can the agent switch languages during a conversation?

Yes. If a customer switches to a supported language mid-conversation, the agent adapts automatically.

Do I need to configure a call distribution to use the AI Messaging Agent?

No. You activate the agent by assigning it directly to a phone number. No call distribution configuration is required.

Can I use more than one AI Messaging Agent on the same number?

Yes. You can assign more than one AI Messaging Agent to the same number, but only one can be active at a time. For example, you can use one agent during business hours and another outside business hours.

AI quality and behavior

How accurate are the AI’s responses?

The AI answers based on your knowledge base. Response quality depends on the accuracy and completeness of that content.

What happens when the AI cannot answer a question?

If the AI lacks sufficient information or the customer requests a human, the conversation is escalated.

Note: The full conversation history and collected data are passed to the human agent, so customers do not need to repeat themselves.

Can the AI make mistakes?

Yes. Like any AI system, output quality depends on the source material.

Important: Regularly monitor AI conversations, especially after activation. Update your knowledge base to address recurring gaps.

How fast does the AI respond?

The AI typically responds within a few seconds. Messaging channels allow slightly longer response times than voice, enabling deeper knowledge base searches when needed.

How can I see how my AI Messaging Agent is performing?

Each AI Messaging Agent has a Performance tab. Go to Aircall Dashboard > AI Agents > AI Messaging Agents and select your AI Messaging Agent from the list. Under Monitor, select Performance. The tab shows the autonomous resolution rate, escalation rate and goal completion rate, and how conversations end: resolved without human support, escalated to a person, or unresolved or interrupted. For details, please see Understand and improve your AI Messaging Agent with Agent performance.

Human handoff and agent experience

How do agents view AI-handled conversations?

AI conversations appear in Aircall Workspace, where agents can view the full message history. In the Messages tab, an AI messaging filter allows you to highlight all conversations containing AI agent interventions. To see escalated conversations first, open the Sort by menu and select Escalated.

Note: More improvements to AI conversations visibility in Aircall Workspace for desktop and mobile are in progress.

Can an agent take over an AI conversation at any time?

Yes, on a given conversation, an agent can toggle off the AI agent to step in at any time. It can be toggled back on if needed.

How can I control when the AI Messaging Agent escalates a conversation?

Give detailed instructions in the Conversation guidelines field of the Messaging script, for example the situations in which a customer should be handed off to a person. The AI Messaging Agent is non-deterministic by nature, so test how it escalates with the Test messaging panel before relying on it in production.

Can the AI resume after a human agent intervenes?

Yes, the agent can toggle the AI agent back on after he intervenes. 

Note: In a future release, we will let admins configure if the AI should be able to step back in if no human intervenes in a certain duration.

Can I send escalated conversations to another tool?

Yes. Aircall sends the ai_messaging_agent.escalated webhook event when the agent hands a conversation off to a human teammate, and ai_messaging_agent.de_escalated when the escalation is resolved. You can use these events to forward escalations to tools such as Slack, your helpdesk or your CRM. Please see the Aircall API reference.

Will the AI agent reply outside my scheduled hours after a human agent takes over?

It depends on the option you turn on. At the beginning of scheduled hours the agent resumes when your scheduled hours start. After human agent inactivity resumes the agent if a human agent doesn’t respond within the timeframe you set, and the agent then responds around the clock, even outside your scheduled hours.

What is the difference between pausing the agent and a human agent taking over a conversation?

Pausing the agent turns the AI Messaging Agent off. While it is paused, incoming messages route to your human team through the normal call distribution for that number. When a human agent takes over a conversation, the AI agent is turned off only on that conversation. Advanced settings apply to this second case.

Do Advanced settings apply to every number?

You set Advanced settings in the Assign number panel of the number you are configuring.

Troubleshooting

The AI is not responding to messages. What should I check?

Verify the following:

  • The AI Messaging Agent is enabled and active on the phone line
  • The line has SMS or WhatsApp enabled

The AI is not responding to messages sent in a group thread. Is this expected?

Yes. The AI Messaging Agent does not support group messaging threads. Messages sent in a group thread will not trigger the agent. To use the AI Messaging Agent, make sure customers are contacting you through a standard one-to-one conversation.

The AI escalates too often. How can I improve this?

This usually indicates gaps in your knowledge base.

Steps:

  1. Review escalated conversations.
  2. Identify recurring unanswered questions.
  3. Update or expand your knowledge base.
  4. Refine the agent’s objective and prompt.

Can I test the AI Messaging Agent before going live?

Yes.

Steps:

  1. Use the testing panel in the dashboard.
  2. Test with a dedicated phone line if needed.
  3. Send sample messages.
  4. Verify responses, knowledge base coverage, and escalation behavior.

Compliance

Are there specific compliance requirements?

Yes. Customers are responsible for complying with local regulations in each region.

For example, in the United States:

  • Business messaging must be registered under A2P 10DLC
  • You must select a use case such as Customer Care, Marketing, or 2FA
  • AI-generated content must remain within the registered use case
Important: Many regulations and carrier guidelines require AI systems to clearly identify themselves as an “AI assistant” or “automated system” at the start of the conversation.

Standard opt-in and opt-out rules, such as STOP keywords, continue to apply.

Pricing

Do AI Messaging Agents have any overlap with AI Voice Agent minutes/bundles?

No. AI Messaging Agent conversations will be billed separately. This allows you to clearly see on invoices what usage is attributed to AI Messaging Agents vs. AI Voice Agents. 

Will I be notified when I approach my monthly conversation allowance?

Yes. Admins receive an email when the account reaches 80% and 100% of the monthly conversation allowance.

Are WhatsApp replies from the AI Messaging Agent billed?

Since 1 October 2026, Meta bills WhatsApp free-form replies sent within the 24-hour customer service window (service messages) after the first 1,000 per phone number each month. The AI Messaging Agent replies with free-form messages within the 24-hour window, so its replies count toward this total. Service messages are billed at Meta’s rate with no Aircall usage fee. For more information, please see WhatsApp in Aircall: usage rates.

Can I get notified about my conversation usage?

Yes. You can set a monthly usage alert. Aircall emails you when your conversation usage during the billing cycle reaches the number of conversations you choose. You can send the alert to your account’s billing emails, to yourself, or both.

To set it, go to Aircall Dashboard > AI Agents > AI Messaging Agents, select the three-dot menu next to the Create AI agent button, and select Monitor consumption. Enter the number of conversations in Send an alert at (in conversations) and select Apply.