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

# n8n Community Node

> WhatsApp automation for n8n workflows with the WSAPI community node

The WSAPI n8n Community Node brings WhatsApp automation to your n8n workflows, offering **50+ WhatsApp operations** across 10 different resource types, AI agent compatibility, and real-time webhook support.

## Installation

<Tabs>
  <Tab title="Community Nodes (Recommended)">
    <Steps>
      <Step title="Open n8n settings">
        Navigate to **Settings → Community Nodes** in your n8n instance.
      </Step>

      <Step title="Install the node">
        Click **Install Community Node** and enter:

        ```
        @wsapichat/n8n-nodes-wsapi
        ```
      </Step>

      <Step title="Start using">
        The WSAPI node is now available in your workflow editor.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual Installation">
    ```bash theme={null}
    # Navigate to your n8n installation directory
    cd /path/to/your/n8n

    # Install the community node
    npm install @wsapichat/n8n-nodes-wsapi

    # Restart n8n
    npm run start
    ```
  </Tab>
</Tabs>

## Available resources

| Resource     | Operations                                                                                                                         |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Messages** | Send text, links, images, videos, audio, documents, stickers, contacts, locations, reactions. Edit, delete, star, and mark as read |
| **Chats**    | Retrieve, delete, set presence, configure ephemeral settings, mute, pin, archive                                                   |
| **Account**  | Get/set profile info, display name, picture, presence, status                                                                      |
| **Session**  | Get QR code, login code, connection status, logout                                                                                 |
| **Contacts** | List, create, update, get pictures, retrieve business profiles                                                                     |
| **Groups**   | Create, delete, rename, manage participants, invite links                                                                          |
| **Users**    | User information and status                                                                                                        |
| **Instance** | Instance settings and management                                                                                                   |
| **Calls**    | Call handling and status                                                                                                           |
| **Media**    | Media download and management                                                                                                      |

## AI agent integration

The WSAPI node works with n8n's AI Agent nodes. Set parameters to **"Let the model define this parameter"** and connect directly to AI nodes for conversational workflows.

```
WSAPI Trigger (WhatsApp Message)
├── AI Agent Node
│   ├── Context: Your knowledge base
│   ├── Tools: WSAPI Send Message
│   └── Output: AI-generated response
└── WSAPI Send Text Message
```

## Webhook trigger

The **WSAPI Trigger** node receives real-time events from your WhatsApp instance:

* Message events (new, read, delete)
* Chat events (presence, settings)
* Session events (login, logout)
* Call events
* Contact events
* User events

Features include auto-download media and webhook authentication.

## Common workflows

* **Customer support automation** — auto-respond to common queries using AI
* **Order notifications** — send WhatsApp updates when order status changes
* **Group management bots** — automate group administration tasks
* **Media processing pipelines** — receive and process media from WhatsApp

## GitHub

[github.com/wsapi-chat/n8n-nodes-wsapi](https://github.com/wsapi-chat/n8n-nodes-wsapi)