> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.wanotifier.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Integrate WANotifier With 500+ Apps Using n8n?

[n8n](https://n8n.io/) is a fair-code workflow automation platform you can self-host or use on n8n Cloud. With **500+ built-in integrations** plus the ability to drop in any HTTP API, n8n connects WANotifier to virtually any tool in your stack and runs your messaging workflows end to end.

This guide walks you through installing the WANotifier community node, connecting your account, and sending your first WhatsApp notification triggered by another app.

### Step 1. Install the WANotifier node

The WANotifier integration is published as a community node on npm and the n8n marketplace.

1. In n8n, click on "+" to add a new node and search for **WANotifier**.
2. From the search results select WANotifier and then click on **Install Node**.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/screenshot-2026-05-05-at-10106_bgfuzk.png)

3. After installing the node, search for **WANotifier** in the node picker and select the action that you'd like to use.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/screenshot-2026-05-05-at-10350_1gyww40.png)

### Step 2. Connect WANotifier

1. When you select an action for the very first time, you'll be asked to setup your credentials. Click on **Set up credential** button to do that.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/screenshot-2026-05-05-at-10554_15l5yam.png)

2. In the popup that opens, paste your WANotifier **API key**.
* To find it: in WANotifier, go to [Integrations → API Integration](http://app.wanotifier.com/integrations/api/) **→ API Keys** and copy your default key (or click **Add New Key** to create a dedicated key for n8n).

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/screenshot-2026-05-05-at-10631_1ofyq4t.png)

3. Click **Save**. n8n will verify the key and confirm the connection.

### Step 3. Build a workflow

A workflow has two parts: a **trigger** node (the event that starts the workflow) and one or more **action** nodes (what should happen as a result).

1. In n8n, click **+** to add a trigger node, for example, *Google Sheets* (Row Added), *Shopify* (New Order), *Typeform* (New Submission), *Schedule* (Time-based), or any of n8n's 500+ built-in triggers.
2. Configure the trigger and execute it once so the workflow has sample data to work with.
3. Add a new node, search for **WANotifier**, and pick it.
4. In the WANotifier node, choose an Action that you'd like to execute as described below.

### Step 4. Setup an Action

The WANotifier node groups its actions aka operations into three resources.

#### 1. Resource: Contact

##### 1.1 Create or Update

Sync contacts from another app into WANotifier. If a contact with the same WhatsApp number already exists, it's updated; otherwise a new contact is created.

**Fields:**

* **WhatsApp Number** *(required)*: include country code, e.g. +919876543210.
* **First Name** *(optional)*.
* **Last Name** *(optional)*.
* **Status** *(optional)*: *Subscribed* (broadcast notifications go to this contact) or *Unsubscribed* (skipped during broadcasts). Defaults to Subscribed.
* **Tags** *(optional)*: pick one or more tags from the dropdown (auto-fetched from your WANotifier account).
* **Lists** *(optional)*: pick one or more lists from the dropdown.
* **Replace Tags & Lists** *(required)*: *Yes:* the tags and lists you selected above replace whatever is currently on the contact. *No:* they're added on top of the contact's existing tags and lists. Defaults to Yes.
* **Custom Attributes** *(optional)*: add as many attribute key-value pairs as you need. The **Attribute** dropdown lists every custom attribute defined in your WANotifier account.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/screenshot-2026-05-05-at-11247_c7o4v1.png)

#### 2. Resource: Message *(during an active 24-hour conversation window)*

