# Send a WhatsApp message in n8n

> Send an approved template, or a text, image, video, document or audio message, from any n8n workflow with the Whatsable node.

The **Send WhatsApp Message** operation of the Whatsable node sends a message right away from your WhatsApp number. Choose the kind of message in the **Product Operation** field: **Send Message Template** or **Send Non Template Message**.

This page is the how-to guide. For every field of the node, see [n8n node fields](/integration/n8n/fields). For the credential and the first workflow, see the [n8n overview](/integration/n8n). To send later instead, use [Schedule WhatsApp Message](/integration/n8n/schedule-message).

## When to use it

- **Order confirmations**: 
Send a template with the order number and the customer's name when an order is placed.

- **Welcome a new lead**: 
Greet a lead from a form or an ad within seconds, even when they never wrote to you.

- **Reply to a customer**: 
Answer a contact who just wrote to you with text, an image, or a PDF.

- **Share a file**: 
Send an invoice, a brochure, or a tracking document as part of a flow.

## Choose the right message type

| | Send Message Template | Send Non Template Message |
| --- | --- | --- |
| Use it when | You start the conversation, or the contact has not written in the last 24 hours | The contact wrote to you in the last 24 hours |
| Content | A template approved by Meta, with variables | Text, image, video, document or audio |
| Needs approval | Yes | No |

> [!WARNING]
>
> A non-template message only works inside Meta's customer service window, which opens when the contact writes to you. Outside that window, use an approved template.

## Set up the node

**Add the Whatsable node**

Click **+** after your trigger, search for **Whatsable**, and choose the node with the Whatsable logo.

**Choose the operation**

| Field | Value |
| --- | --- |
| **Credential** | Your Whatsable credential |
| **Resource** | Send Message |
| **Operation** | Send WhatsApp Message |
| **Product Operation** | **Send Message Template** or **Send Non Template Message** |

**Fill in the message**

Follow the tab for the product operation you chose.

**Send Message Template**

<img src="/images/n8n-send-1-template.webp" alt="Whatsable node set to Send Message Template with a template selected" style={{ maxWidth: "320px" }} />

*Send WhatsApp Message with the Send Message Template product operation*

**Phone Number** `text` (required)

The recipient with the country code, for example `+14155550132`. Map it from an earlier node with an expression.

**Template Name or ID** `dropdown` (required)

One of your approved templates. The list shows the template name and its language, for example `delivery_confirmation -- en_US`.

**Values to Send** `text` (required)

One field per template variable, labeled with its position and the example value from the template. Required when the template has variables. A media header URL and a website button URL appear when the template needs them.

**Note** `text`

Context about this contact. WhatsAble stores it on the contact and never sends it to the recipient.

**Label Names or IDs** `multiselect`

Labels to apply to the conversation.

> [!TIP]
>
> The first time you select a template, n8n may switch the field to **Expression** mode. Click **Fixed** to return to the dropdown and choose your template.

**Send Non Template Message**

<img src="/images/n8n-send-2-non-template-text.webp" alt="Whatsable node set to Send Non Template Message with Text Message selected" style={{ maxWidth: "320px" }} />

*Send Non Template Message with the Text Message type*

**Recipient Phone Number** `text` (required)

The recipient with the country code.

**Message Type** `dropdown` (required)

**Text Message**, **Image Message**, **Video Message**, **Document Message**, or **Audio Message**. The fields below depend on it.

**Label Names or IDs** `multiselect`

Labels to apply to the conversation.

**Note** `text`

Context about this contact, stored on the contact and never sent to the recipient.

| Message Type | Fields |
| --- | --- |
| Text Message | **Message Content** (required), **Enable Link Preview** |
| Image Message | **Image URL** (required), **Caption** |
| Video Message | **Video URL** (required), **Caption** |
| Document Message | **Document URL** (required), **Filename** (required), **Caption** |
| Audio Message | **Audio URL** (required) |

<img src="/images/n8n-send-3-non-template-image.webp" alt="Whatsable node with Image Message selected showing Image URL and Caption" style={{ maxWidth: "320px" }} />

*Image Message: a public image URL with an optional caption*

> [!WARNING]
>
> A media URL must be publicly reachable and in a format WhatsApp supports.

## Example: order confirmation

**Start the workflow**

Use the event that creates an order, for example a Shopify, WooCommerce or Stripe trigger.

**Send the template**

Add a Whatsable node with **Send WhatsApp Message** and **Send Message Template**. Map **Phone Number** from the order, choose your order confirmation template, and map the order number and the customer's name into **Values to Send**.

**Label the contact**

Add a label such as `customer` under **Label Names or IDs**, so you can find the contact in the inbox later.

## Test it safely

> [!TIP]
>
> Test with your own phone number first. Every run sends a real WhatsApp message.

1. Put your own number in the phone number field.
2. Click **Execute step** and confirm that n8n shows a success result.
3. Check the conversation with your number in the WhatsAble inbox.

## Troubleshooting

<details>
<summary>The template list is empty</summary>

The list shows the approved templates of the WhatsApp Business account that holds the number of your API key. Check that the key belongs to the right number and that you have an approved template.

</details>

<details>
<summary>A text message is rejected</summary>

The contact is probably outside the customer service window. Send a template instead.

</details>

<details>
<summary>A media file does not arrive</summary>

Open the file URL in a private browser window. If it asks you to sign in, WhatsApp cannot fetch it either. For a document, also check that **Filename** is filled.

</details>

<details>
<summary>Red warnings on the phone number or the message content</summary>

These fields are required. Fill them, or map them from an earlier node.

</details>