Voice and language

​

Before you start

​

Languages

​

Additional languages

• You can pick up to 4. Once you have 4, the rest of the list is greyed out.
• The list leaves out the primary and secondary languages.
• Only these language families are offered: Arabic, English, Tamil, Kannada, Telugu, Hindi, Bengali, Marathi, Gujarati, Punjabi, Malay, Chinese, Italian and Malayalam.

​

Choose a voice

• Provider tabs: All, then one tab per voice provider in the list (for example ElevenLabs, Cartesia, Sarvam or Deepgram). If your workspace can clone voices, an Uploaded tab holds your clones.
• Tag chips under the tabs (a tone or style from each voice) narrow the grid. Selected tags combine: a voice must have all of them. Clear resets them.
• See more shows the full grid.
• Clicking a voice selects it and plays its preview. When the agent has a secondary language, the Preview language icon next to the tabs switches the preview between the two languages.

​

Clone a voice

​

Voice speed

​

Keyword Boosting

​

Before a voice agent goes live

• Write for the ear: short turns, one question at a time, and a first message that says who is calling and why. See Write prompts for voice.
• Script the other answers: what the agent does on “no”, “call me later” and “wrong person”, and when to end the call.
• Call when people answer: set the calling window and Timezone to your callees’ hours, and turn on voicemail detection for outbound calls.
• Match interruption to the line: Strict on noisy lines, Sensitive when callers feel talked over (Interruption sensitivity).
• Spread and cap calls: a number pool rotates numbers and skips spam-flagged ones; call limits cap calls per person; keep campaign retries modest.
• Test, then scale: test by phone with realistic values, run a small campaign, read its calls in Logs, then upload the full list.

​

Change voice and language by API

curl "https://prod-api.ringg.ai/ca/api/v0/agent/voices?language=en-IN,hi-IN" \
  -H "X-API-KEY: $RINGG_API_KEY"

const response = await fetch("https://prod-api.ringg.ai/ca/api/v0/agent/voices?language=en-IN,hi-IN", {
  headers: { "X-API-KEY": process.env.RINGG_API_KEY },
});
console.log(await response.json());

import os
import requests

response = requests.get(
    "https://prod-api.ringg.ai/ca/api/v0/agent/voices",
    headers={"X-API-KEY": os.environ["RINGG_API_KEY"]},
    params={"language": "en-IN,hi-IN"},
)
print(response.json())

curl -X PATCH "https://prod-api.ringg.ai/ca/api/v0/agent/v1" \
  -H "X-API-KEY: $RINGG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "edit_voice",
    "agent_id": "00000000-0000-4000-8000-0000000000a1",
    "voice_id": "3b5c7d2a-8e9f-4a1b-9c6d-2e5f8a7b3c4d",
    "language": "en-IN"
  }'

const response = await fetch("https://prod-api.ringg.ai/ca/api/v0/agent/v1", {
  method: "PATCH",
  headers: {
    "X-API-KEY": process.env.RINGG_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    operation: "edit_voice",
    agent_id: "00000000-0000-4000-8000-0000000000a1",
    voice_id: "3b5c7d2a-8e9f-4a1b-9c6d-2e5f8a7b3c4d",
    language: "en-IN",
  }),
});
console.log(await response.json());

import os
import requests

response = requests.patch(
    "https://prod-api.ringg.ai/ca/api/v0/agent/v1",
    headers={"X-API-KEY": os.environ["RINGG_API_KEY"]},
    json={
        "operation": "edit_voice",
        "agent_id": "00000000-0000-4000-8000-0000000000a1",
        "voice_id": "3b5c7d2a-8e9f-4a1b-9c6d-2e5f8a7b3c4d",
        "language": "en-IN",
    },
)
print(response.json())

​

Language codes the API accepts

​

Troubleshooting

​

Next steps