Description

n8n-nodes-max-bot


n8n community node for MAX Messenger Bot API. Send messages, manage chats, upload files, and receive events from MAX platform.

Nodes

| Node | Type | Description |
|——|——|————-|
| MAX Bot | Regular | 24 operations: messages, chats, files, pins, actions, bot management |
| MAX Bot Trigger | Webhook Trigger | Real-time events via webhook (production) |
| MAX Bot Trigger Polling | Polling Trigger | Event polling via GET /updates (testing / no external access) |

One credential for all nodes: MAX Bot API (token + base URL).

Quick Start

1. Install via npm (recommended)

Open n8n → Settings → Community Nodes → Install → enter n8n-nodes-max-bot → Install.

2. Install via Docker

Build
git clone https://github.com/max-messenger/max-bot-api-client-ts.git
cd n8n-nodes-max-bot
npm install --ignore-scripts && npm run build && npm pack
Deploy to n8n container
docker cp n8n-nodes-max-bot-0.1.0.tgz n8n:/tmp/
docker exec -it n8n sh -c "mkdir -p /home/node/.n8n/custom && cd /home/node/.n8n/custom && npm install /tmp/n8n-nodes-max-bot-0.1.0.tgz"
docker restart n8n

3. Configure Credential

In n8n: Credentials → + Add Credential → MAX Bot API:

| Field | Value |
|——-|——-|
| Bot Token | Your bot token from MAX platform |
| Base URL | https://platform-api2.max.ru |

4. Test

Add MAX Bot node → Resource: Message → Operation: Send to User → User ID: YOUR_ID → Text: Hello from n8n! → Test step.

SSL Certificates (Russian CA)

The platform-api2.max.ru endpoint uses certificates signed by Russian Trusted Sub CA. If you get unable to get local issuer certificate:

1. Copy your Russian CA certs to a volume
mkdir -p certs
cp russiantrustedroot_ca.crt certs/
cp russiantrustedsub_ca.crt certs/
2. Create bundle (IMPORTANT: newline between certs!)
cat certs/russiantrustedrootca.crt > certs/russianbundle.crt
echo "" >> certs/russian_bundle.crt
cat certs/russiantrustedsubca.crt >> certs/russianbundle.crt
3. docker-compose.yml:
  volumes:
    - ./certs:/certs:ro
  environment:
    - NODEEXTRACACERTS=/certs/russianbundle.crt
docker compose down && docker compose up -d

Alternatively, switch Base URL to https://platform-api.max.ru (no Russian CA needed) or use NODETLSREJECT_UNAUTHORIZED=0 for testing only.

Webhook Setup

For production webhooks, MAX requires your n8n to be accessible from the internet via HTTPS. Options:

| Method | Command |
|——–|———|
| Direct IP + open port | Open port in firewall/ufw |
| serveo (simplest) | ssh -R 80:localhost:7878 serveo.net |
| Cloudflare Tunnel | cloudflared tunnel create n8n |

Then configure docker-compose:

environment:
  - N8N_HOST=your-domain.example.com
  - WEBHOOK_URL=https://your-domain.example.com
  - N8N_PROTOCOL=https

Operations

Message

sendToChat, sendToUser, edit, delete, get, getMany — with Markdown/HTML formatting, inline keyboards, reply links.

Chat

get, getByLink, list, edit, getMembers, addMembers, removeMember, getAdmins, getMembership.

File

uploadImage, uploadVideo, uploadAudio, uploadFile — via binary data from HTTP Request / Read File nodes.

Pin / Action / Bot

pin, unpin, getPinned, sendTyping, leaveChat, getInfo, setCommands.

Example: AI Bot with llama.cpp

[MAX Bot Trigger Polling]  →  [HTTP Request]  →  [MAX Bot: Send to User]
  Events: messagecreated       POST llama.cpp      User ID: {{ sender.userid }}
  Interval: 5                   /v1/chat/completions    Text: {{ choices[0].message.content }}

See DOCUMENTATION.md for full Russian docs, workflow examples, and troubleshooting.

Troubleshooting

| Error | Solution |
|——-|———-|
| unable to get local issuer certificate | SSL section |
| PEM routines::bad end line | Add newline between certs in bundle |
| 400 Bad Request | Update to latest version — userid/chatid must be query params |
| getaddrinfo EAI_AGAIN | DNS issue inside container — check connectivity |
| Node not appearing | Check docker logs n8n and /home/node/.n8n/custom/ |

Development

npm install --ignore-scripts
npm run build        # tsc + gulp
npm run lint         # eslint
npm test             # jest

License

MIT © MAX Messenger