Skip to main content

Web Voice

Web Voice lets a visitor of your website call the AI agent from the Moveo web widget. The visitor selects the voice button of the widget and talks to the AI agent in the browser. You do not need a phone number or a telephony account.

The integration handles only the call: the websites that can start a call, the network, and the call settings. The AI agent holds the voice. Set the speech-to-text and text-to-speech in the voice settings of the AI agent, and the language model in the Voice channel of the model strategy.

Prerequisites​

  • A web widget on your website, in the same environment as the Web Voice integration.
  • An AI agent with speech settings for its primary language, or a Moveo default for your region. See Default settings.
  • A rule that routes the Web Voice integration to the AI agent.

Set up Web Voice​

  1. Go to Connections and select the environment of your web widget.
  2. Find the Web Voice card and select Connect.
  3. Under Allowed origins, select Add origin and enter each website that shows the widget, for example https://www.example.com. See Allowed origins.
  4. Set the call settings.
  5. Turn on the toggle of the integration and select Save.

Connect it to the web widget​

  1. Open the web widget integration in the same environment.
  2. Expand Voice mode.
  3. Turn on Enable voice mode. To open the Web Voice integration, select Web Voice settings.
  4. Select Save.

The widget then shows a voice button. If the environment has no Web Voice integration, Voice mode shows Set up, which opens the setup of a new one.

The Voice mode section of the web widget, with Enable voice mode on and the Web Voice settings link.The Voice mode section of the web widget, with Enable voice mode on and the Web Voice settings link.

If you turn off the Web Voice integration, visitors do not see the voice button. If you delete it, select another integration in Voice mode, or turn off voice mode.

Call settings​

SettingWhat it does
Allowed originsThe websites that can start a call. Up to 20 origins.
ICE transport policyHow the call audio crosses the network. Auto (default) or Force relay (TURN).
AI Agent starts firstThe AI agent greets the visitor with the welcome message. With it off, the AI agent waits for the visitor to speak.
Noise suppressionRemoves background noise from the visitor audio before speech-to-text. Off by default. See Turn-taking.

Allowed origins​

An origin is the scheme and the domain of a website, for example https://app.example.com, with no path. The match is exact. Add each subdomain on its own line, because wildcards do not work.

  • A call from a website that is not in the list does not start.
  • With an empty list, any website can start a call with the integration. Add at least one origin before you embed the widget on a public website.

ICE transport policy​

  • Auto sends the audio on the shortest network path. Use it for most websites.
  • Force relay (TURN) sends all the audio through a relay server. If a strict company firewall blocks direct connections for your visitors, use this policy.

Browser and microphone​

A Web Voice call uses WebRTC in the browser of the visitor. At the start of the call, the browser asks for microphone access, and the visitor must allow it. If the call cannot use the microphone, the widget shows one of these errors:

ErrorCause
Microphone permission deniedThe visitor blocked the microphone for the website.
No microphone foundThe device has no microphone.
Microphone is in use by another applicationAnother application holds the microphone.

During the call, the visitor can mute the microphone and open a keypad to send digits. The widget also shows what the visitor said and the replies of the AI agent as text. To write replies that work in audio and on screen, see Voice guidelines.

If the network connection drops, the call tries to reconnect for up to 45 seconds. Then it ends.

Handover during a call​

A human agent cannot answer a Web Voice call. When the AI agent runs the Handover action during a call, the call ends. A human agent then continues the conversation in the chat of the widget, with the call transcript in the thread.

After the handover, the widget hides the voice button, also while the conversation waits for a human agent. The button shows again when an AI agent joins the conversation again.

Moveo does not say anything before the call ends. Make the AI agent say a short sentence before the handover, so that the visitor knows why the call ends. For example: "Someone from the team will continue with you here in the chat."

  • In a dialog, add a text response with the sentence just before the Handover action.
  • In the guidelines of the AI agent, add a rule. For example: "Before you hand the conversation over to a person during a call, say: Someone from the team will continue with you here in the chat."

If a human agent takes over the conversation directly in the inbox during a call, the call also ends. In that case, the AI agent does not say a sentence before the call ends.

Limits​

  • Web Voice calls are inbound only. To call customers, use Twilio Voice or Telnyx Voice with campaigns.
  • Web Voice does not transfer a call to a phone number or a SIP URI. A handover ends the call and moves the conversation to the chat. See Handover during a call.
  • Web Voice has no answering machine detection, no call recording and no SIP caller setting.

Test the integration​

  1. Add the origin of your test page to Allowed origins.
  2. Open the page with the web widget and select the voice button.
  3. Allow the microphone, and talk to the AI agent.
  4. Open the conversation in Logs to read the transcript.

A Web Voice call tests the full speech pipeline and the handover to the chat. It does not test the phone network or a call transfer. For a complete test plan, see Test a voice AI agent.

Next steps​