# WhatsApp MCP events

WhatsApp's webhook events are available to agents as MCP events through Hookdeck Event Gateway.

Agent skill: `npx skills add hookdeck/webhook-skills --skill whatsapp-webhooks` ([details](https://hookdeck.com/webhooks/whatsapp/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [WhatsApp's official docs](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks).

[Overview](https://hookdeck.com/webhooks/whatsapp) · [Webhook events (29)](https://hookdeck.com/webhooks/whatsapp/events) · [MCP events](https://hookdeck.com/webhooks/whatsapp/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/whatsapp/verify) · [Production guide](https://hookdeck.com/webhooks/whatsapp/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/whatsapp/skill)

## WhatsApp's MCP server

WhatsApp Business Tools MCP is Meta's server for managing the WhatsApp Business Platform from an agent: accounts, phone numbers, message templates, webhook configuration and sending messages. It's in beta and rolling out gradually. Its tools set up where events go, but they don't deliver WhatsApp's events to the agent. To get those into an agent, subscribe it through Hookdeck Event Gateway, as described below. [WhatsApp's MCP docs](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)

## How to subscribe

1. Connect your agent to Hookdeck's MCP server ([MCP Events bridge](https://hookdeck.com/blog/mcp-events-bridge)).
2. Point your WhatsApp webhook at a Hookdeck source.
3. Your agent lists the available events and subscribes to the ones it needs.

## Events

| Webhook event | MCP event |
|---|---|
| [account_alerts](https://hookdeck.com/webhooks/whatsapp/events#account_alerts) | `whatsapp.account_alerts` |
| [account_review_update](https://hookdeck.com/webhooks/whatsapp/events#account_review_update) | `whatsapp.account_review_update` |
| [account_settings_update](https://hookdeck.com/webhooks/whatsapp/events#account_settings_update) | `whatsapp.account_settings_update` |
| [account_update](https://hookdeck.com/webhooks/whatsapp/events#account_update) | `whatsapp.account_update` |
| [automatic_events](https://hookdeck.com/webhooks/whatsapp/events#automatic_events) | `whatsapp.automatic_events` |
| [business_capability_update](https://hookdeck.com/webhooks/whatsapp/events#business_capability_update) | `whatsapp.business_capability_update` |
| [calls](https://hookdeck.com/webhooks/whatsapp/events#calls) | `whatsapp.calls` |
| [consumer_profile](https://hookdeck.com/webhooks/whatsapp/events#consumer_profile) | `whatsapp.consumer_profile` |
| [group_lifecycle_update](https://hookdeck.com/webhooks/whatsapp/events#group_lifecycle_update) | `whatsapp.group_lifecycle_update` |
| [group_participants_update](https://hookdeck.com/webhooks/whatsapp/events#group_participants_update) | `whatsapp.group_participants_update` |
| [group_settings_update](https://hookdeck.com/webhooks/whatsapp/events#group_settings_update) | `whatsapp.group_settings_update` |
| [group_status_update](https://hookdeck.com/webhooks/whatsapp/events#group_status_update) | `whatsapp.group_status_update` |
| [history](https://hookdeck.com/webhooks/whatsapp/events#history) | `whatsapp.history` |
| [message_echoes](https://hookdeck.com/webhooks/whatsapp/events#message_echoes) | `whatsapp.message_echoes` |
| [message_template_components_update](https://hookdeck.com/webhooks/whatsapp/events#message_template_components_update) | `whatsapp.message_template_components_update` |
| [message_template_quality_update](https://hookdeck.com/webhooks/whatsapp/events#message_template_quality_update) | `whatsapp.message_template_quality_update` |
| [message_template_status_update](https://hookdeck.com/webhooks/whatsapp/events#message_template_status_update) | `whatsapp.message_template_status_update` |
| [messages](https://hookdeck.com/webhooks/whatsapp/events#messages) | `whatsapp.messages` |
| [messaging_handovers](https://hookdeck.com/webhooks/whatsapp/events#messaging_handovers) | `whatsapp.messaging_handovers` |
| [partner_solutions](https://hookdeck.com/webhooks/whatsapp/events#partner_solutions) | `whatsapp.partner_solutions` |
| [payment_configuration_update](https://hookdeck.com/webhooks/whatsapp/events#payment_configuration_update) | `whatsapp.payment_configuration_update` |
| [phone_number_name_update](https://hookdeck.com/webhooks/whatsapp/events#phone_number_name_update) | `whatsapp.phone_number_name_update` |
| [phone_number_quality_update](https://hookdeck.com/webhooks/whatsapp/events#phone_number_quality_update) | `whatsapp.phone_number_quality_update` |
| [security](https://hookdeck.com/webhooks/whatsapp/events#security) | `whatsapp.security` |
| [smb_app_state_sync](https://hookdeck.com/webhooks/whatsapp/events#smb_app_state_sync) | `whatsapp.smb_app_state_sync` |
| [smb_message_echoes](https://hookdeck.com/webhooks/whatsapp/events#smb_message_echoes) | `whatsapp.smb_message_echoes` |
| [standby](https://hookdeck.com/webhooks/whatsapp/events#standby) | `whatsapp.standby` |
| [template_category_update](https://hookdeck.com/webhooks/whatsapp/events#template_category_update) | `whatsapp.template_category_update` |
| [user_preferences](https://hookdeck.com/webhooks/whatsapp/events#user_preferences) | `whatsapp.user_preferences` |
---

Not affiliated with WhatsApp. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/whatsapp.json) · [Report a correction](https://hookdeck.com/contact)
