zalo-bot-js

Appearance

zalo-bot-jsEnglish documentation portal

Build Zalo bots on Node.js with a practical SDK for polling, webhook handling, event listeners, message sending APIs, and workflow integrations.

Getting started
API Reference
Đọc tiếng Việt

Bot setup

Install the SDK, create `.env`, validate the token, and run the first bot flow.

API pages

Browse dedicated pages for `Bot` methods, `Message` helpers, webhook APIs, and polling runtime.

Sending APIs

Use `sendMessage`, `sendPhoto`, `sendSticker`, and `sendChatAction` in practical bot flows.

Event and update flow

Understand how `on`, `onText`, `processUpdate`, and `startPolling` work inside the SDK.

Handler-based API

Organize bot logic with `ApplicationBuilder`, `Application`, `CommandHandler`, `MessageHandler`, and `filters`.

Practical integrations

Connect the bot to webhook deployments, n8n workflows, and internal automation services.

Introduction ​

This documentation is for developers who want to build bots on the Zalo platform with zalo-bot-js, a TypeScript SDK for Node.js with practical components such as polling, webhook helpers, event listeners, and core message-sending APIs.

Through this documentation set, you can configure a bot quickly, validate the token, run message receive and reply flows, and understand the current SDK structure before extending it further.

Where to start ​

If you are opening the documentation for the first time, follow this order:

  1. Getting started to configure the environment and run the first bot flow
  2. API Reference to browse the main SDK methods
  3. Examples and tests to choose between polling, webhook, and local verification scripts
  4. n8n Integration if you want to connect the bot to automation workflows

Highlighted content groups ​

  • Bot setup and validation: installation, .env, token checks, polling
  • Runtime APIs: getMe, getUpdates, processUpdate, startPolling
  • Sending APIs: sendMessage, sendPhoto, sendSticker, sendChatAction
  • Practical integrations: webhook, n8n, automation workflows, and internal APIs

Next ​

Start with Getting started.

Last updated: April 5, 2026

Built for Vietnamese developers, documented for everyone.

MIT License