Skip to content

AI voice agents

Agents that pick up the phone and make the call.

Describe the agent in plain English, rehearse it in a simulated conversation, then attach it to an outbound campaign that dials over the routes you choose.

$0.25/min

Per AI-connected minute, live

billed per second

$0

To create and rehearse an agent

3,600s

Longest call an agent can hold

Overview

An agent is a few fields and a campaign

AI voice agents run outbound calls for you: confirmations, reminders, qualification and follow-ups. You write what the agent should say and do, choose a voice and rehearse it as text. A dialer campaign then places the calls, with calling windows, retries and a spend cap.

At a glance

Create
POST /ai-agents
Draft from a brief
POST /ai-agents/draft
Rehearse
POST /ai-agents/{id}/simulate
Run
POST /dialer/campaigns with aiAgentId
Auth
Bearer API key, scope dialer:write
Billing
Route rate plus a flat AI rate, per second

Capabilities

From a brief to a calling campaign

  • Draft from plain English

    Describe the job in a sentence or two and get a complete agent back to edit: first line, instructions and guardrails.

    POST /ai-agents/draft

  • Instructions and guardrails

    Up to 8,000 characters of instructions, an opening line and separate guardrails the agent must keep to.

    systemPrompt, firstMessage, guardrails

  • Choose and hear a voice

    List the voices and preview any of them speaking your own line before a call is made.

    GET /ai-agents/voices, POST /ai-agents/voices/preview

  • Rehearse without a call

    Send a turn and read what the agent would say next. No call is placed and nothing is billed.

    POST /ai-agents/{id}/simulate

  • A campaign does the dialling

    Attach the agent to a campaign on a route you bought. Set concurrency, calling hours in the time zone you set, retries for no-answers and a spend cap that pauses it.

    POST /dialer/campaigns

  • Your routes, your caller ID

    Agents call over the marketplace routes you choose, at your wholesale rate, with your caller ID and caller ID rotation from the dialer.

    routeId on the campaign

Build an agent

Describe it, rehearse it, give it calls

Create the agent, try one turn of conversation as text, then attach it to a campaign. The campaign places the calls and the agent holds each conversation.

  • maxCallSeconds caps every conversation, up to 3,600 seconds.
  • Add numbers with POST /dialer/campaigns/{id}/numbers, then start the campaign from the dashboard or the API.
# 1. Describe the agent.
curl -X POST https://packetexchange.io/api/v1/ai-agents \
  -H "Authorization: Bearer $PACKETEXCHANGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Appointment confirmation",
    "language": "en",
    "firstMessage": "Hello, this is Riverside Clinic about your appointment tomorrow.",
    "systemPrompt": "Confirm tomorrow at 10:30. Keep every reply short and polite.",
    "maxCallSeconds": 180
  }'

# 2. Rehearse a turn. No call is placed.
curl -X POST https://packetexchange.io/api/v1/ai-agents/$AGENT_ID/simulate \
  -H "Authorization: Bearer $PACKETEXCHANGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Yes, I can still make it." }'

# 3. Give it an outbound campaign on a route you bought.
curl -X POST https://packetexchange.io/api/v1/dialer/campaigns \
  -H "Authorization: Bearer $PACKETEXCHANGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Tomorrow confirmations", "routeId": "<route>", "concurrency": 5, "aiAgentId": "'$AGENT_ID'" }'

Create response, data

{
  "id": "…",
  "name": "Appointment confirmation",
  "language": "en",
  "createdAt": "…"
}

Outbound at scale

The dialer and the agent are one product

Calling windows by time zone, retries, spend caps, caller ID rotation and DNC suppression are part of the same campaign. There is nothing to wire between a voice bot, a dialer and a SIP provider.

Webhooks

Events, signed and retried

Follow each campaign from your own systems.

Signed with an HMAC SHA-256 in X-PX-Signature and retried until your endpoint answers.

  • campaign.startedA campaign began dialling.
  • campaign.completedA campaign finished its list.
  • balance.lowYour balance fell below your threshold.

Pricing

A cost per conversation you can work out

Each AI-connected minute bills one flat AI rate, per second, on top of the route's own per-minute price. Creating, drafting, previewing voices and rehearsing are free.

AI rateper AI-connected minute, billed per second
$0.25 a minute
Route
The rate of the route the campaign dials on
Create, draft, preview, rehearse
Free
Top up
From $5 by card or crypto

The AI rate is read live from the same figure billing uses.

In production

Built for production

An agent is a hosted object and the campaign is the dialler, so there is no media server to run.

  • Described in plain EnglishWrite what the agent should do and say; drafts, rehearsals and voice previews are free.
  • Rehearsed before it callsPOST /ai-agents/{id}/simulate returns what the agent would say next for any message, with no call placed and nothing billed.
  • Campaign controls built inCalling hours in a time zone you choose, concurrency, retries, caller ID rotation, DNC suppression and a spend cap that pauses the campaign.
  • Your routes, your caller IDAgents call on the marketplace route you set on the campaign, at your rate, so you are never tied to one carrier.
  • One rate for the AIOne flat AI rate per AI-connected minute on top of the route rate, both billed per second.

Built for campaigns

Agents dial out over the routes you choose.

Coming from Twilio

The names you know, mapped

On Twilio a voice agent is usually your own server joined to a call. Here the agent is a hosted object and the campaign is the dialler.

TwilioConversationRelay or Media Streams plus your own model serverHerePOST /ai-agentsThe voice, the model and turn-taking are hosted; you write the instructions.
TwilioA loop of Calls.json requests from your codeHereA dialer campaign with aiAgentIdConcurrency, calling hours, retries and a spend cap are built in.
TwilioSpeech and model billed by separate vendorsHereOne flat AI rate per minuteOn top of the route rate, billed per second.

Twilio is a trademark of Twilio Inc. PacketExchange is not affiliated with or endorsed by Twilio.

Questions

AI voice agents, answered

How do agents reach people?
Agents make outbound calls through dialer campaigns, with calling hours, retries and a spend cap set on the campaign.
What does a conversation cost?
The route's per-minute rate plus one flat AI rate per AI-connected minute, both billed per second. Building and rehearsing the agent is free.
Can I test an agent before it calls anyone?
Yes. POST /ai-agents/{id}/simulate returns what the agent would say next for any message you send. No call is placed and nothing is billed.
Which routes do agents call on?
The marketplace route you set on the campaign, at your rate and with your caller ID. You are not tied to one carrier.
How do I keep a campaign under control?
Set calling hours in a time zone you choose, concurrency, retries and a spend cap that pauses the campaign when it is reached. Numbers on your DNC list are suppressed.

Build your first agent today

Free to create and rehearse. Pay only for connected minutes, on routes you choose.

Prefer to talk it through? Contact the team.