Voice Settings
Configure the voice your callers hear during payment collection.
Default Voice
Every app uses Maven’s default ElevenLabs voice at no extra cost. No setup required — your callers will hear a natural-sounding voice out of the box.
Custom Voices
To use your own voice, model, or provider:
Add your TTS API key
Go to Settings > Voice in the Maven Dashboard and add your API key for one or more providers. Configure per app
Navigate to your app’s Voice tab. Select a TTS provider, model, and voice ID.
Save
Your custom voice will be used for all future payment calls on that app.
Supported Providers
| Provider | Key format | Notes |
|---|
| ElevenLabs | sk_... | High-quality voices with streaming. Default model: eleven_flash_v2_5 |
| Deepgram | dg_... | Aura TTS voices (e.g., aura-2-thalia-en) |
| Cartesia | sk-... | Sonic TTS voices. Requires voice ID (UUID from Cartesia dashboard) |
Without your own API key, voice customization is locked. You’ll see the default voice settings and cannot change the model or voice ID.
AI Agent Mode
By default, Maven uses an AI agent (powered by GPT-4o-mini) to have natural conversations during card collection. The agent:
- Greets the caller naturally
- Acknowledges each field (e.g., “Got your Visa! Now please provide your expiration date.”)
- Handles errors conversationally (e.g., “That card number doesn’t look right, let’s try again.”)
- Confirms payment success
If the agent times out or encounters an error, Maven falls back to static template messages automatically.
You can disable AI agent mode per app by toggling AI Conversation off in your app’s Voice tab. When disabled, Maven uses deterministic template messages for all interactions.
Custom Greetings
Customize the greeting message your callers hear when they connect to the payment line. Set greetings per app in the Voice tab.
Greeting Types
| Greeting | When used |
|---|
| Charge greeting | Caller is in charge mode and can speak or use keypad |
| Charge greeting (keypad only) | Caller is in charge mode, DTMF-only |
| Tokenize greeting | Caller is in tokenize mode and can speak or use keypad |
| Tokenize greeting (keypad only) | Caller is in tokenize mode, DTMF-only |
Default Greetings
If no custom greeting is set, Maven uses built-in defaults:
- Charge: “Hi! To process your payment of $X.XX, go ahead and read your card number slowly, one group at a time, or enter it on your keypad.”
- Tokenize: “Hi! To save your card on file, go ahead and read your card number slowly, one group at a time, or enter it on your keypad.”
Template Variables
Use these placeholders in your custom greeting and Maven will replace them with the session values:
| Variable | Replaced with |
|---|
{{amount}} | Payment amount (e.g., $49.99) |
{{description}} | Charge description (if provided) |
{{mode}} | "payment" for charge, "card on file" for tokenize |
Transfer Message
Customize the message spoken before transferring the caller back to your agent. This only plays when a callback number is provided in the session. Set it per app in the Voice tab.
Default: “Please stay on the line while we connect you back.”
Voice + Keypad (default)
Callers can speak their card details or enter them on their phone’s keypad. Maven uses speech recognition (ASR) and DTMF detection simultaneously. Once the caller starts using one method, it locks to that mode for the rest of the call.
Keypad Only (DTMF)
Enable DTMF Only in your app settings to restrict input to keypad entry only. This disables speech recognition entirely. Useful for noisy environments or when you want a more predictable experience.
Postal Code
By default, Maven collects card number, expiry, and CVV. Enable Require Postal Code in your app settings to also collect the caller’s ZIP/postal code for address verification (AVS).