YCloud Trigger - Growsales AI icon

YCloud Trigger - Growsales AI

Starts the workflow when YCloud events occur (WhatsApp inbound messages, status updates, etc.)

YCloud Trigger - Growsales AI

AI-generated

Summary

Trigger workflows when specified YCloud events occur by receiving webhooks from the YCloud platform and optionally validating their signatures.

Inputs

  • Events to Listen For (required) — Select one or more YCloud events that will trigger this workflow. Options include various contact, email, SMS, voice, and WhatsApp events such as 'WhatsApp: Inbound Message Received' (default).
  • Options — Configure optional settings such as 'Validate Signature' to enable HMAC-SHA256 signature verification if your YCloud plan provides signed webhooks.

Output shape

a single webhook event payload per trigger containing the JSON body sent by YCloud, augmented with a '_signatureValid' boolean if signature validation is enabled.

The node sets up a webhook to receive POST requests from YCloud for the selected events. When signature validation is enabled, the node compares the incoming signature header against an HMAC-SHA256 hash computed from the webhook secret and payload. On signature mismatch, the workflow is still triggered but the '_signatureValid' flag is set to false. Otherwise, the flag is true or omitted if validation is disabled.

Examples

Example 1: Trigger on WhatsApp inbound messages

Select only the 'WhatsApp: Inbound Message Received' event in 'Events to Listen For' and leave 'Validate Signature' disabled to start the workflow whenever an inbound WhatsApp message is received via YCloud.

Example 2: Securely trigger workflow with signed webhooks

Select desired events and enable 'Validate Signature' option to ensure incoming webhook requests from YCloud are verified against the HMAC-SHA256 signature using the webhook secret stored during webhook setup.

Links

Discussion