YCloud Inbound Trigger icon

YCloud Inbound Trigger

Starts the workflow when a WhatsApp inbound message is received and routes it directly by message type — no extra Switch/Router node needed.

YCloud Inbound Trigger

AI-generated

Summary

Receive WhatsApp inbound messages via a webhook from YCloud, optionally validate their HMAC-SHA256 signature, detect specified keywords in text messages to label them, and route each message to an output corresponding to its message type.

Inputs

  • Validate Signature — Boolean option to enable validation of the HMAC-SHA256 signature sent by YCloud in the webhook request headers to ensure message authenticity.
  • Keyword Rules (Text Messages) — An optional list of rules where each rule defines a keyword and a label; if a text message contains the keyword (case-insensitive partial match), the trigger adds a _keyword field with the specified label to the output item.

Output shape

Multiple outputs, each an array containing zero or one JSON item representing the inbound message enriched with optional keyword label and signature validation status; one output for each supported message type plus one for other unrecognized types.

There are separate outputs for message types: Text, Image, Video, Audio, Document, Location, Interactive, Sticker, Reaction, and Other. Only the matching output emits data for each inbound message, all others emit empty arrays. If signature validation is enabled and fails, the message is routed to the 'Other' output with _signatureValid set to false. Message payloads are based on the webhook JSON respecting possible nesting under 'data' and 'whatsappInboundMessage' keys.

Links

Discussion