Skip to main content

connection.open

A WhatsApp device successfully connected and authenticated.
{
  "event": "connection.open",
  "deviceId": 1234567,
  "data": {
    "displayName": "John Doe",
    "phoneNumber": "+1234567890"
  },
  "timestamp": "2024-01-15T10:30:00.000Z"
}

connection.closed

A WhatsApp device disconnected from the server.
{
  "event": "connection.closed",
  "deviceId": 1234567,
  "data": {},
  "timestamp": "2024-01-15T10:35:00.000Z"
}

connection.auth

A QR or Pairing code was generated for device pairing. Can either contain qrCode or pairingCode.
{
  "event": "connection.auth",
  "deviceId": 1234567,
  "data": {
    "qrCode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
	"pairingCode": "ABCD1234"
  },
  "timestamp": "2024-01-15T10:25:00.000Z"
}

connection.timeout

QR or Pairing code timed out without successful pairing.
{
  "event": "connection.timeout",
  "deviceId": 1234567,
  "data": {},
  "timestamp": "2024-01-15T10:27:00.000Z"
}

connection.logout

A connection closed by logout
{
  "event": "connection.logout",
  "deviceId": 1234567,
  "data": {},
  "timestamp": "2024-01-15T10:35:00.000Z"
}

message.received

A new message was received by the WhatsApp instance.
{
  "event": "message.received",
  "deviceId": 1909568,
  "data": {
    "id": "3EB0C7F8A5B2D4E6F9A1C3D5",
    "from": "1234567890",
    "pushName": "John Doe",
    "content": {
      "text": "Hello world"
    },
    "type": "text"
  },
  "timestamp": "2025-10-23T10:53:48.552Z"
}

message.sent

A message was sent from the WhatsApp device.
{
  "event": "message.sent",
  "deviceId": 1234567,
  "data": {
    "id": "3EB0C7F8A5B2D4E6F9A1C3D6",
    "to": "0987654321",
    "content": {
      "text": "Thanks for reaching out!"
    },
    "type": "text"
  },
  "timestamp": "2024-01-15T10:41:00.000Z"
}

message.updated

A message was edited.
{
  "event": "message.updated",
  "deviceId": 1234567,
  "data": {
    "messageId": "3EB0C7F8A5B2D4E6F9A1C3D6",
    "from": "0987654321",
    "fromMe": true,
    "update": {
      "editedContent": {
        "text": "Edited text content"
      },
      "messageType": "text"
    }
  },
  "timestamp": "2024-01-15T10:42:00.000Z"
}

message.deleted

A message was deleted.
{
  "event": "message.deleted",
  "deviceId": 1909568,
  "data": {
    "messageId": "3EB0C7F8A5B2D4E6F9A1C3D6",
    "from": "0987654321",
    "fromMe": false
  },
  "timestamp": "2025-10-22T21:55:44.332Z"
}

call

A whatsapp call was received, accepted, rejected or timed out
{
  "event": "call",
  "deviceId": 1234567,
  "data": {
    "id": "string",
    "from": "1234567890",
    "status": "offer | accept | timeout | reject",
    "isVideo": true,
    "isGroup": false,
    "date": 1678901250
  },
  "timestamp": "2024-01-15T10:45:00.000Z"
}