FullFunnel Tags

Gerenciar tags de contatos na FullFunnel (GoHighLevel)

Actions5

Overview

This node manages contact tags within 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 organizing contacts by categories such as customer status, interests, or campaign segments.

Common scenarios include:

  • Adding tags like "vip" or "lead-quente" to a single contact to track their status.
  • Removing outdated or incorrect tags from contacts.
  • Replacing all tags of a contact to update their categorization.
  • Bulk adding or removing tags across many contacts for large-scale updates.

Practical example: A marketing team can tag contacts who attended a webinar with "webinar2024" and later bulk-remove that tag after the campaign ends.

Properties

Name Meaning
Options Collection of options affecting tag processing:
- Case Sensitive: Whether tag matching should be case sensitive (true/false).
- Create Missing Tags: Whether to create tags that don't exist yet (true/false).
- Normalize Tags: Whether to normalize tags by trimming spaces and converting to lowercase (true/false).

Note: The above options apply when managing tags for the "Contact Tags" resource.

Output

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

  • For Add Tags:

    {
  "success": true,
  "contactId": "<contact ID>",
  "tagsAdded": ["tag1", "tag2"],
  ...additional API response data
}

  • For Remove Tags:

    {
  "success": true,
  "contactId": "<contact ID>",
  "tagsRemoved": ["tag1", "tag2"],
  ...additional API response data
}

  • For Replace Tags:

    {
  "success": true,
  "contactId": "<contact ID>",
  "previousTags": ["oldTag1", "oldTag2"],
  "newTags": ["newTag1", "newTag2"],
  ...additional API response data
}

  • For Bulk Add/Remove Tags:

    {
  "operation": "bulkAdd" | "bulkRemove",
  "totalContacts": <number>,
  "successful": <number>,
  "failed": <number>,
  "results": [
    {
      "contactId": "<contact ID>",
      "success": true,
      "tagsAdded" or "tagsRemoved": ["tag1", "tag2"]
    },
    {
      "contactId": "<contact ID>",
      "success": false,
      "error": "<error message>"
    }
    // ...more results per contact
  ]
}

If any errors occur during execution and the node is set to continue on failure, error details are included in the output JSON.

Dependencies

  • Requires an API key credential for FullFunnel (GoHighLevel) to authenticate requests.
  • Uses FullFunnel REST API v2 endpoints under https://rest.gohighlevel.com/v2.
  • The node expects the user to provide valid contact IDs and tags formatted as comma-separated strings.

Troubleshooting

  • Invalid Contact ID: If a contact ID does not exist, the API will return an error. Verify contact IDs before running the node.
  • Tag Normalization Issues: If tags are not normalized as expected, check the "Normalize Tags" option.
  • Case Sensitivity: Tag matching depends on the "Case Sensitive" option; mismatches may cause unexpected behavior.
  • API Authentication Errors: Ensure the provided API key credential is valid and has necessary permissions.
  • Bulk Operation Failures: Some contacts may fail individually during bulk operations; review the detailed results array for specific errors.
  • Create Missing Tags Disabled: If this option is false, attempts to add non-existing tags may fail.

Links and References

Discussion