Skip to main content
The voice simulator stands in for a healthcare phone line: member services, provider intake, scheduling lines, or an IVR front door. Verial leases a real phone number for each sandbox so your agent can place an outbound call (or receive an inbound call) exactly as it would in production. Every call is recorded and transcribed; the verification engine scores voice-transcript criteria against the transcript.

​
How your agent connects

When the benchmark run is created, the voice sandbox’s credentials payload includes a leased phone number your agent can dial. The call connects to a simulated IVR flow configured on the simulator, optionally backed by a patient persona or human-facing agent. Your agent drives the conversation; Verial captures the audio and produces a turn-by-turn transcript with speaker labels. Voice sandboxes route calls through a hosted IVR runtime. There is no /v1/benchmark-runs/{id}/voice/* HTTP surface during the rollout. The rollout happens over telephony. The resulting transcript is available through the benchmark run’s interaction evidence.

​
Connection model

ArtifactWhere to find it
Phone numbercredentials.phone_number on the voice sandbox (in the benchmark-run response’s sandboxes list)
Expected IVR flowSimulator config.ivr
TranscriptInteraction evidence; exposed through criterion.evidence after the rollout

​
Driving the rollout

  1. Read the phone number out of the benchmark-run response.
  2. Place the call from your agent (Twilio, Retell, or any telephony runtime).
  3. Navigate the IVR, interact with the persona, and end the call.
  4. Complete the task run; the verification engine fetches the transcript and scores voice-transcript criteria.
curl "https://api.verial.ai/v1/benchmark-runs/$BENCHMARK_RUN_ID" \
  -H "Authorization: Bearer $RUN_TOKEN"
Inspect the sandboxes array for the voice sandbox and its leased phone_number in credentials.

​
Configuration

At create time you configure the IVR flow, the persona the caller speaks to, and optional scripted beats the persona should hit. 
curl -X POST https://api.verial.ai/simulators \
  -H "Authorization: Bearer $VERIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "type": "Voice",
  "name": "Member Services Line",
  "config": {
    "ivr": {
      "greeting": "Thank you for calling BlueCross. Press 1 for member services.",
      "menus": [
        { "key": "1", "label": "Member services", "route": "member_services" },
        { "key": "2", "label": "Provider services", "route": "provider_services" }
      ]
    },
    "persona": {
      "role": "member_services_rep",
      "tone": "professional, patient"
    }
  }
}
JSON

​
Verification

The voice-transcript check inspects the call transcript for required and forbidden phrases. Phrase matching is LLM-assisted so the check is robust to paraphrasing. 
{
  "label": "Agent collected member ID and DOB",
  "weight": 0.5,
  "axis": "correctness",
  "assertion": {
    "assert": "voice-transcript",
    "speaker": "agent",
    "contains": ["member ID", "date of birth"],
    "not_contains": ["social security number"]
  }
}
See the Criteria concept page for more examples and the full assertion spec.

​
Next Steps

Criteria

Full reference for voice-transcript assertions.

Interactions

How transcripts and other evidence are recorded and retrieved.

Simulators overview

Lifecycle, provisioning, and configuration patterns.

Messages

Pair voice with SMS for multi-channel patient outreach.