Overview
This node acts as a trigger for WhatsApp Cloud API events, specifically handling token verification and receiving messages. It is useful for workflows that need to authenticate webhook subscriptions from WhatsApp or process incoming WhatsApp messages and status updates. For example, it can verify the webhook token during setup or capture incoming messages and delivery statuses to automate responses or logging.
Use Case Examples
- Verifying the webhook token during WhatsApp Cloud API setup to ensure secure communication.
- Receiving and processing incoming WhatsApp messages to trigger automated workflows.
- Capturing message delivery statuses to update message tracking systems.
Output
JSON
businessNumberId- The WhatsApp business phone number ID associated with the message or status.from- The sender's WhatsApp ID for incoming messages.text- The text content of the incoming message or button payload.id- The unique ID of the incoming message.statusName- The status name of the message delivery (e.g., delivered, read).recipientId- The recipient ID for the message status update.
Dependencies
- Requires WhatsApp Cloud API credentials with a verification token for webhook authentication.
Troubleshooting
- If the webhook verification fails, ensure the verification token in the node credentials matches the token sent by WhatsApp.
- If no messages or statuses are received, verify that the webhook URL is correctly configured in the WhatsApp Cloud API settings and that the webhook is active.
- Authorization errors during token verification indicate a mismatch between the expected and received verification tokens.
Links
- WhatsApp Cloud API Webhooks - Official documentation on setting up and verifying WhatsApp Cloud API webhooks.