Skip to main content
Connect an agent that customers reach by calling or texting a phone number. The Phone connection type with the agent's phone number entered The Phone connection type with the agent's phone number entered

​
Connect

1

Create the agent

For calls, create a Voice agent with the Phone connection type. For texts, create a Text agent with the SMS connection type. Enter your agent’s number in E.164 format, for example +15551234567. An Outbound Voice agent with an Outbound Trigger Webhook URL does not need a number.
2

Choose who starts the conversation

  • Inbound: your agent answers. When a run starts, each Digital Human calls or texts your agent’s number.
  • Outbound: your agent calls or texts each Digital Human first. Set up a trigger so your agent knows when to start, as described in Outbound agents.
3

Give the Digital Humans numbers

Each Digital Human calls, texts, or answers on its own number, so give each one a number. See Digital Human numbers.
4

Run a simulation

Create a simulation for the agent and run it. Each test goes over the real carrier network, and Bluejay records, transcribes, and grades each conversation against your success criteria and custom metrics.
To start an SMS run from the API, use Queue SMS Simulation Run.

​
Outbound agents

The Digital Humans wait on their lines until your agent reaches them or the run times out. Tell your agent when a run starts and which numbers to contact with one of these triggers:
  • Outbound Trigger Webhook URL on the agent. Bluejay sends one POST for each conversation, and your system then calls or texts the Digital Human. See Outbound trigger webhook for the body, headers, and retries.
  • The outbound_simulation_started event on a webhook. For a voice agent, Bluejay sends one event per run, and the event payload lists the numbers to call.
The Connect Your Agent dialog for an Outbound Phone agent, with an Outbound Trigger Webhook URL entered and the Trigger Payload Template field below it The Connect Your Agent dialog for an Outbound Phone agent, with an Outbound Trigger Webhook URL entered and the Trigger Payload Template field below it For an Outbound SMS agent, text from the number saved on the agent. Bluejay matches each message to its test by your agent’s number and the Digital Human’s number, so a text from another number is not part of the test.

​
Digital Human numbers

Buy numbers in the workspace where your Digital Humans live, because a number stays in the workspace you buy it in. Then add a number on each Digital Human’s Connection tab. See Connection.

​
Troubleshooting

Last modified on October 21, 2026