WhatsApp MCP events
WhatsApp's webhook events are available to agents as MCP events through Hookdeck Event Gateway.
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 ↗How to subscribe
- Connect your agent to Hookdeck's MCP server, the MCP Events bridge.
- Point your WhatsApp webhook at a Hookdeck source.
- Your agent lists the available events and subscribes to the ones it needs.
Events
| Webhook event | MCP event |
|---|---|
account_alerts | whatsapp.account_alerts |
account_review_update | whatsapp.account_review_update |
account_settings_update | whatsapp.account_settings_update |
account_update | whatsapp.account_update |
automatic_events | whatsapp.automatic_events |
business_capability_update | whatsapp.business_capability_update |
calls | whatsapp.calls |
consumer_profile | whatsapp.consumer_profile |
group_lifecycle_update | whatsapp.group_lifecycle_update |
group_participants_update | whatsapp.group_participants_update |
group_settings_update | whatsapp.group_settings_update |
group_status_update | whatsapp.group_status_update |
history | whatsapp.history |
message_echoes | whatsapp.message_echoes |
message_template_components_update | whatsapp.message_template_components_update |
message_template_quality_update | whatsapp.message_template_quality_update |
message_template_status_update | whatsapp.message_template_status_update |
messages | whatsapp.messages |
messaging_handovers | whatsapp.messaging_handovers |
partner_solutions | whatsapp.partner_solutions |
payment_configuration_update | whatsapp.payment_configuration_update |
phone_number_name_update | whatsapp.phone_number_name_update |
phone_number_quality_update | whatsapp.phone_number_quality_update |
security | whatsapp.security |
smb_app_state_sync | whatsapp.smb_app_state_sync |
smb_message_echoes | whatsapp.smb_message_echoes |
standby | whatsapp.standby |
template_category_update | whatsapp.template_category_update |
user_preferences | whatsapp.user_preferences |
Subscribe your agent to WhatsApp events.
Point your WhatsApp webhook at Event Gateway and run the MCP Events bridge. Event Gateway delivers each event to the agents whose subscription filters it matches, and retries failures.