📞 Calls

You can receive events about calls in WhatsApp using API!

Features

Here’s the list of features that are available by 🏭 Engines:

📞 Calls - API

API	WEBJS	GOWS	NOWEB
Reject call `POST /api/{session}/calls/reject`	✔️	✔️	✔️

📞 Calls - Events

Events	WEBJS	GOWS	NOWEB
`call.received`	✔️	✔️	✔️
`call.accepted`		✔️	✔️
`call.rejected`	✔️¹	✔️	✔️

WEBJS - call.rejected works only when you rejected the call via API

API

Reject Call

Decline an incoming call using its call id and chat id from the call.received event.

POST /api/{session}/calls/reject

{
  "from": "22222222222@c.us",
  "id": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}

👉 Available on WEBJS, GOWS, NOWEB

WAHA emits call.rejected after the call is declined.

Events

call.received

You received an incoming call in WhatsApp (either 1-on-1 or group call).

{
  "event": "call.received",
  "session": "default",
  "payload": {
    "id": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "from": "22222222222@c.us",
    "timestamp": 1721374000,
    "isVideo": false,
    "isGroup": false,
    "_data": {}
  },
  ...
}

call.accepted

Happens when an incoming call is accepted (on another device) in WhatsApp (either 1-on-1 or group call).

{
  "event": "call.accepted",
  "session": "default",
  "payload": {
    "id": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "from": "22222222222@c.us",
    "timestamp": 1721374000,
    "isVideo": false,
    "isGroup": false,
    "_data": {}
  },
  ...
}

call.rejected

Call has been rejected or terminated.

{
  "event": "call.rejected",
  "session": "default",
  "payload": {
    "id": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "from": "22222222222@c.us",
    "timestamp": 1721374000,
    "isVideo": false,
    "isGroup": false,
    "_data": {}
  },
  ...
}

Edit this page on GitHub

📅 Event Message

🏭 Engines

📞 Calls

Features#

API#

Reject Call#

Events#

call.received#

call.accepted#

call.rejected#