AI agents
From VoIP.ms Wiki
| [checked revision] | [checked revision] |
| (One intermediate revision not shown) | |||
| Line 224: | Line 224: | ||
Extensions allow AI Agents to connect with external systems such as CRMs, helpdesks, databases, and internal business applications. | Extensions allow AI Agents to connect with external systems such as CRMs, helpdesks, databases, and internal business applications. | ||
| - | These integrations enable your AI agents to send information, retrieve data, and perform actions | + | These integrations enable your AI agents to send information, retrieve data, and perform actions. Helping automate workflows and provide more personalized customer interactions. |
Extensions are configured from the '''Extensions''' section within the AI Agent configuration page. | Extensions are configured from the '''Extensions''' section within the AI Agent configuration page. | ||
| Line 469: | Line 469: | ||
[[File:AI_Agent_-_Manage_DIDs.png|thumb|none|600px]] | [[File:AI_Agent_-_Manage_DIDs.png|thumb|none|600px]] | ||
| + | |||
| + | |||
| + | |} | ||
| + | |||
| + | = Servers/ Point of Presence (POP) = | ||
| + | |||
| + | {| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);" | ||
| + | |- | ||
| + | | style="vertical-align: top;" | | ||
| + | [[File:Serverspops.png|thumb|none|600px]] | ||
| + | |||
| + | The '''Servers''' section allows you to configure the Point of Presence (POP) used by your AI Voice Agent. | ||
| + | |||
| + | The POP represents the network server location responsible for receiving and processing calls handled by the AI Agent. | ||
| + | |||
| + | This configuration is available when creating or editing an AI Voice Agent in: | ||
| + | |||
| + | * Simple Agent | ||
| + | * Advanced Agent | ||
| + | * Accordion flows | ||
| + | |||
| + | The Servers tab provides a centralized location to define where your AI Agent operates within the network. | ||
| + | |||
| + | == Understanding Point of Presence (POP) == | ||
| + | |||
| + | A Point of Presence (POP) is the server location associated with your AI Agent. | ||
| + | |||
| + | The selected server determines the infrastructure used when the agent receives and processes calls. | ||
| + | |||
| + | The available server list matches the servers available under your account information. | ||
| + | |||
| + | == Configuration Model Update == | ||
| + | |||
| + | The Servers tab introduces a new configuration model that separates AI Agent configuration from phone number routing. | ||
| + | |||
| + | {| class="wikitable" | ||
| + | ! Previous Model | ||
| + | ! New Model | ||
| + | |- | ||
| + | | One AI Agent was tied to one DID | ||
| + | | One AI Agent can be used across multiple DIDs | ||
| + | |- | ||
| + | | The system attempted to synchronize DID and agent assignments when saving routing | ||
| + | | DID routing only stores the selected routing option | ||
| + | |- | ||
| + | | Configuration was associated directly with the phone number | ||
| + | | AI Agent configuration is managed from the Servers tab | ||
| + | |} | ||
| + | |||
| + | == Configuring the Server == | ||
| + | |||
| + | When configuring an AI Voice Agent, you can select the desired Point of Presence from the available server list. | ||
| + | |||
| + | The selected POP determines where the agent receives and processes incoming calls. | ||
| + | |||
| + | To configure the server: | ||
| + | |||
| + | # Open the AI Voice Agent configuration. | ||
| + | # Navigate to the '''Servers''' section. | ||
| + | # Select the desired Point of Presence. | ||
| + | # Save the configuration. | ||
| + | |||
| + | Once configured, the AI Agent will use the selected server for its call processing operations. | ||
| + | |||
| + | == Multi-DID Support == | ||
| + | |||
| + | The new configuration model allows a single AI Agent to be assigned to multiple phone numbers. | ||
| + | |||
| + | Each DID can route calls to the same AI Voice Agent while maintaining its own routing configuration. | ||
| + | |||
| + | Example: | ||
| + | |||
| + | {| class="wikitable" | ||
| + | ! Phone Number | ||
| + | ! Routing Configuration | ||
| + | |- | ||
| + | | DID 315... | ||
| + | | Routes to AI Agent "Reception" | ||
| + | |- | ||
| + | | DID 442... | ||
| + | | Routes to AI Agent "Reception" | ||
| + | |} | ||
| + | |||
| + | The AI Agent configuration is created once, and multiple phone numbers can reference the same agent. | ||
| + | |||
| + | |||
| + | |||
| + | == Benefits == | ||
| + | |||
| + | The Servers tab improves AI Agent management by allowing: | ||
| + | |||
| + | * Multiple DIDs to use the same AI Agent | ||
| + | * Centralized agent configuration | ||
| + | * Easier server management | ||
| + | * Simplified DID routing | ||
| + | * Greater flexibility when scaling AI call flows | ||
| + | |||
| + | By separating agent configuration from phone number routing, administrators can manage AI Agents more efficiently and support more complex communication environments. | ||
Latest revision as of 20:05, 15 June 2026
|
AI Agents (Beta)
Configure a Voice Agent to better handle your inbound calls. |
This guide explains how to configure VoIP.ms AI Voice Agent to handle inbound calls within your existing telephony setup.
The AI Voice Agent acts as a virtual first point of contact, capable of answering calls, understanding caller intent, and responding based on the behavior you define during configuration. Proper setup is critical, as the agent's performance is directly influenced by how clearly its instructions, call flows, and routing logic are defined.
Important: The AI agent does not "learn" your business automatically. It operates based on the rules, prompts, and context you provide — making configuration a key factor in achieving accurate and reliable interactions.
|
Pricing
During the Beta Period, the pricing is $10 per agent per month. Afterwards, the standard price will be $25 per agent per month. Furthermore, per-minute pricing is $0.25/min. This includes STT, TTD, and LLM capabilities, so you get full functionality with no hidden costs. |
Contents |
Getting Started
|
To access the AI Agents feature, navigate to the VoIP.ms Customer Portaland click on AI Agents (BETA) in the navigation bar. |
Creating an Agent
|
Click on Create New AI Agent. You will see two options:
Choose the option that best fits your needs. The sections below cover both paths in detail. |
Simple Voice Agent
The Simple Voice Agent walks you through setup in a series of focused steps. Complete each step and click Next to advance.
Step 1: Basic ConfigurationIn this section, you will define the foundational details of your agent:
Once completed, click Next to proceed. |
Step 2: Personality and ToneThis section defines how your agent communicates. Based on your answers, VoIP.ms starts to build a prompt on your behalf in the back-end.
|
Step 3: Purpose & CommunicationHere you need to define what the agent is designed to do and how it interacts at the start of a call:
|
Step 4: Call Routing & Transfer OptionsThis section allows you to configure whether the AI agent can transfer calls. If you do not want call transfers, simply click Next. Otherwise, to enable transfers, click the Allow AI agent to transfer calls to specific destinations checkbox, then add a label to describe your transfer scenario(s) (e.g., "Sales Team", "Support Line") or the name of the given person (e.g. "John Doe"). Then, add as many destinations as you wish from:
|
Step 5: KnowledgebaseIn this section, you define the information sources the agent will use to respond to callers. You can add links such as your website, a knowledge base, a FAQ page, or even a Wiki. Ensure all links are publicly accessible and readable. Optional: Enable Allow web search for additional information when appropriate to supplement responses with live web results. Once all sections are completed, click Create Agent to finalize the setup of your Simple Voice Agent. |
Advanced Voice Agent
The Advanced Voice Agent provides full control over your agent's underlying models, integrations (coming soon!), and behavior. Use this option when you need to select a specific LLM or TTS model, connect external tools via MCP servers or webhooks, or define custom parameters for complex use cases.
General SettingsIn this section, you define the core configuration of your advanced agent:
|
Call Routing and TransferThis section allows you to configure whether the AI agent can transfer calls. To enable transfers, click the Allow AI agent to transfer calls to specific destinations checkbox, then add a label to describe your transfer scenario(s) (e.g., "Sales Team", "Support Line") or the name of the given person (e.g. "John Doe"). Then, add as many destinations as you wish from:
|
Knowledge BaseIn this section, you define the information sources the agent will use to respond to callers. You can add links such as your website, a knowledge base, a FAQ page, or even a Wiki. Ensure all links are publicly accessible and readable. Optional: Enable Allow web search for additional information when appropriate to supplement responses with live web results. |
Advanced Tools and IntegrationsExtensions allow AI Agents to connect with external systems such as CRMs, helpdesks, databases, and internal business applications. These integrations enable your AI agents to send information, retrieve data, and perform actions. Helping automate workflows and provide more personalized customer interactions. Extensions are configured from the Extensions section within the AI Agent configuration page. There are two types of integrations available:
Each serves a different purpose and can be used independently or together depending on your workflow requirements. WebhooksWebhooks allow your AI Agent to send information to an external system when a specific event occurs during the call lifecycle. In simple terms: "When something happens, send this information to another system." Webhooks are commonly used to:
Webhook ConfigurationThe following fields are available when creating or editing a webhook.
ParametersParameters define the information that will be sent to the destination system. For each parameter, you can specify:
Dynamic ValuesIf the Value field is left empty, the AI Agent will attempt to populate it using information collected during the conversation. Examples include:
Fixed ValuesA fixed value will always be sent with the request. Example:
Default ValuesA default value will only be used if the AI Agent is unable to determine the information from the conversation. Example Parameter Configuration
MCP ServersMCP (Model Context Protocol) Servers allow AI Agents to interact with external systems in real time during a conversation. Unlike webhooks, which send information in a single direction, MCP Servers establish a live connection that enables the AI Agent to query external tools and retrieve information while speaking with the caller. In simple terms: "Connect the AI Agent to an external system so it can retrieve information and perform actions during the call." Common MCP Use CasesMCP Servers can be used to:
Because these actions occur during the conversation, the caller can receive immediate responses without requiring manual intervention.
MCP Server ConfigurationThe following fields are available when configuring an MCP Server.
Authentication HeadersAuthentication Headers are commonly used to grant access to external systems. Examples include:
These values are typically provided by the technical team responsible for the connected application. Additional NotesSome MCP implementations support advanced initialization options that may be configured through the API. These settings are typically used for custom integrations and advanced deployment scenarios.
|
Communication SettingsIn this final section, you can define how the agent interacts at the start of a call and can also build the entire prompt :
|
Linking Your Agent to a DID
|
Once your agent is created, you need to assign it to a phone number (DID) so it can start answering inbound calls.
Your AI Agent will now answer all inbound calls to that DID!
|
Servers/ Point of Presence (POP)
|
The Servers section allows you to configure the Point of Presence (POP) used by your AI Voice Agent. The POP represents the network server location responsible for receiving and processing calls handled by the AI Agent. This configuration is available when creating or editing an AI Voice Agent in:
The Servers tab provides a centralized location to define where your AI Agent operates within the network. Understanding Point of Presence (POP)A Point of Presence (POP) is the server location associated with your AI Agent. The selected server determines the infrastructure used when the agent receives and processes calls. The available server list matches the servers available under your account information. Configuration Model UpdateThe Servers tab introduces a new configuration model that separates AI Agent configuration from phone number routing.
Configuring the ServerWhen configuring an AI Voice Agent, you can select the desired Point of Presence from the available server list. The selected POP determines where the agent receives and processes incoming calls. To configure the server:
Once configured, the AI Agent will use the selected server for its call processing operations. Multi-DID SupportThe new configuration model allows a single AI Agent to be assigned to multiple phone numbers. Each DID can route calls to the same AI Voice Agent while maintaining its own routing configuration. Example:
The AI Agent configuration is created once, and multiple phone numbers can reference the same agent.
BenefitsThe Servers tab improves AI Agent management by allowing:
By separating agent configuration from phone number routing, administrators can manage AI Agents more efficiently and support more complex communication environments.
|
Frequently Asked Questions
|
Q: Can the AI agent handle outbound calls? A: No — AI Agents are designed for inbound calls only. They answer calls made to your DID; they cannot initiate outbound calls. Q: What languages does the agent support? A: English, Spanish, and French. Q: What is the difference between Simple and Advanced? A: The Simple Voice Agent guides you through a fixed set of steps and covers everything most users need: voice, personality, purpose, call routing, and a knowledge base. The Advanced Voice Agent exposes the underlying LLM and TTS model selection, background audio, and (coming soon) MCP servers and webhook tool integrations for more complex use cases. Q: Can I have multiple agents? A: Yes — you can create as many agents as needed and assign each one to a different DID. Q: Can I edit my agent after creating it? A: Yes — from the AI Agents dashboard you can edit, duplicate, or delete any agent at any time. Q: What happens if the agent cannot answer a question? A: The agent will let the caller know it does not have that information. If call transfers are configured, it can route the caller to a human agent instead. Q: Does the agent answer calls 24/7? A: Yes — once assigned to a DID, the agent answers all inbound calls at any hour. Q: Does the AI agent work with my existing DID? A: Yes — any eligible DID can be routed to an AI Agent from DID Numbers → Manage DIDs. Q: What does "(Beta)" mean? A: The feature is in active development. Some capabilities — such as Advanced Tools and Integrations — are not yet available, and behaviour may change before the general release.
|
Need Help or Got Feedback?
|
Support resources
When reporting an AI Agent issue, include:
|