Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trymaven.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
1

Add your TTS API key

Go to Settings > Voice in the Maven Dashboard and add your API key for one or more providers.
2

Configure per app

Navigate to your app’s Voice tab. Select a TTS provider, model, and voice ID.
3

Save

Your custom voice will be used for all future payment calls on that app.

​
Supported Providers

ProviderKey formatNotes
ElevenLabssk_...High-quality voices with streaming. Default model: eleven_flash_v2_5
Deepgramdg_...Aura TTS voices (e.g., aura-2-thalia-en)
Cartesiask-...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

GreetingWhen used
Charge greetingCaller is in charge mode and can speak or use keypad
Charge greeting (keypad only)Caller is in charge mode, DTMF-only
Tokenize greetingCaller 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:
VariableReplaced 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.”

​
Input Modes

​
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).