Start a web call | TelEcho API Reference

Start a browser-based call with one of your agents or workflows. Returns a LiveKit room name, WebSocket URL, and a short-lived client token. Pass these to the LiveKit web client to join the call.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

agent_idstringOptional

Public agent ID to call. Provide either agent_id or workflow_id.

workflow_idstringOptional

Public workflow ID to call.

metadatamap from strings to anyOptional

Optional metadata stored with the call session.

Response

Successful Response

call_idstring

room_namestring

livekit_urlstring

tokenstring

Errors

422

Start Web Call Calls Web Post Request Unprocessable Entity Error

$	curl -X POST https://next-dev.rtcleague.com/api/v1/public/calls/web \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"agent_id": "tel_agt_a3f9b22e",
>	"metadata": {
>	"customer_id": "cus_123"
>	}
>	}'

1	{
2	"call_id": "tel_call_19a8c4d3e2f1",
3	"room_name": "webcall-a3f9b22e1c4d",
4	"livekit_url": "wss://livekit.example.com",
5	"token": "eyJhbGciOiJI..."
6	}