Skip to main content

Configure voice message templates

Customize the text-to-speech content that users hear when they receive a voice call OTP verification code. Voice message templates use the same theme editor as email and SMS templates.

Prerequisite​

  • A custom theme created and assigned to one or more workspaces.

Edit voice message templates​

  1. Go to Tenant Settings > Appearance > Themes.

  2. Create a new theme or select an existing theme.

  3. Select the Messages tab.

  4. Expand VOICE MESSAGES > Verification Code.

  5. Select Index Page to open the index.tmpl file in the editor.

  6. Edit the template content. The template uses Go template syntax and supports the same variables as SMS templates.

    Voice message template editor showing the index.tmpl file and preview

  7. Click Save.

Voice template syntax​

Voice templates use SSML (Speech Synthesis Markup Language) to control how the verification code is spoken aloud. The default template spells out each digit of the OTP code with pauses between digits, and repeats the code twice.

The template uses Go template syntax with these key elements:

ElementDescription
{{ T "voices.otp.message_prefix" }}Inserts the localized message prefix from the translations layer.
{{ range $i, $digit := toChars .Data.OTP.Code }}Iterates through each digit of the OTP code.
<break time="500ms"/>Adds a pause between digits for clarity.
<break time="2s"/>Adds a longer pause before repeating the code.

See also​