> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whatsable.app/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
> Learn how to automate WhatsApp messaging through n8n with WhatsAble
# WhatsAble Integration with n8n
WhatsAble lets you automate WhatsApp messaging through your favorite workflow automation platforms. This guide walks you through connecting WhatsAble with n8n to create powerful WhatsApp messaging workflows.
## Prerequisites
Before getting started, make sure you have:
An active subscription with WhatsAble
Access to [n8n](https://app.n8n.cloud/login) workflow automation platform
New to WhatsAble? [Sign up here](https://dashboard.whatsable.app/signin)
## Get started with WhatsAble
To use the WhatsAble API, you'll need an active subscription:
1. Log in to your WhatsAble dashboard
2. Click the **Subscribe** button
3. Start your 7-day free trial
During your trial, you can add unlimited phone numbers to test the service. After the trial period, pricing is \$8.99 per month per phone number.
For WhatsAble to send messages through your WhatsApp account:
1. In your WhatsAble dashboard, navigate to **Verified Numbers**
2. Click **Add New Number**
3. Enter your phone number (with country code)
4. You'll receive a WhatsApp verification code
5. Enter the verification code in the WhatsAble dashboard
**Multiple numbers?** You only need to complete the verification process for your first phone number. For additional numbers, simply add them and save—no verification required.
To connect WhatsAble with n8n, you'll need your API key:
1. In your WhatsAble dashboard, go to **API Keys**
2. Copy your unique API key
3. Store it securely—you'll need it for the integration
Never share your API key publicly or commit it to version control systems.
## Connect WhatsAble to n8n
Now that you have WhatsAble set up, let's connect it to n8n to automate your workflows.
1. Log in to your n8n account
2. Create a new workflow by clicking **+ New Workflow**
3. Add a trigger node of your choice:
* Popular triggers include Google Forms, Jotform, ClickUp, or a Schedule trigger
* Connect and configure your trigger according to your use case
The WhatsAble trigger node enables your workflow to respond automatically to incoming WhatsApp messages. This setup is optional but recommended for building reactive communication flows.
Follow these steps to add the WhatsAble trigger node to your workflow:
1. Click the **+** button in your workflow canvas to add a new node
2. Search for "WhatsAble" in the node library search bar
3. Select the node displaying the official WhatsAble logo
4. From the available trigger options, choose **On new Incoming message event**
The trigger node will automatically listen for incoming messages and initiate your workflow when a new message is received.
Set up your WhatsAble API credentials to establish a secure connection:
**Webhook URL Configuration:**
1. In the WhatsAble Trigger node parameters, locate the **Webhook URLs** section at the top
2. Select **Production URL** and copy the generated URL by clicking on it
3. Store this URL securely as you'll need it for the credential setup
**Credential Creation:**
1. In the **Credential to connect with** dropdown, click **+ Create new credential**
2. Select **WhatsAble Trigger API** as your connection method
3. Enter your WhatsAble API key in the **API Key** field
4. Paste the Production URL you copied earlier into the **Production URL** field
5. Assign a descriptive name to your credential (e.g., "WhatsAble Production")
6. Click **Save** to securely store your credentials
Your API credentials are encrypted and stored securely. Never share your API key publicly or commit it to version control.
Complete the setup by testing and activating your trigger:
**Response Configuration:**
1. In the **Respond** dropdown, select your preferred response timing:
* **Immediately**: Responds as soon as the trigger fires
* **When Last Node Finishes**: Waits for the entire workflow to complete before responding
**Testing:**
1. Click **Execute step** on the WhatsAble node to run a test
2. Verify the connection is working by checking for a success confirmation
3. Review any error messages if the test fails and adjust your configuration accordingly
Once activated, your workflow will automatically process incoming messages according to your configured logic.
Remember to test your workflow thoroughly before activating it in production to ensure it behaves as expected.
1. Click the **+** button to add a new node
2. Search for "WhatsAble" in the node library
3. Select the node with the official WhatsAble logo
4. After selecting the WhatsAble node, choose 'Send message via whatsAble' from the available actions menu
**Credential Setup:**
1. In the WhatsAble node settings, find the **Credential to connect with** dropdown
2. Select **+ Create new credential**
3. Enter your WhatsAble API key that you copied earlier
4. Name your credential (e.g., "WhatsAble Production")
5. Click **Save** to store your credential
1. In **Resource** dropdown, select **Send Message**
2. In the **Operation** dropdown, select **Send message via WhatsAble**
3. Complete the required fields:
Select the recipient's phone number (with country code) previously added in WhatsAble
Type your message text or use variables from previous nodes
Enter the URL of the file, image, or video you want to send with your message
Specify a custom filename for your attachment
1. Click **Test Step** on the WhatsAble node to verify it's working correctly
2. If the test is successful, you'll see a confirmation message
3. Click **Done** to return to your workflow
4. Click **Save** to save your entire workflow
5. Toggle the **Active** switch in the top-right corner to activate your workflow
## Example use cases
Send a welcome message when a new customer signs up
Update customers when their order status changes
Automatically send reminders before scheduled appointments
Send personalized messages to new leads from your form submissions
Notify customers when their support ticket status changes
## Workflow Diagram
**Sample WhatsAble n8n Workflow:**
```mermaid theme={null}
flowchart LR
A[Trigger Node] --> B[Data Transformation]
B --> C[WhatsAble Node]
C --> D{Message Sent?}
D -->|Yes| E[Success Path]
D -->|No| F[Error Handling]
E --> G[Additional Actions]
F --> H[Retry Logic]
```
## Troubleshooting
**Steps to resolve:**
1. **Verify Account Active:** Verify that your WhatsAble account is active.
2. **Phone Number Verification:** Check that your phone number is properly verified.
3. **API Key in n8n:** Ensure your API key is entered correctly in n8n.
4. **Recipient Number Format:** Confirm that the recipient's phone number is in the correct format (including country code).
**Steps to resolve:**
1. **File Size Limit:** Check that the file size is under 16 MB.
2. **Supported File Type:** Verify the file type is supported by WhatsApp.
3. **Accessibility:** Ensure the file path or URL is accessible.
## Need help?
Our support team is ready to assist you:
Contact [team@whatsable.app](mailto:team@whatsable.app)
Book a personalized walkthrough
Click the chat button in the bottom right corner of the WhatsAble dashboard
For additional automation platform integrations (Make.com, Zapier, etc.), please contact our support team or check our integration documentation.