Calls

Realtime media session (web)

Opens a short-lived full-duplex media session on an active call. Body: { mode: "talk" | "listen" } — talk sends YOUR audio and receives the peer's; listen only receives. Returns { wsUrl, token, expiresInSeconds }: connect a WebSocket to wsUrl and exchange RAW binary PCM16 little-endian audio frames (plain WebSocket transport, NOT WebRTC; single-use token, ~2 min). Web numbers ONLY — Meta → 400 FEATURE_NOT_SUPPORTED. **Requires a number-scoped key.**

POST

calls

{callId}

realtime-session

Realtime media session (web)

curl --request POST \
  --url https://pilotstatus.com.br/v1/calls/{callId}/realtime-session \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "mode": "talk"
}'

{
  "wsUrl": "wss://evolution-go.pilotstatus.com.br/call/media/realtime/ws/inst1/1A2B3C4D?token=...",
  "token": "d3f4...",
  "expiresInSeconds": 120
}

Authorizations

x-api-key

string

header

required

Your ps_ API key

Path Parameters

callId

string

required

Pilot Status id (call_...) or provider call id (CallID).

Body

application/json

mode

string

required

talk = send and receive audio; listen = receive only.

Example:

"talk"

Response

Open realtime session

Play audio into call (web)

Get calling settings

⌘I

Realtime media session (web)

curl --request POST \
  --url https://pilotstatus.com.br/v1/calls/{callId}/realtime-session \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "mode": "talk"
}'

{
  "wsUrl": "wss://evolution-go.pilotstatus.com.br/call/media/realtime/ws/inst1/1A2B3C4D?token=...",
  "token": "d3f4...",
  "expiresInSeconds": 120
}