bashcurl -X POST "https://{workspace_id}.firetell.app/api/v1/calls/make" \-H "Authorization: ApiKey YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"from": { "number": "+14155550100", "name": "VoiceBot Support" },"to": { "number": "+12125550123", "name": "John Doe" },"actions": [{"action": "stream","params": {"ws_url": "wss://bot.example.com/call-stream","track": "both","sample_rate": 8000,"bidirectional": true,"headers": {"Authorization": "Bearer YOUR_BOT_TOKEN"}}}]}'
| Tham số | Kiểu / Mặc định | Chi tiết hoạt động |
|---|---|---|
| ws_url | string (bắt buộc) | Địa chỉ wss:// hoặc ws:// public. Hệ thống chặn IP nội bộ RFC 1918, loopback, link-local và metadata cloud. |
| track | string • both | Chọn nhánh âm thanh: both (stereo — trái là người gọi, phải là người nghe), inbound (chỉ người gọi), hoặc outbound (chỉ đầu bên kia). |
| sample_rate | number • 8000 | Tần số lấy mẫu PCM 16-bit little-endian (Hz): 8000 (tương thích G.711) hoặc 16000 (wideband). |
| bidirectional | boolean • false | Đặt true để phát audio PCM mono từ server của bạn vào cuộc gọi theo thời gian thực. Yêu cầu cuộc gọi đã ở trạng thái ACTIVE. |
| answer_call | boolean • true | Tự động nhấc máy trước khi stream. Chỉ đặt false nếu một action trước đó đã nhấc máy rồi. |
| headers | object • tùy chọn | Header HTTP tùy chỉnh gửi kèm khi bắt tay WebSocket (ví dụ Authorization). Tối đa 10 header. |