Skip to main content
Create an AI voice agent entirely from your OpenCX dashboard.

Prerequisites

  • Voice settings write access to create or change an agent.
  • A verified phone number under Settings → Phone Numbers if you plan to assign an inbound number. Agents can also be created without a number for -only or outbound-only use.

Go live

1

Create The Agent

Go to Channels → Phone → Agents, click New phone agent, then Select AI Agent. The agent is created at once and its page opens.
2

Name Your Agent

A new agent starts as New agent, with the name selected so you can type over it. Give it a descriptive name (e.g. “Sales Qualifier”, “Support Line”). To rename it later, click the name.
3

Choose Voice And Language

Open Voice and pick the languages the agent speaks, then select an available voice from the voice library. Voice choices depend on the selected languages and Arabic dialects; some selections have no available voices. Gulf dialects offer Gulf Arabic voices, while dialects without a dedicated voice offer general Arabic voices. Check the accent and gender labels when choosing a voice. Editing languages later keeps your current voice selected until you replace it. Multi-language agents can switch languages during a call based on the caller. Optionally pick a background sound under Sound. See Sound.
4

Write Instructions

A new agent comes with a starter script that explains the page to whoever calls it. Replace it with what your agent should do: who it is, what it handles, and when to hand the call to a person. See Agent Configuration.
5

Set A First Message

Set the in Opens with — this is the agent greeting for the call (e.g. “Hi, thanks for calling Acme Support. How can I help?”).
6

Select Knowledge Sources

Open Knowledge and check the instructions and knowledge the agent may use. A new agent knows only its own instructions until you select sources. See Knowledge Sources.
7

Assign An Inbound Number

Open and, under Answers calls on, assign one or more verified phone numbers. Each number can only be assigned to one agent. For BYOC numbers, see SIP Integration.
8

Make A Test Call

Click Test, then Call in browser to talk to the draft from your browser. Verify the agent answers, follows instructions, and behaves as expected.
9

Publish

Click Publish and confirm. The agent takes no calls until its first publish; from then on, callers reach it on its assigned numbers.
Every change saves automatically to a draft; there is no Save or Create button. A new agent starts unpublished, so nothing you change reaches callers until you publish. After that, real calls keep using the published version while you edit and test the draft. See Drafts, testing and publishing.
Agents are created without purchasing a separate phone number. Assign a verified number from Settings → Phone Numbers, or use SIP trunking to route calls from your own carrier.

Test calls

On the agent page under Channels → Phone → Agents, click Test, then:
  • Call in browser calls the agent directly from your browser — no phone number needed.
  • Call my phone rings a phone number you enter, while the page shows the call as it goes.
Test runs what the version menu shows: the draft, or any published version you pick, so you can try changes before callers get them. If the agent’s knowledge is still being prepared, the panel shows Preparing… and the call starts by itself when it is ready. See Drafts, testing and publishing. Test calls help verify:
  • The agent answers and speaks the first message
  • Instructions are followed correctly
  • The selected knowledge sources are used
  • Transfer destinations work
A browser test does not validate a phone number, caller ID, or carrier route. Before going live, place a real inbound call and an outbound call if you will use both. Verify transfers and recording settings separately. See Numbers and routing.

Agent Configuration

Voice, script pane, knowledge sources, actions, and transfers.

Inbound Calls

How calls are routed to agents and what happens during a call.

SIP Integration

Bring your own carrier with SIP trunks.