BuilderBot

快速入门

借助本库，您可以构建与 WhatsApp 服务提供商无关的自动化对话流程，设置常见问题的自动回复，自动接收并回复消息，以及跟踪与客户的互动。此外，您还可以轻松设置触发器，以无限扩展功能。

npm create builderbot@latest

文档

访问 builderbot 查看完整文档。

官方课程

如果您想深入了解该库提供的所有功能和特性，可以参加我们的课程。 查看课程

联系我们

• 💻 Discord
• 👌 𝕏 (Twitter)

BuilderBot 快速上手指南

BuilderBot 是一个用于构建自动化对话流程的开源库，支持多种 WhatsApp 提供商。它可以帮助你设置自动回复、处理常见问题、自动收发消息以及追踪客户互动，并支持通过触发器无限扩展功能。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• Node.js: 建议安装 LTS 版本（v18 或更高）。
• npm: 随 Node.js 一同安装，用于管理依赖包。
• 代码编辑器: 推荐 VS Code 或其他你熟悉的编辑器。

提示：国内开发者若遇到 npm 下载缓慢问题，可临时切换至淘宝镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

使用官方提供的脚手架工具快速初始化项目。打开终端并运行以下命令：

npm create builderbot@latest

按照终端提示输入项目名称并选择配置选项，完成后进入项目目录并安装依赖：

cd <your-project-name>
npm install

基本使用

初始化完成后，你可以开始定义简单的对话逻辑。以下是一个最基础的自动回复示例（通常位于 src/flows 或类似目录下）：

import { addKeyword } from '@builderbot/bot'

const welcomeFlow = addKeyword('hi')
  .addAnswer('👋 你好！欢迎使用 BuilderBot。', {
    capture: true
  }, async (ctx, { flowDynamic }) => {
    await flowDynamic(`收到你的消息：${ctx.body}`)
  })

export default welcomeFlow

启动开发服务器以测试效果：

npm run dev

根据文档指引配置 WhatsApp 提供商凭证后，即可在手机上发送 "hi" 测试自动回复功能。

更多详细功能和高级用法，请访问 BuilderBot 官方文档。