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'" }'const px = (path, body) =>
fetch(`https://packetexchange.io/api/v1${path}`, {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PACKETEXCHANGE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify(body),
}).then((r) => r.json());
// 1. Describe the agent.
const { data: agent } = await px('/ai-agents', {
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.
const turn = await px(`/ai-agents/${agent.id}/simulate`, { message: 'Yes, I can still make it.' });
// 3. Give it an outbound campaign on a route you bought.
await px('/dialer/campaigns', {
name: 'Tomorrow confirmations',
routeId: process.env.PX_ROUTE_ID,
concurrency: 5,
aiAgentId: agent.id,
});import os
import httpx
px = httpx.Client(
base_url="https://packetexchange.io/api/v1",
headers={"Authorization": f"Bearer {os.environ['PACKETEXCHANGE_API_KEY']}"},
)
# 1. Describe the agent.
agent = px.post("/ai-agents", json={
"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,
}).json()["data"]
# 2. Rehearse a turn. No call is placed.
turn = px.post(f"/ai-agents/{agent['id']}/simulate", json={"message": "Yes, I can still make it."})
# 3. Give it an outbound campaign on a route you bought.
px.post("/dialer/campaigns", json={
"name": "Tomorrow confirmations",
"routeId": os.environ["PX_ROUTE_ID"],
"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.
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?
What does a conversation cost?
Can I test an agent before it calls anyone?
Which routes do agents call on?
How do I keep a campaign under control?
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.




