Actions7
Overview
The "Get Members By Tags" operation in the WOZTELL node allows users to retrieve members filtered by specific tags within a selected communication channel. This is useful for segmenting members based on interests, behaviors, or any custom tagging system implemented in WOZTELL. For example, a marketing team could use this operation to fetch all members tagged as "premium customers" or "newsletter subscribers" to target them with personalized campaigns.
Properties
| Name | Meaning |
|---|---|
| Channel | The WOZTELL channel from which to retrieve members. Can be selected from a list or specified by ID. |
| Tags, Comma Separation | A comma-separated list of tags used to filter members. Only members matching these tags will be returned. |
| Return All | Whether to return all matching members or limit the number of results. |
| Limit, up to 100 | Maximum number of members to return if not returning all. Value must be between 1 and 100. |
| Cursor, Optional | Pagination cursor to fetch the next page of results when not returning all members. |
Output
The output JSON contains an array of member objects that match the specified tag filters within the chosen channel. Each member object typically includes member details such as identifiers, contact information, and associated tags. If pagination is used, the output may also include metadata like cursors for fetching subsequent pages.
The node does not explicitly mention binary data output for this operation.
Dependencies
- Requires an API key credential for authenticating requests to the WOZTELL API.
- Needs proper configuration of the WOZTELL base URL and authentication headers within n8n.
- The "Channel" property depends on the ability to search or specify channels available in the WOZTELL account.
Troubleshooting
- Empty Results: Ensure that the tags entered exactly match those assigned to members in WOZTELL. Tag names are case-sensitive and should be comma-separated without extra spaces.
- Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions to access member data.
- Pagination Issues: When using the cursor property, ensure it is valid and corresponds to the previous response's pagination token.
- Limit Exceeded: The maximum allowed limit is 100; setting a higher value will likely cause errors.
- Channel Not Found: If selecting a channel by ID or from the list fails, confirm that the channel exists and the user has access rights.
Links and References
- WOZTELL Official API Documentation (for detailed API usage and tag management)
- n8n Documentation on Creating Custom Nodes