WhatsApp only allows free-form messages while a 24-hour window with the contact is open (started by the contact's last incoming message). Outside that window the message will not be sent.

##### 2.1 Send Text Message

**Fields:**

* **WhatsApp Number** *(required)*, **First Name**, **Last Name**.
* **Body** *(required)*: the text content of the message. Supports basic markdown (`*bold*`, `_italic_`, `~strikethrough~`, ```` ```code``` ````).

##### 2.2 Send Media Message

Send an image, video, document, audio file, or sticker via public URL.

**Fields:**

* **WhatsApp Number** *(required)*, **First Name**, **Last Name**.
* **Media Type** *(required)*: pick *Image*, *Video*, *Document*, *Audio*, or *Sticker*.
* **Media URL** *(required)*: a public, static URL to the file. See [Meta's documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media/#supported-media-types) for supported types and size limits.
* **Caption** *(optional)*: only used for Image, Video, and Document types.
* **Filename** *(optional)*: only used for Document type.

##### 2.3 Send Location

**Fields:**

* **WhatsApp Number** *(required)*, **First Name**, **Last Name**.
* **Latitude**, **Longitude** *(both required)*.
* **Place Name** *(required)*: e.g. *Mumbai HQ*.
* **Address** *(required)*: full address of the location.

##### 2.4 Send Interactive Message

Send a message with up to 3 reply buttons. Button IDs are auto-generated from the button text.

**Fields:**

* **WhatsApp Number** *(required)*, **First Name**, **Last Name**.
* **Body** *(required)*: the prompt shown above the buttons.
* **Button 1 Text** *(required)*: max 20 characters.
* **Button 2 Text** *(optional)*, **Button 3 Text** *(optional)*.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/screenshot-2026-05-05-at-11453_153lnxb.png)

#### 3. Resource: Message Template

##### 3.1 Send Message Template

Fire a pre-configured [Transactional Notification](https://help.wanotifier.com/en/article/create-transactional-notification-10yukg0/).

**Pre-requisite:** in WANotifier, go to [Notifications → Add New](https://app.wanotifier.com/notifications/add/) and create a Transactional Notification:

* Give it a name (e.g. *"New Order from Shopify"*).
* Select type as **Transaction / Integration / API**.
* Select trigger as **API request to a Webhook URL**.
* Pick the **message template** you want to send.
* Keep **Webhook Request Data** as *Default*.
* Save.

This is how it should look:

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/image_dwxz3e.png)

**Fields in n8n:**

* **WhatsApp Number** *(required)*, **First Name**, **Last Name**.
* **Notification** *(required)*: pick the notification you just created from the dropdown (n8n fetches all your transactional notifications automatically).
* **Template Variables**: once you pick a notification, n8n fetches the template's variable schema and renders an input field for each variable (e.g. `header_image_url`, `body_variables_0`, `body_variables_1`, `button_variables_0`). Map each one to data from your trigger.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/d/6/66d63a5129ae5000/screenshot-2026-05-05-at-11558_1frtl5q.png)

### Field Mapping Tips

* **Phone numbers** must include the country code (e.g. +919876543210). Many apps store numbers without `+` , use n8n's **Edit Fields (Set)** node or the **Code** node with a small JavaScript snippet to normalize them before passing to WANotifier.
* **Body variables** appear in the order they exist in your template (`body_variables_0` for `{{1}}`, `body_variables_1` for `{{2}}`, etc.). Make sure the data you map matches the variable order.
* **Header media** (image, video, document URLs) must be public URLs accessible by WhatsApp's servers. You **can not use** dynamic links from services like Google Drive or Dropbox.
* **Tags, Lists, and Attributes** for "Create or Update Contact" are pulled from your WANotifier account automatically, pick from the dropdowns rather than typing free-text.
* **n8n's expression editor** (the `{{ }}` syntax) lets you reference data from previous nodes, e.g. `{{ $json.email }}` or `{{ $('Trigger').item.json.phone }}`.

### Using WANotifier with AI Agents

The WANotifier node is AI compatible, so AI Agent nodes (e.g., n8n's **AI Agent** with OpenAI / Claude / etc.) can call WANotifier directly as a tool. Agents can autonomously decide when to send a WhatsApp message, update a contact, or fire a notification based on natural-language conversations, useful for support workflows or AI-driven outreach.

That's it! With the WANotifier n8n integration in place, you can now connect WhatsApp to virtually any tool in your stack and automate your messaging workflows end to end. If you run into any issues or need help building a specific workflow, our support team is always happy to help, just reach out from your dashboard.