botmeshTransport-Agnostic Bot Framework

Flows, hooks, plugins and conversations behind one IProvider — WhatsApp (Baileys / Cloud API) and Telegram, plus experimental Messenger, Instagram and Discord. Simple, declarative, TypeScript. Alpha on npm — install with `@alpha`.

Get Started

Examples

API Reference

🚆

Transport-agnostic

One engine, many transports. @botmesh/core runs any IProvider: @botmesh/baileys (WhatsApp Web), @botmesh/meta (official WhatsApp Cloud API), @botmesh/telegram — plus experimental Messenger, Instagram and Discord providers.

💬

Declarative

bot.when('hi', ctx => ctx.reply('Hello! 👋')) — no boilerplate, no nested callbacks. Write what you want to happen.

🔀

Conversation flows

flow().say().ask().choose() compiles to a real async conversation — validation, retries, branching and timeouts, no separate step engine.

🪝

Hooks (middleware)

before / after / onError — intercept any event, just like Express. Logging, rate limiting, metrics, anything.

🧩

Plugins

Package and reuse functionality. Includes slashCommandsPlugin (/start, /help, /reset, /cancel, /id, /ping) out of the box.

🔌

Dependency injection

bot.provide('db', myDb) — available as ctx.tools.db in any handler. No globals, no coupling.

⏰

Built-in scheduler

Cron, intervals and delays with human syntax. bot.every('30 seconds', ...) or bot.schedule('0 9 * * 1-5', ...).

📦

Pluggable stores

MemoryStore by default; @botmesh/sqlite-store and @botmesh/redis-store for persistence — or implement the generic IStore for anything else.

📸

Full media support

Photo, video, audio, voice, sticker, file, location, contact, poll — all with a single line.

🔷

TypeScript native

Types throughout the ecosystem. Autocomplete and type-checking on every handler, flow and plugin.

Who is this for?

If you know basic JavaScript, you can build a working WhatsApp bot in under 5 minutes. You don't need TypeScript to get started — the examples are copy-paste-ready.