AI agents - VoIP.ms Wiki

Check out our YouTube channel to watch our simple tutorials that will help you set up most of our features.

AI agents

From VoIP.ms Wiki

Jump to: navigation, search
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.

IA agents 1.png

Creating an Agent

Click on Create New AI Agent.

IA agents 2.png

You will see two options:

  • Simple Voice Agent — A guided, step-by-step setup ideal for most use cases. Covers the essentials: voice, personality, purpose, call routing, and a knowledge base.
  • Advanced Voice Agent — Provides full control over the LLM model, TTS model, MCP servers, webhook tools, and custom parameters for complex integrations.
IA agents 3.png

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 Configuration

In this section, you will define the foundational details of your agent:

  • Agent Name — Assign a name to easily identify the agent
  • Description — Provide a brief explanation of the agent's purpose (eg. Support Agent Level 1)
  • Voice Selection — Choose from an extensive list of available voices
IA agents 4.png
Note

Not all voices currently have preview functionality. This will be expanded in future updates.

Once completed, click Next to proceed.

Step 2: Personality and Tone

This section defines how your agent communicates. Based on your answers, VoIP.ms starts to build a prompt on your behalf in the back-end.

  • Language — Select the primary language for the agent (English, Spanish or French)
  • Tone and Interaction Style — Select how the agent should interact with callers. By default, simply go for Short and Concise.
  • Agent Personality — Use this field to provide additional instructions and context, such as: agent name, company name, behavioral guidelines, or communication style preferences. This input directly influences how the AI behaves during calls.
IA agents 5.png
>>> To be changed.

Step 3: Purpose & Communication

Here you need to define what the agent is designed to do and how it interacts at the start of a call:

  • Purpose of the Agent — Select the purpose of the agent anywhere from Troubleshooting Common Issues (Default), to Collect Basic Information.
  • Greeting Message — Define the initial message the agent will deliver when answering a call. This text will be spoken exactly as written, so ensure clarity and professionalism. For instance: Hi, this is Violet with Company X Support. I can help for most issues or connect you with a live engineer. What seems to be happening today?
IA agents 7.png
>>> To be changed.

Step 4: Call Routing & Transfer Options

This 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:

IA agents 11.png

Step 5: Knowledgebase

In 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.

IA agents 12.png

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 Settings

In this section, you define the core configuration of your advanced agent:

  • Agent Name — Assign a name to identify the agent
  • TTS Model — Select the text-to-speech model for voice generation
  • Voice — Choose the voice used during calls. Please note that some voices currently do not have preview functionality. This will be expanded in future updates.
  • LLM Model — Select the language model that powers the agent's reasoning and responses
  • Background Audio — Optionally add background sound during calls
  • Language — Define the primary language of the agent (English, Spanish or French)
  • Description — Provide a brief summary of the agent's purpose
IA advanced 1.png

Call Routing and Transfer

This 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:

IA advanced 2.png

Knowledge Base

In 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 Integrations (Coming Soon!)

This section allows you to extend the agent's capabilities and make it smarter:

  • Configure MCP servers
  • Add tools and webhook tools
  • Define custom parameters

Communication Settings

In this final section, you can define how the agent interacts at the start of a call and can also build the entire prompt :

  • Greeting Message — Set the initial message delivered when answering a call
  • System Prompt — Define the core instructions that guide the agent's behavior and responses (see examples here)
IA advanced 5.1.png

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.

  1. Go to DID Numbers → Manage DIDs in the customer portal
  2. Click Edit on the DID you want to route to the agent
  3. In the routing destination section, select AI Voice Agent from the dropdown
  4. Choose the specific agent you created from the list
  5. Click Apply

Your AI Agent will now answer all inbound calls to that DID!

Personal tools
Namespaces
Variants
Actions
VoIP.ms Wiki
Guides 🇨🇦
Guías 🇲🇽