Voice Characters
Six built-in voice profiles map to TTS backends in the voice agent worker. Set voice_id on each agent to control how calls sound.
Available voices
| ID | Name | Description | Best for |
|---|---|---|---|
default |
Professional (Neutral) | Clear, balanced tone for business calls | General B2B, neutral branding |
warm_female |
Warm Female | Friendly and approachable female voice | Welcome calls, onboarding (default outbound signup agent) |
warm_male |
Warm Male | Confident and reassuring male voice | Account updates, relationship banking |
authoritative |
Authoritative | Direct tone for compliance and collections | Payment reminders, regulatory notices |
friendly_young |
Friendly Young | Upbeat tone for welcome and onboarding calls | Consumer apps, high-energy campaigns |
calm_support |
Calm Support | Patient tone for inbound help desk | Inbound support lines (default inbound signup agent) |
Assigning a voice to an agent
Update via dashboard Agents panel or API:
curl -X PATCH https://voxbridge.cc/dashboard/agents/AGENT_UUID \
-H "Authorization: Bearer YOUR_JWT" \
-H "Content-Type: application/json" \
-d '{"voice_id":"authoritative"}'
Invalid voice_id values return 422 validation errors. New agents default to default unless specified at creation.
List voices programmatically
curl https://voxbridge.cc/dashboard/voice-characters \
-H "Authorization: Bearer YOUR_JWT"
Returns JSON array of id, name, and description for each character.
Design guidance
- Match voice tone to call intent — authoritative voices reduce rapport on welcome calls.
- Use different voices for outbound sales vs inbound support so returning callers recognize the channel.
- Pair voice choice with system prompt tone; a calm prompt with an authoritative voice sounds inconsistent.