VICIfast
ENES

AI agents: voice agents for your calls

Build a lifelike AI voice agent that takes the calls your campaign dials or answers your numbers, test it on your own phone, then put it live.

AI & automation · 7 min read

Steps in this video

AI agents: voice agents for your calls

AI Agents are lifelike AI voices that work inside your VICIdial server. One takes the calls your campaign dials and hands the good ones to your team. Another answers your numbers and puts callers through. Its work lands in VICIdial: a call result on the lead, answers in lead fields, callbacks, do-not-call entries and transfers into your queues.

This page is about AI Agents under VICIfast Voice. If you use your own Telnyx account, you may want Telnyx agents instead. See Which AI agents do I need?

What you need

  • You must be the account owner.
  • An approved VICIfast Voice account, and a server with the VICIfast Voice line (trunk) on it. The agents talk over that line.
  • For an agent that makes calls: a campaign on that server. For one that answers calls: at least one number pointed at the server from My numbers.
  • A queue (in-group) to send good callers to, and money in your wallet for AI minutes. There is no AI plan to buy.

Step 1: Create the agent

  1. In the sidebar, under VICIfast Voice, click AI Agents.
  2. Click New agent.
  3. Choose Makes calls or Answers calls. Need both? Use Duplicate as inbound (or outbound) later.
  4. Pick Its job: Lead qualifier or Appointment setter for calls out; Receptionist, Front desk or Appointment setter for calls in.
  5. Pick the Server, type a Name (for example "Sales qualifier") and click Create and set up.
The New AI agent window: which way it calls, its job, the server and a name
The New AI agent window: which way it calls, its job, the server and a name

Step 2: Describe your business and what it says first

The setup page has seven numbered sections. The box on the right lists what is Still to do.

  1. In 2. Your business, fill in Company name, The agent's name on calls and What you sell, in a sentence or two.
  2. Click Add a question for each thing it must find out. For calls out, a question can be Just ask, Must be yes or Must be over a value.
  3. Add Facts it may use (hours, prices, areas). It never promises anything that is not written here. For calls in, set Opening hours. For calls out, the campaign's Local Call Time in VICIdial decides when it dials (see Run an AI calling campaign).
  4. In 3. Opening pitch, write its first line. Lead fields such as first_name drop in from Add from the lead:, but names are only said when Use the lead's name is on (step 4). Without it, "Hi, is this {first_name}?" is said as "Hi, is this the right person?". For calls in, this is the Greeting.
  5. For calls out, choose If the call reaches voicemail: Hang up or Leave a short message. For calls in, choose what happens Outside opening hours.
Your business: what the agent may say about you and the questions it asks
Your business: what the agent may say about you and the questions it asks

Step 3: Pick a voice and the calls it takes

  1. In 4. Voice, play the samples (at phone quality) and pick a voice, a Tone and a Language.
  2. In 5. Which calls, pick the Campaign, or tick the Numbers it answers. Removing a number later puts its old route back.
  3. Set AI calls at once for this agent.
  4. Under When the agent can't take a call, pick the queue that gets the call if the agent is busy, paused or unavailable.
Which calls: the campaign or numbers, how many at once, and where overflow goes
Which calls: the campaign or numbers, how many at once, and where overflow goes

Step 4: Choose what it can do

