Notificações Inteligentes icon

Notificações Inteligentes

NI Integration
Join our community

Actions48

Overview

This node operation updates the tags associated with a specific lead in a system. It allows users to add, update, or remove tags from a lead identified by its unique Lead ID. This functionality is useful for managing and organizing leads based on categories, statuses, or other custom labels, enabling better segmentation and targeted actions in marketing or sales workflows.

Practical examples include:

  • Adding new interest tags to a lead after a customer interaction.
  • Updating existing tags to reflect changes in lead status.
  • Removing outdated or irrelevant tags to keep lead data clean.

Properties

Name Meaning
Lead ID The unique identifier of the lead whose tags will be updated.
Tags Tags to be added, updated, or removed from the lead. This is a free-text input.
Selectable Tags A list of pre-existing tags available in the account. Users can select multiple tags from this list to apply to the lead.

Output

The node outputs JSON data representing the result of the tag update operation on the lead. This typically includes confirmation of the tags applied or removed, and possibly the updated lead information reflecting the new tag state.

If binary data output is supported (not evident from the provided code), it would generally represent attachments or files related to the lead, but this node focuses on tag management and does not indicate binary output.

Dependencies

  • Requires access to an external API at https://api.notificacoesinteligentes.com to fetch available tags.
  • Needs an API authentication token or key configured in n8n to authorize requests to the external service.
  • The node uses a helper method to perform authenticated HTTP requests to the API.

Troubleshooting

  • Common Issues:

    • Failure to retrieve tags due to network issues or invalid API credentials.
    • Providing an incorrect or non-existent Lead ID may cause the update operation to fail.
    • Using tags that do not exist or are not selectable might result in no changes or errors.

  • Error Messages:

    • Timeout errors when fetching tags indicate connectivity problems; verify network and API availability.
    • Authentication errors suggest missing or invalid API credentials; ensure proper configuration.
    • Validation errors on Lead ID or tags require checking input values for correctness.

Links and References

Discussion