WOZTELL icon

WOZTELL

Access WOZTELL API
Join our community

Actions7

Overview

The node integrates with the WOZTELL API to retrieve conversation history for a specific member identified by an external ID within a given channel. It allows filtering chat messages based on date ranges and limits the number of results returned. This is useful in scenarios where you want to analyze or display past interactions of a user in a messaging channel, such as customer support chat logs or marketing campaign conversations.

Practical examples:

  • Fetching WhatsApp chat history of a customer using their phone number.
  • Retrieving Facebook Messenger conversation logs by PSID.
  • Filtering conversations that occurred within a specific timeframe for audit or reporting purposes.

Properties

Name Meaning
Channel The communication channel in WOZTELL (e.g., WhatsApp, Facebook). Can be selected from a list or entered by ID.
ExternalId The unique identifier of the member in the integration system (e.g., PSID for Facebook, phone number for WhatsApp). Phone numbers should include country code and be formatted without special characters.
From Optional filter to only include chats created after this date/time.
To Optional filter to only include chats created before this date/time.
Limit, up to 100 Maximum number of conversation records to return (1 to 100).
Cursor, Optional Pagination cursor to fetch subsequent pages of results.

Output

The node outputs JSON data containing the conversation history matching the specified filters. The structure includes details about each chat message exchanged with the member in the selected channel, such as timestamps, message content, sender information, and any metadata provided by WOZTELL.

If pagination is used, the output may also include a cursor or page info to retrieve additional pages.

No binary data output is indicated.

Dependencies

  • Requires an active WOZTELL API credential configured in n8n for authentication.
  • The node sends POST requests to the WOZTELL base URL with JSON payloads.
  • The "Channel" property supports searching channels via a method integrated into the node, facilitating selection.

Troubleshooting

  • Invalid ExternalId format: Ensure phone numbers include country codes and exclude special characters like parentheses, plus signs, spaces, or dashes.
  • Empty or no results: Check date filters ("From" and "To") to ensure they cover the expected conversation period.
  • API authentication errors: Verify that the WOZTELL API credentials are correctly set up and have necessary permissions.
  • Pagination issues: When using the cursor property, ensure it is valid and corresponds to the previous response's pagination token.
  • Channel not found: If selecting by ID, confirm the channel exists and is accessible by the API key.

Links and References

Discussion