WaswuzPlatform Webhook icon

WaswuzPlatform Webhook

Receive incoming webhook events from WaswuzPlatform

WaswuzPlatform Webhook

AI-generated

Summary

Receive and validate incoming POST webhook requests from WaswuzPlatform on a configurable path with optional authentication, optionally send a typing indicator to customer conversations, and output the request details for further workflow processing.

Inputs

  • Path (required) — Specify the webhook path appended to the base URL where WaswuzPlatform will send webhook POST requests.
  • Authentication (required) — Select the method to verify incoming webhook requests: None, Header Secret, or HMAC Signature.
  • Secret Header Name (required) — (If using Header Secret) Define the name of the header carrying the shared secret to validate against.
  • Secret Value (required) — (If using Header Secret) Provide the shared secret value to authenticate requests.
  • Signature Header Name (required) — (If using HMAC Signature) Define the header name containing the HMAC-SHA256 signature.
  • Auto Send Typing — Enable to automatically send a typing indicator before continuing the workflow.
  • Customer Lookup — When auto sending typing, choose the type of customer identifier to extract from the webhook payload (Customer ID, Phone Number, or Instagram Username).
  • Customer Identifier Path — Optional dot notation path in the JSON webhook body to locate the customer identifier. Leave empty to use common default paths.
  • Channel — Select the messaging channel for the typing indicator or leave blank for auto-detection.
  • WhatsApp Phone Number ID — (For WhatsApp channel) Optional source phone number ID for typing events.
  • Instagram Account ID — (For Instagram channel) Optional source Instagram account ID for typing events.
  • Facebook Page ID — (For Messenger channel) Optional source Facebook page ID for typing events.
  • Response Body — Plain-text acknowledgement returned immediately to the webhook sender (default: 'ok').

Output shape

a single webhook event object containing json with the webhook request's body, headers, query parameters, URL parameters, HTTP method, and URL.

If Auto Send Typing is enabled, the node sends a typing indicator HTTP POST to WaswuzPlatform prior to returning. Authentication failure or missing required identifiers raise errors and stop workflow execution. The webhook immediately returns the configured plain-text response body.

Examples

Example 1: Receive an unauthenticated webhook on path 'waswuz', outputting incoming JSON payload and HTTP info for processing in downstream workflow nodes.

Path='waswuz'; Authentication='None'; Response Body='ok'.

Example 2: Receive webhook with HMAC validation, auto-send typing indicator on WhatsApp channel using customer ID lookup from payload, return 'ok' response.

Authentication='HMAC Signature'; Signature Header Name='x-waswuz-signature'; Auto Send Typing=true; Customer Lookup='Customer ID'; Channel='WhatsApp'; configure WhatsApp Phone Number ID accordingly.

Links

Discussion