WapiZap TriggerInstall

Summary

Receives WhatsApp events via webhook with advanced filtering options for API versions v1 and v2.

Inputs

• apiVersion — Selects the event format: 'v2' for modern events or 'v1' for Evolution compatible format.
• events — For v2: Events to trigger on (e.g., message.received, connection.changed).
• eventsV1 — For v1: Events to trigger on (e.g., MESSAGES_UPSERT, CONNECTION_UPDATE).
• contextFilters — Filters by chat type (DM/Group), message types, sender numbers, and group whitelists/blacklists.
• contentFilters — Filters message content by keywords, regex, start/end with, or presence of URLs/emails/phone numbers.
• timeFilters — Restricts triggering to specific days of the week and time windows within a configured timezone.
• behaviorFilters — Controls processing logic such as ignoring own messages, enforcing cooldowns, or limiting messages per sender.
• hmacValidation — Configures HMAC SHA256 signature validation using a webhook secret to secure the endpoint.

Output shape

A list of items containing the raw webhook payload JSON.

If the webhook signature is invalid, the event is not received, or the event type does not match the configured list, the operation returns no data. The payload depends on the selected API version.

Examples

Example 1: Trigger on text messages from specific numbers between 9 AM and 6 PM on weekdays.

Select 'v2', enable time filters with timezone, set contextFilters senders, and contentFilters to 'text' only.

Example 2: Ignore messages sent by the bot itself and limit messages to 5 per sender per minute.

Enable behaviorFilters (ignoreOwnMessages, maxPerMinute set to 5).

Example 3: Validate webhook security using HMAC SHA256.

Enable HMAC validation and provide a webhook secret.