• Save every new WhatsApp lead in Google Sheets.

• Send an automatic message when a CRM record changes status.

• Redirect a user within a WOZTELL bot based on conditions.

Note: This plugin is currently available under the n8n WOZTELL Early Access Program (EAP). It should not be used in production environments or with sensitive data.

What is n8n

Main advantages of using n8n with WOZTELL

• No-code automation: Create visual workflows without needing programming knowledge.

• Flexibility: Connect WOZTELL with any system or API compatible with n8n.

• Time-saving: Automate repetitive tasks such as lead capturing or customer follow-up.

• Scalability: Easily extend your automation logic as your business grows.

• Data control: Deploy n8n on your own infrastructure to maintain compliance and data privacy.

Requirements

Before getting started, make sure you have:

• An active WOZTELL account.

• At least one connected channel (WhatsApp Cloud API, Messenger, Instagram, or Webchat).

• Access to an n8n instance (cloud or self-hosted).

• Administrator access on WOZTELL to generate an Access Token.

Install the package

To install the WOZTELL community node package in n8n:

You can directly access N8N + WOZTELL https://www.npmjs.com/package/@woztell-sanuker/n8n-nodes-woztell-sanuker-eap

For more information, check the n8n Community Nodes installation guide.

Configure credentials

Before using the plugin, you need to obtain your API credentials from the WOZTELL platform. These credentials act as authentication keys to access the WOZTELL Product API. Make sure to enable the required permissions for your use case and enter this information in the WOZTELL credential configuration in n8n.

For more details, check the WOZTELL Access Token documentation.

Channel API Token for WhatsApp templates: each WOZTELL Channel has its own Channel API Token used for WhatsApp Template Messages. Enter this token in the second token field of the WOZTELL credential. We recommend creating separate credentials per channel. More info: WhatsApp Cloud Public API.

Create your first workflow

Triggers and Nodes

Overview

When searching for “WOZTELL” in the sidebar, you will find the available nodes and triggers. You can drag and drop them into your workflow.

• Triggers: Receive webhook data from WOZTELL channels.

• Bot API Actions: Send messages and perform operations via WOZTELL.

• Member Actions: Manage contact information (query, update, tagging) stored in WOZTELL.

Webhook: On WOZTELL Message received

This trigger receives webhook messages from any WOZTELL channel, including Inbound, Outbound, and Member Update events. Messages are delivered in JSON format with event details.

You can configure the Webhook Path and filter by Channel ID or Event Type.

More information: WOZTELL Webhooks documentation.

Node: Send Response

Sends a message from your WhatsApp Business number to the customer's account through WOZTELL’s BotAPI. The content of the message is defined directly in the Response data.

Once sent, the API response is available for the following nodes to continue processing.

More information: Send Responses API Reference.

Node: Redirect Member to Node

Redirect Member to Node is a special node that redirects the current flow to a specific point inside your WOZTELL Chatbot Tree.

Instead of manually building JSON payloads to send WhatsApp message templates or trigger flows, you can simply use this node and pass basic parameters. The WOZTELL Chatbot handles the logic for you.

This node acts like a pointer — it hands control back to your existing bot structure and lets it take care of the next steps.

Ideal for users integrating n8n with WOZTELL bots.

More information: Redirect Member to Node API Reference.

Node: Send WhatsApp Template Message

According to WhatsApp’s official messaging rules, if you want to contact a user outside the 24-hour session — or someone who hasn’t messaged you before — you must use a pre-approved Template Message.

This n8n node simplifies that process. Instead of building the message manually, it lets you select a previously approved template and fill in the required fields. The message is automatically generated and sent using the correct format.

Node: Get members by tags

Get Members by Tags retrieves contacts from a specific channel based on one or more assigned tags. It uses the WOZTELL Open API’s Get Member Information endpoint to fetch all members associated with the selected labels.

Each query returns up to 100 records. If the number of results exceeds that limit, you can use the Cursor field to paginate manually, or enable Return All to retrieve all records automatically.

More information: WOZTELL Open API.

Node: Set member tags

Set Member Tags allows you to assign one or more tags to a contact in a specific channel using the WOZTELL Open API.

Tags are used across multiple WOZTELL features such as Broadcast, Contact Management, and Chatbot Builder. They allow you to segment users, track business statuses, and customize workflows based on user profiles or behavior.

This node can be placed at any point in your workflow where you need to apply business logic based on tags.

Node: Get member info by ID

This node retrieves a member's profile using their External ID on a specific channel. For WhatsApp channels, the External ID corresponds to the user's phone number.

It returns the full contact dataset, including metadata and, in the latest version, the current Inbox folder location of the conversation.

To use this node:

1. Select the credential associated with your WOZTELL account.
2. Choose the corresponding channel.
3. Enter the External ID of the contact.

More information: WOZTELL Open API · Inbox overview.

Node: Get conversation history by ID

Get Conversation History by ID retrieves the conversation history of a contact using their External ID and a defined time range.

This is especially useful for auditing, support workflows, or improving chatbot training by analyzing past interactions.

To use this node:

1. Select the credential linked to your WOZTELL account.
2. Choose the conversation channel.
3. Enter the External ID of the contact.
   
4. Define the time range for the query (start and end timestamps).
   

Note:

Time range is required. Without it, queries may fail due to high data volume.

If more than 100 results are expected, use the Cursor field for pagination or enable Return All.

More information: WOZTELL Open API.

Use cases

• Lead capture: Save WhatsApp leads in Google Sheets and send a confirmation message.

• CRM integration: Update a record in the CRM and trigger a WhatsApp notification using WOZTELL.

• Chatbot routing: Redirect customers from a support flow to a sales one using the Redirect Member to Node action.

Best practices

• Separate environments: Use a dedicated test environment to experiment with new flows before moving them to production.

• Token management: Keep your Access Tokens secure, limit their scope, and rotate them regularly.

• Error handling: Add error branches and retry logic in n8n to ensure flows recover from temporary issues.

• Monitoring and logs: Review execution logs in n8n to track performance and troubleshoot issues.

• Scalability: Start with simple flows and gradually expand them based on your business needs.