Skip to main content

Can I put a voice-call button for my agent on my own website?

Yes: your backend starts a web voice session through the API and your page streams microphone audio to the agent.

Yes, through the API. The agent needs the Web Voice Channel skill and must be Running.

  1. Your backend calls POST /UserAgent/Realtime/WebStart with your project's API key. Signature Based projects also send x-nonce and x-signature (see Authentication). Never put the key or the secret in the browser.

  2. It returns wsUrl, sessionToken, cancelToken and expiresAt. Your page opens the WebSocket at wsUrl, sends the sessionToken in its first message, then streams 24 kHz mono microphone audio.

  3. If the call never gets going, for example because the visitor blocks the microphone, call POST /UserAgent/Realtime/Cancel with the cancelToken, from your backend with the same authentication.

There's an hourly session limit (HTTP 429 when reached) and a maximum session length. Call audio is paid from the wallet behind the project chosen on the Wiro AI Models card: the team wallet for a team project, otherwise the personal wallet of the person who created the project. Guide: Web Voice. Phone calls: Twilio.

Did this answer your question?

Related Articles