Actions7
Overview
This node integrates with the Woztell API to manage members within communication channels. Specifically, the "Set Member Tags" operation allows users to assign one or more tags to a member identified by an external ID in a specified channel. This is useful for categorizing or segmenting members based on custom labels, which can then be used for targeted messaging, analytics, or workflow automation.
Practical examples:
- Tagging customers who have made a recent purchase to trigger follow-up messages.
- Labeling members based on their interests or behavior for personalized marketing campaigns.
- Organizing contacts by region or support priority using tags.
Properties
| Name | Meaning |
|---|---|
| Channel | The communication channel in Woztell where the member exists. Can be selected from a list or specified by ID. |
| ExternalId | The unique identifier of the member in the integration system (e.g., PSID on Facebook, phone number on WhatsApp). Phone numbers should include the country code and be formatted without special characters like -, (, ), +, or spaces. |
| Tags, Comma Separation | A comma-separated list of tags to assign to the member. Tags are trimmed and split into an array before sending. |
Output
The node outputs JSON data representing the response from the Woztell API after setting the member tags. This typically includes confirmation of the updated tags or status information about the operation. The exact structure depends on the API response but generally confirms success or failure.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the Woztell API via an API key credential configured in n8n.
- The node uses the Woztell base URL and expects JSON content-type headers.
- The "Channel" property supports dynamic searching through the Woztell channels endpoint.
- Proper formatting of the external ID (especially phone numbers) is necessary to ensure correct API calls.
Troubleshooting
- Invalid ExternalId format: If the external ID contains unsupported characters or is missing the country code for phone numbers, the API may reject the request. Ensure the external ID is cleaned of special characters and properly formatted.
- Channel not found or unauthorized: Selecting a non-existent or inaccessible channel will cause errors. Verify that the channel exists and the API credentials have permission to access it.
- Empty or malformed tags: Providing empty tags or incorrect separators might result in no tags being set or API errors. Use commas to separate tags and avoid empty entries.
- API authentication errors: If the API key credential is invalid or expired, the node will fail to authenticate. Check and update the API credentials in n8n settings.
- Network issues: Connectivity problems to the Woztell API endpoint will cause request failures. Confirm network access and endpoint availability.
Links and References
- Woztell Official Documentation (for API details and channel/member management)
- n8n Documentation on Credentials (for configuring API keys)
- Best Practices for Phone Number Formatting (recommended format for phone numbers)
If you need further details on other operations or resources, feel free to ask!