Telephony Simulations

​

Which direction?

• Inbound agent: your agent answers calls. Bluejay’s Digital Human dials your number.
• Outbound agent: your agent places calls. Bluejay’s Digital Humans answer on their own numbers.

​

Inbound: Bluejay dials your agent

1. Click Create Agent, set type Inbound, mode Voice, connection type Phone, and paste your agent’s phone number in full international format (e.g. +15551234567).
2. Go to the Simulations page, click Create in the top right, select your agent, and add or auto-generate Digital Human personas.
3. In the Simulations tab, click Run on the simulation, then click Run calls (the button shows the call count, e.g. “Run 3 calls”).
4. When the calls finish, review transcripts, recordings, and metric scores.

​

Outbound: your agent dials Bluejay

1. Click Create Agent, set type Outbound, mode Voice, connection type Phone.
2. Give each Digital Human in your simulation a phone number. These are the numbers your agent will dial.
3. In Bluejay, add a webhook subscribed to the outbound_simulation_started event (see Webhooks). When you run the simulation, it delivers the numbers to dial:

{
  "type": "outbound_simulation_started",
  "agent_id": 123,
  "simulation_id": 123,
  "simulation_run_id": 123,
  "digital_humans": [
    { "id": 123, "name": "example_name", "phone_number": "+15551234567", "associated_simulation_result_ids": [123] }
  ]
}

4. When the webhook fires, have your system place a call to each phone_number, exactly as it dials real customers. You can also dial the numbers manually for a quick test; the Digital Humans wait on their lines until the run’s timeout.
5. The Digital Humans answer, the conversations run, and results land like any other simulation.

​

Things to note

• Direction is set on the agent, not the simulation. An Inbound agent is always called by Bluejay; an Outbound agent must place the calls itself.
• Outbound runs wait for your agent to dial. Tests stay pending until the call arrives or the timeout hits.
• Tool calls and traces aren’t captured over plain phone calls. The phone network can’t carry the simulation ID your system would need to link them. If you need tool call capture, use SIP or a native provider integration (Vapi, Retell, ElevenLabs, LiveKit).

​

Resources