flow api
Calls · POST

callsDial

Calls (beta): start a WhatsApp voice call. Then send your WebRTC offer over the callsRtc WebSocket to talk from a browser or app.

Video walkthrough: callsDial · 14 seconds · click the bar to jump to a step

Endpoint

POST https://flowapi.pro/waInstance{idInstance}/callsDial/{apiTokenInstance}

Request body

{
  "chatId": "972501234567@c.us"
}

Example

curl -X POST "https://flowapi.pro/waInstance{idInstance}/callsDial/{apiTokenInstance}" \
  -H "Content-Type: application/json" \
  -d '{"chatId":"972501234567@c.us"}'

Response

{
  "callId": "AC0E17D82A7B513089A667F636DD2AE5"
}

Notes

  • chatId is 972501234567@c.us or 123456789012345@lid.
  • Errors: 400 bad chatId, 409 calls not linked or a call is already active, 500 Dial error, 503 call refused.
  • Audio flows through wss://flowapi.pro/waInstance{idInstance}/callsRtc/{apiTokenInstance}: send {"type":"offer","offer":{type,sdp}} and ice-candidate messages; you receive state, answer and ice-candidate messages. Same protocol as Green API.
  • One call at a time per number, up to 90 minutes. Free during the beta.
Green API compatible. callsDial uses the same name, request body and response as Green API, so existing code works after you change the host to flowapi.pro. Errors: 401 wrong instance or token, 402 trial ended or number not covered by your plan, 429 rate limit reached (wait the seconds in the Retry-After header), 400 with a message for anything else.

More calls methods

Try it on your own number

7 days free, no credit card. Then $10 per number per month.

Start free trial