Skip to navigation

Rydhm Engine

Put a Rydhm voice expert inside your own product, or let your app drive a rep's calls while Rydhm listens.

The Rydhm Engine is how other apps, and the AI coding agents that build them, use Rydhm from the inside. It powers two products:

The Rydhm Engine is in preview: the Onboarding coach and rep calls are live for early-access workspaces on staging, and small changes are still possible before launch. In the app, the coach is a kind of expert (Experts), and rep calls live under Sales calls.

What you need

Three kinds of credentials, each for one place:

CredentialLooks likeWhere it livesWhat it can do
Publishable keyrydhm_pk_live_…Your web pageStart a conversation with one expert and report what the user did, only from the websites you allow. Public by design.
Secret API keyrydhm_live_…Your serverEverything its scopes allow: set up guides and the page map (experts:write), read analytics (experts:read), place and follow rep calls (calls:write, calls:read). Never put it in a web page.
Softphone tokenA LiveKit tokenA rep’s browserKeep one rep online for 12 hours, take their callbacks, and hang up or decline their own calls. Your server mints it with the secret key.

The browser SDK, @rydhm/web, uses the publishable key and softphone tokens. The server SDKs, @rydhm/sdk and rydhm, use the secret key.

Rydhm is in early access. Until launch, workspaces on staging.rydhm.ai use https://api-staging.rydhm.ai in place of https://api.rydhm.ai. Pass it to the SDKs as apiUrl (@rydhm/web), baseUrl (@rydhm/sdk) or base_url (rydhm).

One event shape everywhere

Everything that happens, a transcript line on a call, a guide step done, a callback ringing, is the same JSON event wherever you receive it: on a Server-Sent Events stream from the API, in the browser (the SDK’s events), and, for the most important ones, as a webhook.

{
"id": "evt_01JC2M3W8N4P6R9S3T5V7W9YA",
"type": "call.transcript",
"callId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d",
"at": "2026-11-11T15:02:14.120Z",
"data": { "speaker": "prospect", "text": "Sure, I have a minute.", "final": true, "startMs": 5120 }
}
FieldWhat it is
idUnique. Dedupe on it: a reconnected stream can send an event again, and the SDKs drop the repeat for you.
typeWhat happened: call.* for rep calls, guide.*, announcement.*, tool.called and target.missing for the Onboarding coach.
callId, sessionIdThe rep call, or the coach’s conversation, it belongs to.
atWhen it happened (ISO 8601).
dataThe details, different for each type. The SDKs type it for you.

Where to start