Skip to main content
POST
Accept Call
Answer a ringing call. Either send your SDP answer to the offer from the call webhook, after which the audio flows between WhatsApp and your media server, or send stream and FlowIQ answers the call itself and streams the audio to your WebSocket (media stream). If FlowIQ staff have the inbox open, they see the call as answered on another device.

Basic Usage


Body Parameters


Response

Success (200)


Errors

With stream, a WebSocket endpoint that does not accept the connection within 8 seconds fails the request (validation_error, the message names the reason) and the call keeps ringing. WhatsApp gives you a limited time to answer before the call rings out; accept as soon as your media server has the answer ready.

Authorizations

Authorization
string
header
required

Your FlowIQ organisation API key (Settings → API Keys), sent as a bearer token. Format: Bearer fiq_YOUR_API_KEY

Body

application/json
call_id
string
required

The call's id from the call webhook

Example:

"wacid.HBgLMjc4MjAwMDAwMDAVAgARGBI2RjQ3QkU1RjA5Q0UyMkEzQjQA"

sdp
string

Your SDP answer to the offer in call.session.sdp (leave out when you send stream)

biz_opaque_callback_data
string

Your own reference; WhatsApp sends it back on later events for this call

Maximum string length: 512
stream
object

Have FlowIQ answer the call and stream its audio to your WebSocket (media stream), instead of answering with sdp

Response

Success

organization_id
string<uuid>
success
boolean
call_id
string
action
enum<string>
Available options:
pre_accept,
accept,
reject,
terminate