bashcurl -X POST "https://{workspace_id}.firetell.app/api/v1/calls/make" \-H "Authorization: ApiKey sk-YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"from": { "number": "+14155550100", "name": "VoiceBot AI" },"to": { "number": "+12125550123", "name": "John Doe" },"actions": [{"action": "stream","params": {"ws_url": "wss://bot.yourdomain.com/voice-stream","track": "both","sample_rate": 16000,"bidirectional": true,"headers": { "Authorization": "Bearer YOUR_WS_TOKEN" }}}]}'
| Direction | WebSocket Frame | Payload & Rules |
|---|---|---|
| Firetell β Your Server | Binary | PCM 16-bit little-endian at 8000 Hz (default) or 16000 Hz. Stereo (caller left, callee right) when track=both. |
| Your Server β Firetell | Binary | Mono PCM 16-bit little-endian at configured sample_rate. Requires bidirectional: true and answered ACTIVE call. |
| Your Server β Firetell | Text JSON | {"type":"killAudio"} immediately clears queued outbound bot audio for responsive barge-in. |
| Handshake & Identity | URL + Headers | Public wss:// or ws:// only; custom handshake headers (max 10) plus call_id & caller_number query params. |