In 6. What it can do, switch on only what this agent needs:

  • Transfer to a person: pick the in-groups and when to use each. Whoever answers sees a one-line summary in the lead's Comments and the full outcome in its comment history.
  • Set the call outcome: every call ends with one of your statuses, and you choose which.
  • Do-not-call requests: always on.
  • Schedule callbacks: "call me tomorrow at 3" becomes a VICIdial callback.
  • Save answers to the lead: Add a field for each answer and pick the lead field it goes to, custom fields included (a custom field must exist on the lead's list). Answers also go in the lead's comment history and on the call's page.
  • Book appointments into an AI calendar, and Notify your CRM through a webhook.
  • Use the lead's name: off by default. When it is off, the AI never sees or says the person's name.
  • Add a lead for test calls: on by default. When a test call transfers, a lead is made in list 999 (never dialed), so whoever answers sees your number, your name and the AI's notes.
What it can do: each action has its own switch
What it can do: each action has its own switch

Click Save draft at the top of the page.

Step 5: Install it and test it on your phone

  1. In 7. Test and go live, click Save and install. The agent is set up on your server but takes no calls until you go live.
  2. Under Your phone number, type your number and click Call me with a code. Type the 6-digit code it reads you and click Confirm. US and Canadian numbers only.
  3. Click Call my phone and talk to it like a lead would. The box next to your phone is the name the call uses: it starts as the account owner's first name and is remembered per phone. A test call behaves exactly like a real one, transfers included. Test calls are free: 20 a day, up to 3 minutes each.
Test and go live: install, verify your phone, make a free test call
Test and go live: install, verify your phone, make a free test call

Step 6: Go live

  1. Your account can run up to 25 AI calls at once across all your agents, with short bursts above that. VICIfast sets the number, and you see it on the AI settings page. Ask support if you need more. There is no plan to buy.
  2. Back in section 7, for calls out, tick the box confirming the people on the campaign agreed to calls and voicemails from an AI voice. It is required for outbound AI calls in the US.
  3. Click Go live. The agent's status changes to Taking calls.
You are live. VICIdial now hands answered calls to the agent, or your numbers now reach it. Pause stops new calls reaching it at any time; calls it is on finish normally. VICIfast never turns an agent or a campaign back on by itself. See AI agents: pause, stop and limits.

Calling out? Set up the campaign and leads first: Run an AI calling campaign.

What it costs

  • There is no AI plan or monthly fee: you pay for minutes. AI minutes are 12¢ (5¢ on your own OpenAI key), billed by the minute, plus your usual VICIfast Voice minutes. They stop when a call is handed to your team. Answering machines caught before the AI joins, and test calls, cost nothing.

Run it on your own OpenAI key

You pay OpenAI for the model, and AI minutes drop from 12¢ to 5¢.

  1. On the AI Agents page, click AI settings and find Your own OpenAI key.
  2. Paste your key (it starts with sk-) and click Save key. The card lists the OpenAI models the key must be allowed to use.
  3. Make one test call from any agent. Once the agent speaks on your key, the key shows In use and every AI call runs on it.
Your own OpenAI key: paste it once, then make one test call
Your own OpenAI key: paste it once, then make one test call
If OpenAI stops accepting your key, it shows Not working and every call goes to your team. VICIfast never moves you to its own key without asking. Fix it and make a test call, or click Remove to go back to 12¢ a minute.

On your own key, the AI Agents page shows what ran on it: calls, call time and OpenAI time for today, 7 days and 30 days. OpenAI doesn't let other apps read your balance, so check that on your OpenAI billing page. To see your real OpenAI spend here too, add an OpenAI Admin key on the AI settings page. It covers your whole OpenAI organization.

Calls, recordings and calendars

  • Calls (top of the AI Agents page) lists every AI call. Details opens one with its recording, transcript, outcome and every step it took, ending with whether the caller reached your team. Recordings are kept 90 days.
  • Calendars sets when appointments can be booked. Copy its feed address into Google Calendar, Outlook or Apple Calendar to see bookings there.

If something goes wrong

Frequently asked

› My server is greyed out with "(needs the VICIfast Voice trunk)".
The agent talks over the VICIfast Voice line, which VICIfast adds to each of your servers once your VICIfast Voice account is approved. If a server still shows this, chat with support.
› Go live says "Make one test call to your phone first" or "AI agents are not switched on for this account yet".
Going live needs the agent installed, one test call to your phone and AI agents switched on for your account (ask support if they are not). Agents that make calls also need the consent box ticked.
› It says "Your account runs 25 AI calls at once and your other live agents use..."
Your live agents together cannot use more than your account's AI calls at once. Lower "AI calls at once for this agent", pause another agent, or ask support for more.
› There are no numbers to tick for an agent that answers calls.
It says "No numbers point at this server yet." Point a number at the server from My numbers first.
› Callers reach my team instead of the agent.
The agent is paused or not live (the AI Agents table says why), it is at its limit of calls at once, the AI was briefly unavailable, your OpenAI key is not working, or your wallet is empty. Those calls go to the queue under "When the agent can't take a call".
› The status says "Paused: wallet empty", "Paused: AI not switched on" or "Paused: changed in VICIdial".
VICIfast stopped it and never turns it back on by itself. Fix the cause, then click Go live. After a wallet pause, turn the campaign back on in VICIdial too. Details in "AI agents: pause, stop and limits".
› The AI greeted me with someone else's name on a test call.
A test call uses the name in the box next to your phone in section 7, and only when "Use the lead's name" is on. Change or clear the name there.