> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wappfy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Wappfy Webhooks Events

> List of available webhook events in Wappfy

Wappfy provides comprehensive webhook support for real-time event notifications. Configure your webhook URL to receive events.

## Available Webhook Events

Below is a list of all available webhook events in Wappfy:

### Session Events

| Event            | Description                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------------- |
| `session.status` | Triggered when the session status changes (STOPPED, STARTING, SCAN\_QR\_CODE, WORKING, FAILED) |

### Message Events

| Event              | Description                                          |
| ------------------ | ---------------------------------------------------- |
| `message`          | Incoming message received                            |
| `message.reaction` | User reacts or removes a reaction to a message       |
| `message.any`      | Fired on all message creations, including your own   |
| `message.ack`      | Server or recipient gets, reads or plays the message |
| `message.revoked`  | Message is revoked by sender or recipient            |

### Group Events

| Event                   | Description                                               |
| ----------------------- | --------------------------------------------------------- |
| `group.v2.join`         | You joined or were added to a group                       |
| `group.v2.leave`        | You left or were removed from a group                     |
| `group.v2.update`       | Group information is updated                              |
| `group.v2.participants` | Group participants change (join, leave, promote to admin) |

### Presence Events

| Event             | Description                                                             |
| ----------------- | ----------------------------------------------------------------------- |
| `presence.update` | Most recent presence information for a chat (online, typing, recording) |

### Poll Events

| Event              | Description                          |
| ------------------ | ------------------------------------ |
| `poll.vote`        | Receive new votes for a poll sent    |
| `poll.vote.failed` | Failed to decrypt a vote from a user |

### Chat Events

| Event          | Description                    |
| -------------- | ------------------------------ |
| `chat.archive` | Chat is archived or unarchived |

### Call Events

| Event           | Description                  |
| --------------- | ---------------------------- |
| `call.received` | Call is received by the user |
| `call.accepted` | Call is accepted by the user |
| `call.rejected` | Call is rejected by the user |

### Label Events

| Event                | Description                  |
| -------------------- | ---------------------------- |
| `label.upsert`       | Label is created or updated  |
| `label.deleted`      | Label is deleted             |
| `label.chat.added`   | Label is added to a chat     |
| `label.chat.deleted` | Label is deleted from a chat |

### System Events

| Event                   | Description                      |
| ----------------------- | -------------------------------- |
| `event.response`        | Event response is received       |
| `event.response.failed` | Event response failed to decrypt |
| `engine.event`          | Internal engine event            |

## Webhook Configuration

Configure webhooks when creating or updating a session by providing the webhook URL and events to subscribe to in the session configuration