Skip to main content
This capability is in beta. Behavior can change before general availability.
At the end of this page, callers reach your voice agent by phone, from your website, or from its link. Every channel runs the latest published version, so publish the voice agent first.

​
Before you start

Before you start, sign in to the dashboard and select the organization you want to work in.

​
Connect a phone number

1

Open the voice agent and select Distribute

The Phone, Web and Developers sections open.
2

Under Phone numbers, select Connect a number

The list shows the numbers your organization owns.
3

Choose the number and what to Use for it

Incoming and outgoing calls, Incoming calls only or Outgoing calls only.
4

Confirm the connection

A Number connected to this agent message confirms it.
To stop using a number for this voice agent, select Disconnect from this agent. To buy or import more numbers, go to Settings → Phone numbers.

​
Place a call

Place a call rings a real phone number and uses your organization’s voice minutes. Call your own number first, or try the voice agent in the test panel.
Select Place a call next to a connected number. Calls are placed only inside your calling hours for the recipient. Numbers on the Do-not-call list are never called. A scheduled call shows Cancel scheduled call until it starts.

​
Add the voice agent to your website

1

Under Web, find Add to your website

If web calls are off, select Turn on. The button does not appear on your site until web calls are on.
2

Choose Call button or Call screen in your page

A call button floats on the page and opens the call. A call screen sits inside your page.
3

Copy the snippet and paste it into your website

For Call screen in your page, set the height to fit your page. 600 px works for most layouts.
Your website must use HTTPS and allow microphone access. Localhost also works for testing. Changes on the Design page appear on your site automatically. Agent link opens a full-page call screen. Share it in emails, ads or support pages. QR code lets people scan to call. Select Download SVG or Download PNG for print or signage.

​
Control web access

Web access controls where calls can start and how callers are checked. Select Save access to apply the changes.
Reset sessions stops every web call session issued so far, for the widget and for the voice agent link. Use it after a session token leaks. End users get a new session the next time they start a call.

​
Change how the call screen looks

Open the Design page of the voice agent. It has Brand identity, Theme and Call screen settings, and a preview of each call state. Select Save Changes to save the design.

​
Start calls from your backend

The API section shows the voice agent’s Agent ID and a Place a phone call example. Create an API key in Settings → Integrations. Calls run the latest published version. See the Calls API. Conversation started, ended and analyzed events go to your webhook destinations. See Webhook events.

​
Verify

Call the connected number, or open the voice agent link and start a call. The call shows in Calls with the voice agent’s name and version.