New Evolution API Trigger
AI-generatedSummary
Listen for specified real-time events from the Evolution API associated with a chosen WhatsApp instance and trigger workflows with event data via a webhook.
Inputs
- Path (required) — Specify the webhook path segment (e.g., webhook-evolution). The full webhook URL is shown after saving.
- Instance Name or ID (required) — Select the Evolution API WhatsApp instance from a list or specify its ID via an expression.
- Events (required) — Select one or multiple event types to listen for, such as message updates, chats, contacts, calls, and more.
- Options — Configure behavior like ignoring messages sent by the user, ignoring own newsletters, removing raw data to reduce payload size, including media as base64, and sending events to separate webhook URLs.
Output shape
A single JSON object per event received, containing the event name, instance identifier, processed event data fields (with optional raw data omission), and metadata such as sender and timestamps.
The webhook receives POST requests with event payloads from the Evolution API. Duplicate events for the same message ID are filtered within 30 seconds. Payload can be optimized to reduce size by default. Options allow filtering out messages sent by the instance or newsletters owned by the instance to avoid loops. Media inclusion in base64 is optional. When enabled, separate webhook URLs per event type are supported.
Examples
Example 1: Trigger workflow on new incoming or outgoing WhatsApp messages from the selected Evolution API instance.
Set 'Path' to 'webhook-evolution', select 'MESSAGES_UPSERT' event, choose your WhatsApp instance, and enable default options.