Actions48
- Custom Variable Actions
- Custom Variable Group Actions
- Event Actions
- Integration Actions
- Lead Actions
- Lead List Actions
Overview
The node is designed to handle events related to customer orders and interactions, specifically focusing on the "Progress Updated" operation within the "Event" resource. It allows users to send detailed event data about customers and their orders, such as personal information, order details, product metadata, delivery information, and status updates. This node is beneficial in scenarios where businesses want to track and update the progress of orders or customer-related events in an external system for analytics, notifications, or CRM enrichment.
Practical examples include:
- Updating the status of an order when it moves through different stages (e.g., processed, dispatched, delivered).
- Sending customer demographic and contact information along with order details to a marketing or notification platform.
- Tracking delivery information including estimated delivery dates and tracking codes.
- Logging customer events like ticket creation or password changes with associated metadata.
Properties
| Name | Meaning |
|---|---|
| ID | The ID of the existing integration (used in some operations but not specifically for Progress Updated). |
| First Name | Customer’s first name |
| Last Name | Customer’s last name |
| Phone | Customer phone number including country and area code |
| Birth Date | Customer’s birth date (format: YYYY-MM-DD) |
| Currency | Currency used by the customer (e.g., BRL, USD, GBP) |
| Gender | Customer’s gender |
| Customer’s email address | |
| Tax ID (CPF/CNPJ) | Customer’s tax document number |
| IP Address | Customer’s IP address |
| Products | List of products in the order, each with name, quantity, and value |
| Products Field Is Required | Notice indicating that product data is required |
| Order ID | Unique identifier for the order |
| Order Products Total Value | Sum of the values of all products in the order |
| Order Total Value | Total amount of the order including discounts and fees |
| Discount | Total discount amount applied to the order |
| Status | Current order status description for enrichment |
| Address Parameters | Customer address details including city, complement, country, neighborhood, number, postal code, state, and street |
| Delivery Parameters | Delivery details including description, fee amount, message, tracking code, tracking URL, and estimated delivery date |
Output
The node outputs JSON data representing the event sent to the external system. This JSON includes structured customer information, order details, product metadata, and optionally delivery and address information depending on the input properties provided.
If the node supports binary data output, it is not evident from the provided source or properties; thus, the output is primarily JSON-formatted event data.
Dependencies
- Requires an API key credential for authentication to the external service at
https://api.notificacoesinteligentes.com. - Uses HTTP requests to communicate with the external API.
- No additional environment variables or configurations are explicitly mentioned beyond standard API authentication.
Troubleshooting
Common Issues:
- Missing required fields such as customer first name, phone, or product details may cause the API request to fail.
- Incorrectly formatted dates (birthdate or estimated delivery date) could lead to errors.
- Network timeouts or authentication failures if the API key is invalid or missing.
Error Messages:
- Authentication errors typically indicate invalid or missing API credentials.
- Validation errors from the API may specify which required fields are missing or incorrectly formatted.
- Timeout errors suggest network issues or slow API responses; retrying or increasing timeout settings might help.
Links and References
- Notificações Inteligentes API Documentation (assumed base URL for API calls)
- n8n documentation on creating custom nodes and handling HTTP requests: https://docs.n8n.io/creating-nodes/