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 if available. |
Output
The node outputs JSON data containing the conversation history of the specified member within the selected channel. The structure typically includes message details such as timestamps, sender information, message content, and any metadata provided by the Woztell API.
If pagination is used, the output may also include a cursor or page info to retrieve additional pages of conversation history.
No binary data output is indicated.
Dependencies
- Requires an API key credential for authenticating with the Woztell API.
- The node sends POST requests to the Woztell base URL with JSON payloads.
- Proper configuration of the Woztell API credentials in n8n is necessary.
Troubleshooting
- Invalid ExternalId format: Ensure phone numbers include country codes and remove special characters like parentheses, plus signs, dashes, and spaces.
- Empty or no results: Check that the channel and external ID are correct and that the date filters (From/To) are set appropriately.
- API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Pagination issues: If using the cursor property, ensure it is valid and corresponds to the previous response's pagination token.
Links and References
- Woztell Official Documentation (for API details and channel setup)
- n8n Documentation (for general node usage and credential management)