Actions148
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
Overview
This node enables users to create and manage webhooks for a WhatsApp API integration. Specifically, the Create Webhook operation allows setting up an HTTP endpoint that will receive real-time notifications about various WhatsApp events such as incoming messages, message status updates, group or chat changes, and session status updates.
Common scenarios where this node is beneficial include:
- Automatically processing inbound WhatsApp messages by triggering workflows when new messages arrive.
- Tracking outbound message delivery statuses to update CRM or support systems.
- Monitoring group or contact updates to synchronize data with external databases.
- Reacting to user session changes for managing active device states.
For example, a customer support team can use this webhook to get notified instantly when a new message arrives on their WhatsApp number and trigger an automated response or ticket creation workflow.
Properties
| Name | Meaning |
|---|---|
| Webhook Name | Internal identifier for the webhook (up to 30 characters). |
| Webhook URL | Publicly accessible endpoint URL that will receive HTTP POST requests when specified events occur. |
| Event Types | List of event types to subscribe to. Options include: - New Inbound Message - New Outbound Message - Outbound Message Sent - Outbound Message Delivery Status - Outbound Message Failed - Message Updated - Message Reaction - Channel Message Received - Status Update - Group Update - Chat Update - Contact Update - WhatsApp Session Status |
| Device ID (Optional) | Restrict webhook notifications to a specific WhatsApp device identified by a 24-character hexadecimal ID. |
Output
The node outputs JSON objects representing the result of the webhook creation operation. The output typically includes details confirming the webhook setup, such as its internal ID, subscribed events, and associated device if specified.
Since this node deals with webhook configuration, it does not output binary data.
Dependencies
- Requires an active connection to the WhatsApp API service via an API key credential.
- The webhook URL must be publicly accessible to receive HTTP POST callbacks from the WhatsApp API.
- Proper permissions and API access to manage webhooks on the WhatsApp platform are necessary.
Troubleshooting
- Webhook URL unreachable: Ensure the provided webhook URL is publicly accessible and can accept POST requests. Use tools like
curlor online webhook testers to verify. - Invalid event types: Confirm that selected event types are valid and supported by the WhatsApp API.
- Device ID restrictions: If specifying a device ID, ensure it matches a registered WhatsApp device in your account.
- API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Error messages: The node may throw errors related to network issues, invalid parameters, or permission denials. Review error messages carefully and check API documentation for required parameters and scopes.