WOZTELL icon

WOZTELL

Access WOZTELL API
Join our community

Actions7

Overview

The node provides integration with the WOZTELL API, specifically allowing operations on members and bots within the WOZTELL platform. For the Member resource and the Set Member Tags operation, the node enables users to assign one or more tags to a member identified by an external ID (such as a Facebook PSID or WhatsApp phone number). This tagging functionality is useful for segmenting members, personalizing communication, or triggering workflows based on member attributes.

Practical examples:

  • Tagging a WhatsApp user with "premium_customer" after they make a purchase.
  • Assigning tags like "interested" or "lead" to Facebook Messenger users based on their interaction.
  • Organizing members into groups for targeted messaging campaigns.

Properties

Name Meaning
Channel The WOZTELL channel where the member exists. Can be selected from a searchable list or specified by ID.
ExternalId The unique identifier of the member in the external system (e.g., PSID for Facebook, phone number for WhatsApp). Phone numbers should include country code and be formatted without special characters.
Tags, Comma Separation A comma-separated list of tags to assign to the member. Tags are trimmed and split automatically.

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 involved in this operation.

Dependencies

  • Requires an active WOZTELL API credential configured in n8n to authenticate requests.
  • The node uses the WOZTELL base URL and expects JSON content-type headers.
  • The "Channel" property relies on dynamic loading of available channels via the WOZTELL API.
  • Proper formatting of the ExternalId is important; phone numbers must include country codes and exclude special characters like parentheses, plus signs, dashes, or spaces.

Troubleshooting

  • Invalid ExternalId format: If the external ID (especially phone numbers) contains invalid characters, the API may reject the request. Ensure the input removes all non-numeric characters except the leading country code.
  • Channel not found or unauthorized: Selecting a channel that does not exist or to which the API key lacks access will cause errors. Verify channel availability and permissions.
  • Empty or malformed tags: Providing empty tags or incorrect separators might result in no tags being set. Use commas to separate tags and avoid unusual characters.
  • API authentication errors: If the API key is missing or invalid, the node will fail to authenticate. Confirm the WOZTELL credentials are correctly set up in n8n.
  • Network or API downtime: Temporary connectivity issues or WOZTELL service outages can cause failures. Retry later or check WOZTELL status.

Links and References

Discussion