Notificações Inteligentes icon

Notificações Inteligentes

NI Integration
Join our community

Actions48

Overview

This node allows you to create a new lead in a marketing or CRM system by providing detailed information about the lead. It is useful for automating lead generation workflows, integrating with external lead capture forms, or syncing leads from other platforms into your system.

Typical use cases include:

  • Automatically adding new leads collected from web forms or landing pages.
  • Enriching lead data with tracking and custom variables for better segmentation.
  • Tagging leads upon creation to organize them for targeted marketing campaigns.

For example, you can use this node to create a lead with their name, phone number (including country code), email, notes, and assign tags or custom variables that help identify the lead’s source or preferences.

Properties

Name Meaning
Lead Name The full name of the lead. This is a required string field.
Phone The lead's phone number including the country code prefix with a plus sign (e.g., +55, +1). This is required.
Email The lead’s email address. Required when creating a lead.
Notes Additional remarks or notes about the lead. Optional text field.
Custom Variables A collection of key-value pairs representing custom variables to add or update on the lead. Each variable has a slug (identifier) and a value. Multiple variables can be added at once.
Tags A string of tags to add or update on the lead. These are free-text tags used for categorization or segmentation.
Selectable Tags Predefined tags available in your account that you can select from a list to assign to the lead.
Tracking Data A collection of optional tracking parameters such as user agent, IP address, advertising click identifiers (Google Ads, Facebook Ads, TikTok, LinkedIn, etc.), UTM campaign details, and others. Used for attribution and analytics.

Output

The node outputs JSON data representing the created lead object. This typically includes all the fields sent during creation along with any additional metadata returned by the API, such as lead ID, timestamps, or status.

If the node supports binary data output (not indicated here), it would represent attachments or files related to the lead, but this node focuses on JSON lead data only.

Dependencies

  • Requires an API key credential for authenticating requests to the external lead management service.
  • The node makes HTTP requests to the service's REST API endpoint https://api.notificacoesinteligentes.com.
  • The "Tags" property dynamically loads available tags via an authenticated GET request to /tags endpoint.
  • Proper network connectivity and valid credentials are necessary for successful operation.

Troubleshooting

  • Missing Required Fields: Errors may occur if required fields like Lead Name, Phone (with plus prefix), or Email (for creation) are missing. Ensure these are provided.
  • Invalid Phone Format: The phone number must include the plus sign (+) followed by the country code. Omitting the plus sign will likely cause validation errors.
  • Authentication Failures: If the API key or authentication token is invalid or expired, the node will fail to connect. Verify credentials and permissions.
  • Tag Loading Issues: If selectable tags do not load, check network access and API permissions for the tag retrieval endpoint.
  • Timeouts: The node uses a 5-second timeout for HTTP requests; slow network or server issues might cause timeouts. Retry or increase timeout if possible.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion