Examples - botmesh

Run any example

Set up a project once, as in Getting started (Node.js 22.12+, "type": "module", npm install @botmesh/core @botmesh/baileys).
Save the example’s code as bot.js.
Chat with it in the terminal, no phone needed:
npx botmesh dev bot.js
Connect it for real with node bot.js (a QR code for WhatsApp), or swap the provider for Telegram. The bot code does not change between channels.

Beginner

Example	Level	Tags	Features	What you’ll build
Greeting bot	Beginner	Commands	`WELCOME`, text and regex triggers, `ctx.pass()`, slash commands, catch-all	A bot that welcomes each user once, says hello, echoes and lists its commands
FAQ bot	Beginner	Triggers	Normalized matching, keyword lists, `contains`, regex, precedence	Keyword answers to frequent questions, with a fallback
Send messages	Beginner	Triggers	Trigger forms, `ctx.quote()`, `ctx.react()`, sender info	Every way to answer a text message
Menu bot	Beginner	Flows, Buttons	`flow().choose()`, `then` sub-flows, `bot.conversation()`, buttons per channel	A pizza-place menu that works on every channel
Poll bot	Beginner	Polls, Reactions	`ctx.poll()`, `bot.on('poll')`, `bot.send()`, `ctx.react()`	Native polls answered with the live tally
Media replies	Beginner	Media	Photo, file, video, voice, sticker, location, contact; `bot.onType()`, `loadMediaOf()`	A bot that sends every media kind and reacts to images
Reminder bot	Beginner	Scheduler	`bot.delay()`, `bot.schedule()` with time zone, `task.cancel()`, `bot.send()`	One-off reminders and a daily tip at 9:00
Registration flow	Beginner	Flows, Forms	`.ask()` with `validate`, `.do()`, `c.state`, `.timeout()`, `/cancel`	A validated sign-up that saves the user

Intermediate

Example	Level	Tags	Features	What you’ll build
Shopping flow	Intermediate	Flows	`.choose()`, `then` sub-flows, `goto`, computed state, timeouts	A small shop with quantity, confirmation and address
Support with timeout	Intermediate	Conversations	`bot.conversation()`, `c.waitText()`, `c.choose()`, `ConversationTimeout`, `ConversationCancelled`	A support desk that opens tickets and handles abandoned sessions
Plugin: rate limiter	Intermediate	Plugins, Hooks	`definePlugin()`, `before('message')`, `abort()`, `onDispose()`	A reusable plugin that limits messages per user
Appointment booking	Intermediate	WhatsApp, Forms, SQLite	`.persistent()`, `.form()`, `validate` + `maxAttempts`, `SQLiteStore`, `ctx.user`	A booking flow that validates, confirms and resumes after a restart
Order tracking	Intermediate	WhatsApp, User data	`ctx.user` namespaces, `bot.conversation()`, `MemoryStore` file	Order lookups that remember what each user follows
Human handoff	Intermediate	WhatsApp, Support	`ctx.handoff()`, `bot.resume()`, handoff events, agent commands, `bot.delay()`	A support bot that passes chats to agents and takes them back
Multi-language bot	Intermediate	WhatsApp, Telegram, i18n	`bot.locale()`, `ctx.t()`, `detect`, `ctx.setLang()`, plurals	A bot that answers each user in English or Spanish
Group bot	Intermediate	WhatsApp, Telegram, Groups	per-participant conversations, `scope`, mentions, `groupMode`, admin-only commands	A group quiz with a scoreboard and admin commands
WhatsApp and Telegram at once	Intermediate	WhatsApp, Telegram, SQLite	`defineBot`, two providers, store namespaces, stable ids	One bot file serving two channels from one process

AI

They use @botmesh/ai with Anthropic by default; every page shows how to switch to OpenAI, Gemini or a local Ollama model. The API key always comes from an environment variable.

