Skip to main content
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 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.

​
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: 
@kapso/n8n-nodes-kapso
The current latest version is 0.1.3. You only need to pin it if you want that exact version: 
@kapso/n8n-nodes-kapso@0.1.3
For self-hosted manual installs: 
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.
FieldValue
Base URLhttps://api.kapso.ai
API KeyKapso project API key
Meta Graph Versionv24.0
The node sends the API key as X-API-Key.

​
Send a message

Add a Kapso node.
FieldValue
ResourceWhatsApp Message
OperationSend Text
Phone Number IDYour Kapso-connected Meta phone_number_id
Recipient Phone NumberDestination phone number without +
MessageMessage 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.
FieldValue
ScopePhone Number
Phone Number IDMeta phone_number_id for the sender
Eventswhatsapp.message.received or the events your workflow needs
Registration ModeAutomatic
Verify SignatureEnabled 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