BASMA TriggerInstall

Summary

Receives BASMA webhook POST events and starts the workflow for the selected event. It extracts message details into a normalized output item, acknowledges accepted events, and can ignore messages sent by you or validate a webhook secret.

Inputs

• Event — Select Message Received (default), Message Status Update, Connection Update, or All Events. Events that do not match are acknowledged without starting the workflow; an incoming event marked UNKNOWN passes the filter.
• Ignore Own Messages — Defaults to true. When enabled, messages with fromMe=true are acknowledged without starting the workflow.
• Validate Secret — Defaults to false. When enabled, checks the X-Basma-Secret header, falling back to the secret query parameter. A mismatch returns an unauthorized response without workflow data.
• Secret — The expected signing secret, shown when Validate Secret is enabled. An empty value skips the mismatch check.

Output shape

A single workflow item containing event, instance, from, remoteJid, fromMe, text, pushName, messageType, messageId, timestamp, and raw.

For accepted events, the trigger returns one JSON item. The from field is derived from remoteJid before the @ suffix; text is extracted from conversation or extendedTextMessage.text, and messageType is inferred from the available message fields. raw contains the normalized webhook payload root. Filtered or ignored events are acknowledged but produce no workflow data; failed secret validation returns an unauthorized response.

Links

• n8n community nodes installation guide