Evolution API Trigger
AI-generatedOverview
This node triggers workflows based on events from the Evolution API, which is used for WhatsApp-related event handling. It listens for specified events from a configured Evolution API instance and starts the workflow when those events occur. Common use cases include automating responses or processing data when messages are received, chats are updated, or other WhatsApp-related events happen.
Use Case Examples
- Automatically process incoming WhatsApp messages when a 'Message Received' event occurs.
- Trigger workflows on chat updates or contact changes to synchronize data with other systems.
- React to instance status changes or connection updates for monitoring and alerting.
Properties
| Name | Meaning |
|---|---|
| Instance Name | The Evolution API instance name to listen for events. |
| Events | Select which specific events from the Evolution API to listen for and trigger the workflow. |
| Options | Additional options to customize webhook behavior. |
Output
JSON
event- The raw event name received from the Evolution API.eventNormalized- Normalized event name with special characters replaced and uppercased.instance- The instance name from which the event originated.data- The main data payload of the event.timestamp- The timestamp when the event occurred.sender- Information about the sender of the event.serverUrl- The server URL from which the event was received.destination- The destination related to the event.rawBody- The complete raw event payload as received.
Dependencies
- Requires an API key credential for the Evolution API to authenticate requests.
Troubleshooting
- If the webhook registration fails, check the API key and server URL credentials for correctness.
- Ensure the instance name matches the one configured in the Evolution API to receive events properly.
- If no events trigger the workflow, verify that the selected events in the node settings match the events sent by the Evolution API.
- Errors during webhook creation or deletion usually indicate network or permission issues with the Evolution API server.