Notificações Inteligentes icon

Notificações Inteligentes

NI Integration

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
Email 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

Discussion