FullFunnel Tags

Gerenciar tags de contatos na FullFunnel (GoHighLevel)

Actions5

Overview

This node manages tags for contacts in the FullFunnel (GoHighLevel) platform. It allows users to add, remove, replace, or bulk modify tags associated with one or multiple contacts. This is useful for segmenting contacts, managing marketing lists, or organizing customer data based on tags.

Common scenarios:

  • Adding promotional or campaign tags to a list of contacts.
  • Removing outdated or irrelevant tags from contacts.
  • Replacing all tags of a contact to update their status or category.
  • Bulk adding or removing tags across many contacts efficiently.

Practical example:
You have a list of contacts who signed up for a newsletter and want to tag them all with "newsletter" and "2024-campaign". Using this node’s Bulk Add Tags operation, you can input all their IDs and the tags to apply at once.

Properties

Name Meaning
Contact IDs Comma-separated list of contact IDs to which tags will be added or removed (e.g., id1,id2).
Tags Comma-separated list of tags to add, remove, or replace for a single contact (e.g., vip,lead).
Options Collection of options affecting tag processing:
- Case Sensitive Whether tag matching should consider case differences (true or false).
- Create Missing Tags Whether to create tags that do not already exist (true or false).
- Normalize Tags Whether to normalize tags by trimming spaces and converting to lowercase (true or false).

Output

The node outputs JSON objects summarizing the result of each operation:

  • For Bulk Add Tags:
    • operation: The operation performed (bulkAdd).
    • totalContacts: Number of contacts processed.
    • successful: Count of contacts successfully updated.
    • failed: Count of contacts where the operation failed.
    • results: Array of results per contact, each containing:
      • contactId: The contact's ID.
      • success: Boolean indicating success or failure.
      • tagsAdded: List of tags added (on success).
      • error: Error message if the operation failed.

If binary data were involved, it would be summarized here, but this node only handles JSON data related to tags.

Dependencies

  • Requires an API key credential for FullFunnel (GoHighLevel) API access.
  • Needs network connectivity to https://rest.gohighlevel.com/v2.
  • The node uses authenticated HTTP requests to manage contact tags via the FullFunnel REST API.
  • No additional external libraries beyond n8n core dependencies are required.

Troubleshooting

  • Common issues:

    • Invalid or missing contact IDs may cause failures for specific contacts.
    • Incorrect API credentials or expired tokens will result in authentication errors.
    • Network issues or API downtime can cause request failures.
    • Tag normalization settings might cause unexpected tag matching behavior if case sensitivity or trimming is misconfigured.

  • Error messages:

    • Errors returned from the API are captured and included in the output under the error field for each failed contact.
    • If the node is set to continue on fail, it will report errors per contact without stopping the entire execution.
    • Authentication errors typically indicate invalid or missing API credentials; verify and update credentials accordingly.
    • Validation errors may occur if tags or contact IDs are malformed or empty; ensure proper formatting.

Links and References

Discussion