How to Create a Voice Agent
Step-by-step guide to creating a new AI voice agent in TrustPager — picking a voice, building the conversation flow, attaching a phone number, and publishing live.
Voice agents are AI-powered phone agents that handle inbound and outbound calls on behalf of your team. You build them visually in TrustPager, attach a phone number, and publish directly to make them live.
Before you start
You need the Voice Agents integration enabled for your workspace. If you do not see Voice Agents in your Agent Hub, get in touch via https://app.trustpager.com/settings/service-requests to have it activated.
Create a new agent
Go to https://app.trustpager.com/auto/voice-agents and click New. Give your agent a name — this is internal and not heard by callers. TrustPager creates the agent and takes you directly into the agent detail page.
Pick a voice
Open the agent detail and find the Voice section in the Settings tab. Select a voice from the library — each listing shows the language, accent, and a play button so you can preview it before committing. The platform defaults to Australian English (en-AU), which is appropriate for most Australian businesses. You can change the language to match your caller base.
Once you have picked a voice, use the three sliders in the flow builder settings panel to fine-tune delivery:
- Speed — how fast the agent speaks (0.5 = slow, 2.0 = fast; 1.0 is natural)
- Stability — how consistent the voice sounds across a call (lower = more expressive, higher = more even)
- Volume — output loudness
Build the conversation flow
Click Edit Script on the agent detail page to open the visual flow builder. The builder works with nodes and edges:
- Conversation nodes — the agent speaks and listens. Write a prompt describing what the agent should say and how it should respond in that moment.
- End Call nodes — the agent wraps up and hangs up.
- Function nodes — the agent calls an external tool (for example, the TrustPager scheduling API to check availability or book a time).
- Branch nodes — the agent takes different paths depending on what the caller says.
- Transfer Call nodes — the agent warm-transfers the caller to a person or another number.
Connect nodes with edges. Each edge has a condition — plain English describing when the agent should move from one node to the next (for example, "caller confirms they want to book" or "caller asks to speak to someone").
The Global Prompt at the top of the builder sets the overall persona, tone, and knowledge your agent carries across every node. Write it as instructions to the agent: who it is, what business it represents, and what it should and should not do.
Save your changes as a draft with the Save Draft button. Drafts are not live — callers cannot reach a draft agent until you publish.
Attach a phone number
Your agent needs a phone number before it can take calls. Go to https://app.trustpager.com/settings/phone to buy or port a number, then return to the agent detail and link it under Phone Numbers. A single agent can have multiple inbound numbers, and you can designate one as the default outbound number for agent-initiated calls.
Set up outbound config
If your agent will make outbound calls (for example, from an automation), configure the outbound settings on the agent detail page:
- Default caller ID — the number shown to the person being called
- Allowed country codes — restrict which countries the agent can dial to prevent unexpected usage
- Rate limits — cap how many calls the agent can initiate per contact per time window
See https://trustpager.com/help-center/automate-outbound-voice-calls for wiring outbound calls into an automation.
Set up website config
If you want the agent to handle inbound calls from your website (a web-based call widget embedded in a page), add a website config on the agent detail page. Select the TrustPager website the widget should appear on, then set its own rate limits to control how many web calls a single visitor can initiate.
Channels tab
Once you have phone numbers or websites wired to this agent, the Channels tab on the agent detail page gives you a unified view of everything connected. It is read-only — each row has an external-link icon that takes you to the dedicated settings page for that resource. Three sections are shown:
- Inbound Numbers — numbers routing inbound calls to this agent. Manage them at https://app.trustpager.com/settings/phone.
- Outbound Calling — numbers used as this agent's outbound caller ID. Managed from the same page at https://app.trustpager.com/settings/phone.
- Web Widgets — TrustPager websites embedding a call widget for this agent. Manage them at https://app.trustpager.com/admin/websites.
For a full reference of agent settings including LLM model, Flex Mode, data storage, and voice fallbacks, see https://trustpager.com/help-center/voice-agent-settings.
Test before going live
On the agent detail page, click Initiate Call. Enter your own phone number and the agent will ring you. This uses your configured outbound number as the caller ID. Walk through the conversation flow as a real caller would — check that transitions trigger correctly, the voice sounds right, and any tool calls (like booking or data lookups) return the expected responses.
Publish
Once you are happy with the draft, click Publish in the flow builder. TrustPager pushes the new agent version live and the agent starts taking inbound calls on its attached numbers and responding to outbound triggers from automations.
You can continue editing after publishing — changes are always saved as a new draft and do not affect the live agent until you publish again.
Troubleshooting
- Agent is not answering calls
- Check that the agent is published (not just saved as a draft) and that the phone number is linked to the correct agent. Numbers can only be assigned to one agent at a time.
- The voice does not match what I selected
- Voice settings are applied on publish. After changing the voice, publish a new version — a draft save alone will not update the live agent.
- Initiate Call is greyed out
- The agent has no outbound number configured. Link a phone number with outbound permissions first at https://app.trustpager.com/settings/phone.
- My flow changes are not reaching callers
- You have saved a draft but not published. Click Publish in the flow builder to push the changes live.
- Outbound calls fail or do not connect
- If outbound calls initiated by this agent are failing immediately, the phone number may not be fully registered with the voice system. Go to https://app.trustpager.com/settings/phone, click the number used as this agent's outbound caller ID, and look for a Register with voice provider button. If present, click it — this completes the voice routing setup including the credentials needed for outbound dialling. Once done, retry the call.
Tip: Start with a simple three-node flow — greeting, main conversation, end call — and get it published and tested before adding branches or tool calls. Complexity is easy to add once the basics are working.