Zalo Event Trigger
AI-generatedSummary
Listen to Zalo events over a direct WebSocket connection, filtering by one or more event types including messages, reactions, message undos, and group management events. Emit enriched event data for use in workflows.
Inputs
- listenEvents (required) — Select one or more event types to listen for: 'message' (1-on-1 and group chats), 'reaction' (message reactions), 'undo' (message recalls), and 'group_event' (group administrative changes). Defaults to ['message'].
- messageTypes — When listening to 'message' events, select message types to include: 'user' (1-on-1 chats) and/or 'group' (Zalo group chats). Defaults to both.
- groupFilter — When listening to group messages, choose which groups to include: 'all' (all groups), 'include' (only selected groups), or 'exclude' (exclude selected groups). Defaults to 'all'.
- groupIds — List of group thread IDs for filtering when 'include' or 'exclude' groupFilter mode is selected. Provide one thread ID per line or separated by commas.
- aggregatePhotoAlbums — Enable to aggregate photo/video album events into a single trigger with media URLs (introduces ~350ms delay). Defaults to true.
- groupEventTypes — When listening to 'group_event' types, select which group event subtypes to receive (e.g., join, leave, add admin). Defaults to common management events.
- selfListen — Toggle to include events originated by yourself, useful for testing. Defaults to false (only events from others).
Output shape
emits enriched event objects matching selected event types as workflow items. Each output item contains the event name plus detailed payload data, including message content, media URLs, group event details, and metadata.
Supports multiple event types concurrently with filtering options. When aggregating photo albums, multiple related events are combined and emitted together. The trigger manages connection lifecycle and filters out events based on selected criteria. Requires valid Zalo Account credentials to connect and listen in real-time via WebSocket.