Skip to main content

Calls

Subscription minutes, SMS and phone numbers use the matching plan allowance first. Only usage beyond that allowance is deducted from the wallet. Calls use a hybrid relay pipeline: the provider answers, plays the greeting, records caller speech, transcribes it (Deepgram), and your agent replies with text that is spoken back (TTS). The full transcript is saved automatically. Voice calls beyond the plan allowance cost $0.12 per minute in both directions. A 0-second call is free. A connected call has a one-minute minimum, then the actual duration, rounded up to the cent. JavaScript examples call https://api.agentline.cloud with fetch and a Bearer al_live_... key. The Node package is not on npm.

Make an outbound call

The call is placed from the agent’s assigned number (or from_number_id if provided). Returns a call_id you use to control and inspect the call. Outbound calls listen first. The pipeline classifies what picked up:
The message is the agent’s voicemail_message when set. Without it, the agent leaves one written from the call’s prompt. See Agents.

Test without dialling anyone

Call the test line, +15555550100. Any +1 555 number works the same way: area code 555 belongs to no real US or Canada number.
  • Nothing is dialled or billed, and free trial minutes are not used.
  • The call returns at once with status: "completed" and test: true.
  • The transcript has two lines: your agent’s greeting and the test line’s reply.
  • call.completed fires with test: true, so webhooks and the relay can be tested too.
The agent still needs an active number: it is the caller ID.

Control and inspect

Pushing context to a live call (relay mode)

If your backend (Hermes, OpenClaw, Claude Code, Codex, or another agent) needs to answer a live caller after a call.utterance event, use the persistent Agent Relay or push context over HTTP. Every response is bound to the exact turn_id from that event. Send short facts, not a script. Include disposition:
The hosted voice does not read context aloud. done, facts, and failed close the turn and the voice rephrases those facts. progress only holds the caller. Returns delivered=true with status: "live" or "duplicate". A 409 means the turn is stale or cancelled; a 410 means the call has ended. Never reuse context from one turn for another.
GET /v1/calls/{id}/transcript returns {role, text, timestamp} turns. role is human (caller) or agent (the AI agent). A call.utterance conversation field uses user and assistant instead.