AI voicemail
Leaving voicemails is where reps lose the most time: waiting through the greeting, the beep, the same message for the fortieth time. With AI voicemail the rep presses one button and moves straight to the next call. The AI stays on the line, waits for the beep, says the message in a natural voice, and hangs up.
AI voicemail is off until a workspace admin turns it on, in Sales calls → Settings → Let the AI leave voicemails (from a signed-in session, PATCH /v1/workspace/policies { "aiVoicemail": true }; API keys can’t change it). While it’s off, leaveVoicemail answers 403 with error: "ai_voicemail_off". AI voices are “artificial voices” under the TCPA (FCC declaratory ruling, Feb 2024). Get the person’s prior express written consent before an AI voice speaks to them, and pass consent so the call’s record shows where it came from (see Record the consent). Some states add their own rules. Check with your own counsel before you use it. This is not legal advice.
Leave one
From your server, with calls:write, while the call is live:
TypeScript
Python
HTTP
The call’s status becomes leaving_voicemail straight away. It answers 409 not_answered while the call still rings (ask once a voicemail picks up), 409 call_over when the call has already ended, 409 not_outbound on a callback (someone calling in), and 409 ai_not_in_call in the first moments of a call, before Rydhm’s listener has joined: try again a second later. Pair it with detection: when call.answered says by: "machine", offer the rep the button, or leave the voicemail automatically:
Choose the voice
Your reps talk in their own voices. Rydhm’s voice speaks only its own lines: the AI voicemail, and the recording notice where everyone on a call must be told. A call uses one voice, chosen in this order:
- The
voiceyou send with the voicemail (that voicemail only). - The rep’s own voice:
voicemailVoiceonPUT /v1/reps/{externalId}. - The workspace’s voice: an admin sets it in Sales calls → Settings → Voicemail voice.
- Rydhm’s default, Blake.
Leave a rep’s voicemailVoice as null and they follow the workspace’s voice. In the Rydhm app that reads “Same as the team”.
To let people pick a voice in your app, list them with GET /v1/voices (calls:read). Each voice has a name, a short description and sampleUrl: an MP3 of it reading a voicemail. It’s a static file, so playing it costs nothing and needs no key. default is the voice used when nothing else names one: the workspace’s (source: "workspace") or Rydhm’s (source: "rydhm").
TypeScript
Python
HTTP
A voice that isn’t on the list (any Cartesia or Deepgram voice Rydhm can speak) still works; it has no sample, and default.name reads “Custom voice”.
Record the consent
AI voices are “artificial voices” under the TCPA (FCC declaratory ruling, Feb 2024). Get the person’s prior express written consent before an AI voice speaks to them, and pass consent so the call’s record shows where it came from.
TypeScript
Python
HTTP
- It’s kept on the call, with the time Rydhm recorded it:
GET /v1/rep-calls/{id}returns it asvoicemail.consent({ source, obtainedAt, recordedAt }), next tovoicemail.requestedAt, the time the AI was asked to leave the message. - It’s in the workspace’s audit log, with the voicemail request.
- A
consentwithout asource, with asourceover 255 characters, or with anobtainedAtthat isn’t a date or is in the future answers400 invalid_consent. consentis optional. Rydhm doesn’t check it: it keeps what your app sends. Getting the consent is up to you.
Who the message says is calling
The message names the rep (their name in PUT /v1/reps/{externalId}) and the company they call for: the call’s context.seller.company, or your Rydhm workspace’s name when the context has none. With The AI says it’s an AI on, a message the AI writes opens with “Hi Dana, this is an automated message on behalf of Maya at Acme”, and a message of yours gets that line in front unless it already says it’s automated. The call-back number is the number the call went out from.
What happens on the call
- The AI takes over the line, and the rep is released (unless
releaseRep: false). - It waits for the voicemail greeting to end and the beep (
call.beep). - It speaks the message, then hangs up.
- You get
call.voicemail_leftwith the exact words and the voice, thencall.endedwithoutcome: "voicemail_left". The words are also kept on the call asvoicemail.text(withvoicemail.by: "ai";voicemailTextandvoicemailBystill work), and thecall.voicemail_leftwebhook goes out. Webhooks carry the voice and the length, never the words.
When it doesn’t happen. If the AI can’t leave the message (the call wasn’t answered yet, it’s a callback, the line was gone, or the message couldn’t be spoken), you get call.voicemail_failed with a reason (not_answered, not_outbound, line_gone, no_audio), and the call goes on or ends as it would have. Show it to the rep: they can leave their own.
The rep’s own message. When a machine answered and the rep speaks their own message after the beep (eight words or more), that is a voicemail left too: call.voicemail_left with by: "rep" and the rep’s words as transcribed, voicemailBy: "rep" on the call, and the call ends as voicemail_left. It isn’t billed as an AI voicemail.
On a callback that nobody answered, the last step of the pool’s routing can be voicemail: then the caller leaves a message. It arrives the same way, with by: "caller" and their number in from on the event, and voicemailBy: "caller" on the call.
In the transcript, the AI’s lines have speaker: "ai".
Disclosure and recording
- Transcribing a call records it in the legal sense, and some states require everyone on the call to be told; on a live call, your rep says it. The workspace’s disclosure setting (Sales calls → Settings → Recording, and telling people → The AI says it’s an AI, on by default;
repCallDisclosurein the workspace policies) makes an AI voicemail say it’s an automated message on the rep’s behalf, and tells a caller leaving a message that it’s recorded and transcribed. - When the call is recorded, the AI voicemail is in the recording, on the rep’s side (the left channel).
- Calling hours, your Do not call list and the US-only dialling rules apply to rep calls exactly as to AI calls. See US-only dialling.
What it costs
Provisional while rep calls are in preview: $0.02 for each AI voicemail, on top of the call’s minutes. Final prices will be on the Billing page before launch.