文档 / 快速入门
十分钟内启动您的第一个机器人
本指南将引导您创建一个 Telegram 机器人,将其接入 Meshwire,并发布一个正式上线的流程。
1. 使用 BotFather 创建机器人
打开 Telegram,向 @BotFather 发消息,并执行 /newbot。选择一个显示名称和一个以“bot”结尾的唯一用户名。BotFather 会返回一个 HTTP API 令牌——请复制它,接下来会用到。
/newbot
Alright, a new bot. How are we going to call it?
> Acme Support Bot
Good. Now let's choose a username for your bot.
> acme_support_bot
Done! Use this token to access the HTTP API:
110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw2. 将令牌连接到 Meshwire
在控制台中,进入“机器人 → 新建机器人”,粘贴令牌,并选择托管模式。生产环境推荐使用 Webhook 模式;轮询模式适合快速的本地测试。
POST /v1/bots
{
"name": "Acme Support Bot",
"token": "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
"hostingMode": "webhook",
"timezone": "Europe/Warsaw"
}3. 构建您的第一个流程
打开流程编辑器,将一个 trigger.command 节点(例如 /start)拖到画布上。将其连接到一个带欢迎消息的 msg.text 节点,然后添加一个带快速回复按钮的 msg.inline_keyboard 节点。
trigger.command(/start)
-> msg.text("Welcome to Acme Support! How can we help?")
-> msg.inline_keyboard(["Talk to sales", "Track an order"])4. 在沙盒中测试
使用内置模拟器发送测试消息,而不影响真实的 Telegram 流量。它会精确显示您的流程将如何响应,包括按钮和媒体内容。
Simulator > /start
Bot: Welcome to Acme Support! How can we help?
[ Talk to sales ] [ Track an order ]5. 发布
点击“发布”并添加一条简短的发布说明。Meshwire 会验证流程、创建版本快照,并将实际流量切换到该版本。您可以随时回滚到之前的任意版本。
POST /v1/bots/{botId}/publish
{ "note": "Initial launch: welcome + support routing" }准备深入了解了吗?
探索 API 参考 或设置 出站 Webhook ,将事件同步到您自己的系统。