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

  1. Connect your agent to Hookdeck's MCP server, the 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.

What are MCP events? →

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.

Not affiliated with WhatsApp. Facts are compiled from public sources and linked inline.