WhatsApp webhooks let you send real-time WhatsApp message events from ActiveCampaign to an external URL. You can use this to build your own reporting and data pipelines outside of ActiveCampaign.
This article explains how WhatsApp webhooks work and how you can create one in ActiveCampaign.
How it works
Every time a WhatsApp message change occurs in your account, ActiveCampaign can send that event to a URL that you control. Instead of tracking the outcomes manually inside ActiveCampaign, you can subscribe to specific events and receive them as they happen.
This is designed for teams who want to:
- Report on WhatsApp performance by template. Including delivered, failed, and other status visibility
- Extract message-level data to build reporting outside of ActiveCampaign (for example, a data warehouse plus a BI or dashboard tool)
- Create external or shareable reporting for leadership without relying on the native in-app views
You can point the webhook to your own data warehouse, ingest the events, and build reporting tailored to your exact use case from the ground up.
Note that WhatsApp webhooks are separate from the ActiveCampaign public API. These events are not part of ActiveCampaign’s API reference documentation.
Create a WhatsApp webhook
To create a WhatsApp webhook in ActiveCampaign:
- Click “WhatsApp” on the left menu of your ActiveCampaign account.
- Select the “Webhooks” option in the “Manage” section on the left side of your screen.
- This will take you to the Webhook Subscriptions page. Click the “New Webhook Subscription” button in the upper right-hand corner of the screen.
- Paste the target URL into the “Target URL” field. This will be the endpoint where your events will be delivered.
- Your webhook will be set to an active status by default. To pause the webhook, click the “Active” toggle.
- Select the events you want to subscribe to from the “Events to subscribe” section.
- Click the “Create” button.
Once saved, ActiveCampaign will begin posting the selected events to your target URL as they occur. A single webhook can subscribe to any combination of the events listed below.
Events to subscribe
You can subscribe to any of the following events, and they will be delivered to the target URL:
Contact events
- Created — a new contact has been created
- Updated — an existing contact has been updated
- Deleted — a contact has been deleted
Messaging Flow Execution Contact events
- Completed — a contact has completed a messaging flow
- Joined Inbound — a contact has entered or advanced a flow from an inbound message
Message events
- Received — an inbound message has been received from a contact
- Sent — a message has been sent from ActiveCampaign
- Delivered — a message has been delivered to the recipient
- Retry — delivery of the message has been retried
- Read — the recipient has read the message
- Failed — the message could not be delivered
Subscribing to the message events gives you per-template delivered/failed visibility and the raw data needed to build reporting outside ActiveCampaign.
Information included in the payload
Each message event delivers a JSON payload for the message. The payload includes fields such as: message ID, contact, direction, status, the WhatsApp template used, message type and body, and timestamps for each stage (queued, accepted, sent, delivered, read, failed). Failed events also include the provider error code and error message. Since the template and per-stage timestamps are included, you can build reporting broken down by template and delivery outcome.