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

# Webhook Handling & Events

> Handle WhatsApp webhooks and events using the Laravel SDK

## Overview

In this guide, we will cover how to handle incoming WhatsApp webhooks and events using the Hypersender Laravel SDK. Webhooks are a powerful way to receive real-time updates from WhatsApp, allowing your application to respond to messages, status changes, and other events as they happen.

### Setting Up Webhooks

1. The package auto-registers a POST route (default /whatsapp/webhook).
2. Verifies the signature using the secret in config/env.
3. Dispatches a dedicated Laravel event for each webhook event type (e.g., MessagesUpserted, GroupsUpdated, etc.).
4. Listen for events in your app:

```php theme={null}
use Hypersender\Events\Whatsapp\PresenceUpdate;

Event::listen(PresenceUpdate::class, function ($event) {
    $event->payload
});
```

<Tip>
  See the Webhook Usage in it's dedicated section for more details [webhook usage](/api-reference/whatsapp-webhooks/introduction).
</Tip>

### Available Webhook Events

The following events are available for handling WhatsApp webhooks:

* `Hypersender\Events\Whatsapp\PresenceUpdate`
* `Hypersender\Events\Whatsapp\MessagesAny`
* `Hypersender\Events\Whatsapp\MessageReaction`
* `Hypersender\Events\Whatsapp\MessagesAck`
* `Hypersender\Events\Whatsapp\MessagesWaiting`
* `Hypersender\Events\Whatsapp\MessagesRevoked`
* `Hypersender\Events\Whatsapp\PollVote`
* `Hypersender\Events\Whatsapp\PollVoteFailed`

### Customizing the Webhook Route

To customize the webhook route, you can publish the package's configuration file and modify the `webhook_route` setting:

```bash theme={null}
php artisan vendor:publish --tag="hypersender-config"
```

Then, update the `whatsapp_webhook_route` in `config/hypersender-config.php`:

```php theme={null}
'whatsapp_webhook_route' => 'your/custom/route',
```