> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Use the official Kapso node in n8n.

Use the official Kapso node when an n8n workflow needs to receive WhatsApp events or send WhatsApp messages through Kapso.

Kapso is [verified by n8n](https://n8n.io/integrations/kapso/) and available from the n8n node panel. Start there. You should not need to install an npm package manually unless your n8n instance does not show verified community nodes.

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0 }}>
  <iframe style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} src="https://www.tella.tv/video/vid_cmqagnwvs00ly04if3x8rbhye/embed?b=0&title=1&a=1&loop=0&t=0&muted=0&wt=0&o=1" allow="autoplay; fullscreen" allowTransparency />
</div>

## Add Kapso in n8n

In n8n:

1. Open a workflow
2. Open the nodes panel
3. Search for `Kapso`
4. Select **Kapso** or **Kapso Trigger**
5. Install it for the instance if n8n asks

Instance owners and admins can install verified community nodes. After that, every user in the n8n instance can use them.

If Kapso does not appear:

* Update your n8n instance to the latest stable version
* Make sure verified community nodes are enabled
* On self-hosted n8n, keep `N8N_COMMUNITY_PACKAGES_ENABLED=true` and `N8N_VERIFIED_PACKAGES_ENABLED=true`

## Manual install fallback

Use this only when Kapso is not available from the n8n node panel.

In **Settings → Community Nodes**, install:

```text theme={null}
@kapso/n8n-nodes-kapso
```

The current latest version is `0.1.3`. You only need to pin it if you want that exact version:

```text theme={null}
@kapso/n8n-nodes-kapso@0.1.3
```

For self-hosted manual installs:

```bash theme={null}
mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install @kapso/n8n-nodes-kapso
```

Restart n8n after installing manually.

## Credentials

Create a credential named **Kapso API**.

| Field              | Value                  |
| ------------------ | ---------------------- |
| Base URL           | `https://api.kapso.ai` |
| API Key            | Kapso project API key  |
| Meta Graph Version | `v24.0`                |

The node sends the API key as `X-API-Key`.

## Send a message

Add a **Kapso** node.

| Field                  | Value                                       |
| ---------------------- | ------------------------------------------- |
| Resource               | `WhatsApp Message`                          |
| Operation              | `Send Text`                                 |
| Phone Number ID        | Your Kapso-connected Meta `phone_number_id` |
| Recipient Phone Number | Destination phone number without `+`        |
| Message                | Message body                                |

Use **Send Template** for approved WhatsApp templates. Use **Send Raw Payload** when you need to send a WhatsApp Cloud API payload that the node does not model yet.

## Receive webhooks

Add a **Kapso Trigger** node as the first node in the workflow.

| Field             | Value                                                         |
| ----------------- | ------------------------------------------------------------- |
| Scope             | `Phone Number`                                                |
| Phone Number ID   | Meta `phone_number_id` for the sender                         |
| Events            | `whatsapp.message.received` or the events your workflow needs |
| Registration Mode | `Automatic`                                                   |
| Verify Signature  | Enabled in production                                         |

When the workflow is activated, the node registers the webhook in Kapso automatically.

For local testing, n8n must have a public HTTPS webhook URL. If the generated webhook URL uses `localhost`, restart n8n with `WEBHOOK_URL` set to your public tunnel URL.

Use **Manual** registration only if you already created the webhook in Kapso yourself.

## What you can automate

* Auto-reply when `whatsapp.message.received` fires
* Send a text reply from any workflow
* Send an approved WhatsApp template
* Send a raw WhatsApp Cloud API payload through Kapso
* Mark a message as read, optionally with typing indicator
* List connected WhatsApp phone numbers
* List WhatsApp messages stored by Kapso

## Related docs

* [Kapso on n8n](https://n8n.io/integrations/kapso/)
* [Install verified nodes in n8n](https://docs.n8n.io/integrations/community-nodes/installation/verified-install/)
* [Send messages](/docs/whatsapp/send-messages/text)
* [Templates](/docs/whatsapp/templates/simple-text)
* [Webhooks](/docs/platform/webhooks/overview)