Example	Level	Tags	Features	What it does
AI FAQ assistant	Beginner	AI, Guardrails	autoresponder, persona, function triggers, `/reset`	Answers shop questions with an LLM, declines anything off-topic and keeps fixed answers out of the model.
AI booking assistant	Intermediate	AI, Tools	tool calling, `confirm: true`, `confirmLines`, `dedupe`, `enum`	Books, lists and cancels appointments through your functions, with a confirmation before each change.
AI answers from your FAQ	Intermediate	AI, RAG	`rag` retriever, `appendSources`, `warmup()`	Answers from a Markdown FAQ, cites the section it used and admits what it does not know.
Streaming AI replies	Intermediate	AI, Streaming, Telegram	`stream`, drafts / edits / chunks, cost and latency settings	Shows the answer while the model writes it, tuned for cost and latency.
AI router	Advanced	AI, Flows	`generate()`, `replyInChat()`, flows, `bot.trigger()`	Classifies free text with the model, runs payments as deterministic flows and leaves chit-chat to the AI.
AI with human escalation	Advanced	AI, Tools, Handoff	tool calling, `ctx.handoff()`, `bot.resume()`, escape commands	Hands the chat to a person with a summary for the agent, then gets it back with `/bot`.

Advanced

Example	Level	Tags	Features	What you build
WhatsApp Cloud API webhook server	Advanced	WhatsApp, Cloud API, Webhooks, Security	`@botmesh/meta` webhooks, raw-body signatures, 24-hour window, templates	A `node:http` server for the official Cloud API, with template fallback
Production-ready bot	Advanced	Production, Docker, SQLite, Durability	`SQLiteStore`, durability, persistent flows, health and metrics, graceful shutdown, logs	A support bot packaged as a small project with a Dockerfile
Scheduled daily digest	Advanced	Scheduler, Broadcast, Time zones	Durable scheduler, time zones, `bot.broadcast`, `ctx.user` opt-in/out	A digest at 08:00 in the bot’s time zone, once per day across restarts
Testing your bot	Advanced	Testing, Vitest, Golden transcripts	`createTestBot`, `expectReply`, golden transcripts, replay	A complete Vitest file that records and replays a conversation
Build a plugin: FAQ with tools	Advanced	Plugins, Dependency injection	`definePlugin`, `install`/`uninstall`, `ctx.onDispose`, `provide`	A reusable FAQ plugin that shares its counters as a tool

Feature coverage

Which examples show each main feature. Every example also runs in the terminal simulator and, except the Cloud API webhook server, on WhatsApp (Baileys) and Telegram with the same bot code.

Feature	Examples
Flows (`flow()` DSL)	Registration flow, Menu bot, Shopping flow, Appointment booking, AI router, Testing your bot, Cloud API webhook server
Questions, menus and forms (`ask`, `choose`, `form`)	Registration flow, Menu bot, Shopping flow, Support with timeout, Appointment booking, Order tracking
Triggers and commands	Greeting bot, FAQ bot, Send messages, Group bot, FAQ plugin
Media (send and receive)	Media replies
Polls	Poll bot
Buttons	Menu bot, AI booking assistant
Hooks	Rate limiter, Multi-language bot
Plugins	Rate limiter, FAQ plugin
i18n	Multi-language bot
User data (`ctx.user`)	Order tracking, Appointment booking, Daily digest, WhatsApp and Telegram
Human handoff	Human handoff, AI with human escalation
Groups	Group bot
Scheduler	Reminder bot, Daily digest, Human handoff
Broadcast	Daily digest
Stores	Appointment booking, Order tracking, WhatsApp and Telegram, Production-ready bot, Daily digest
Durability	Production-ready bot
Multi-channel (one bot, several providers)	WhatsApp and Telegram
Webhooks and WhatsApp Cloud API	Cloud API webhook server
Telegram	WhatsApp and Telegram, Streaming AI replies, Group bot, Multi-language bot
AI chat	AI FAQ assistant, AI answers from your FAQ, AI router
AI tools with confirmation	AI booking assistant, AI with human escalation
AI chat history and RAG	AI answers from your FAQ, AI FAQ assistant, AI router
AI streaming	Streaming AI replies
Testing	Testing your bot, Streaming AI replies
Terminal simulator (`npx botmesh dev`)	Greeting bot, Poll bot, Testing your bot

Apart from the Cloud API webhook server, the bot code of every example is the same on WhatsApp (Baileys) and Telegram: only the provider changes. Where a channel renders something differently (buttons, stickers), the example page says so, and the capability matrix lists the details.