Typebot 3.19 介绍与选型指南

目标：本文从零介绍 Typebot 无代码聊天机器人构建器的定位、架构、功能与生态，并量化对比主流同类方案的选型维度，帮助读者快速判断 Typebot 是否适合自己的业务场景。版本信息截至 2026-10-27，对应 Typebot v3.19.0。

一、环境信息

查询日期：2026-10-27
Typebot 最新稳定版：v3.19.0（2026-10 发布）
GitHub 仓库：baptisteArno/typebot.io
官方网站：typebot.io / typebot.com
官方文档：docs.typebot.com
技术栈：TypeScript + Next.js（两个独立应用：builder + viewer）+ Prisma ORM + PostgreSQL + S3 兼容对象存储
自托管许可：Functional Source License (FSL)，2 年后转为 Apache 2.0

二、软件概述

Typebot 是一款由 Baptiste Arno 单人主导开发的开源无代码聊天机器人构建平台，允许用户通过可视化拖拽式编辑器构建对话流程，并通过多种渠道（网页嵌入、WhatsApp、Telegram、API 等）部署发布。它自 2021 年上线以来已迭代至 v3.x 大版本，定位为"可与 Tidio、Intercom 等商业平台匹敌的开源替代品"。

Typebot 的核心卖点是：

真正的无代码可视化：拖拽式流程编辑器、实时预览、无部署门槛
Builder / Viewer 双应用分离：编辑器与运行时解耦，可独立扩缩容
完整的业务闭环：从 bot 构建、发布、访客对话到结果统计，一站式完成
Fair Source 许可 + 自托管友好：官方主推 Docker Compose 部署路径
丰富的集成生态：Google Sheets、WhatsApp、Telegram、OpenAI、Stripe、Webhook 等

三、核心架构

Typebot 采用"双 Next.js 应用 + 共享数据库"的架构设计：

组件	作用	对外端口
Builder（typebot-builder）	可视化编辑器 + 账户/工作空间管理 + API Token 管理	默认 3000（Compose 示例映射 8080）
Viewer（typebot-viewer）	运行时对话引擎 + 访客界面渲染 + Webhook/消息回调	默认 3000（Compose 示例映射 8081）
PostgreSQL	唯一必需的持久化存储，存放 bot 定义、用户数据、对话日志等	5432
S3 兼容存储	可选，存放媒体上传（图片/视频/GIF）	由 S3_ENDPOINT 指定
Redis	v3 起可选，用于缓存与限流加速	6379

关键设计特点：

Builder 与 Viewer 使用相同的 DATABASE_URL 和 ENCRYPTION_SECRET
Viewer 的 NEXTAUTH_URL 仍指向 Builder（认证走 Builder），但只运行对话渲染逻辑
数据模型通过 Prisma ORM 管理，迁移自动在首次启动时执行
支持横向扩容：Viewer 可多副本部署以应对高并发访客，Builder 一般单实例即可

四、功能特性

4.1 可视化 Bot 编辑器

拖拽式流程画布：图形化组织对话节点（气泡消息、输入框、条件分支、跳转等）
Block 类型丰富：文本、图片、视频、表单、问题（多种输入类型）、跳转、Webhook、HTTP 请求、脚本执行、支付块等
实时预览：编辑器内即可模拟访客视角测试对话流程
主题自定义：气泡颜色、字体、头像、聊天气泡样式、进度条等均可配置
变量与逻辑：支持在对话中设置变量、条件判断、数学运算、日期处理

4.2 发布渠道

渠道	说明
网页嵌入	生成 `<script>` 标签，嵌入任意网页；支持全屏弹窗、气泡悬浮、内嵌 iframe
WhatsApp Business	对接 Meta WhatsApp Business API，官方内置集成
Telegram	通过 Telegram Bot Token 对接
REST API	Builder 与 Viewer 各有一套 REST API，可用于外部系统集成、批量管理 bot、程序化发送消息
iframe/直接链接	Viewer 直接提供 bot 对话页的公开 URL

4.3 集成能力

Typebot 内置数十种第三方集成，覆盖常见业务场景：

AI：OpenAI、GPT-4o、Claude、LLM 自定义端点
数据与办公：Google Sheets、Notion、Airtable、Cal.com
支付：Stripe
消息：Email SMTP、Webhook、Zapier
外部数据源：HTTP Request（REST API）、GraphQL、数据库直连

4.4 管理与协作

Workspace 多租户：一个账户可管理多个 Workspace，每个 Workspace 独立成员、独立 bot
成员邀请与角色：管理员、编辑者、访客等权限
版本历史：bot 修改后自动保存历史，可回溯
统计面板：访客数、对话数、完成率、平均对话时长等关键指标
API Token：用于程序化访问 REST API

五、快速开始（最小可用示例）

通过 Docker Compose 3 步启动 Typebot：

# 1. 下载 Compose 文件
wget https://raw.githubusercontent.com/baptisteArno/typebot.io/latest/docker-compose.yml
wget https://raw.githubusercontent.com/baptisteArno/typebot.io/latest/.env.example -O .env

# 2. 生成加密密钥并填入 .env
openssl rand -base64 24 | tr -d '\n' ; echo

# 3. 启动
docker compose up -d

启动后访问 Builder（默认 8080）即可看到登录界面；Viewer（默认 8081）承载访客对话。首次注册的邮箱会获得 UNLIMITED 套餐。

💡 技术拓展：自托管聊天机器人的架构模式远不止 Typebot 这一种。常见的自托管方案按架构可分为三类——

模式代表项目特点
双应用分离（Builder + Viewer） Typebot、Botpress 编辑器与运行时独立扩展，灵活但资源开销大
单应用一体化 Tracardi、Rasa OSS 部署简单但难以独立扩缩容
仅运行时 + 外部编辑器 Dialogflow CX (自托管部分) 运行时轻量但编辑器依赖云服务

Typebot 选择第一种，适合需要独立扩缩容 Builder（设计）和 Viewer（生产）的场景。

模式	代表项目	特点
双应用分离（Builder + Viewer）	Typebot、Botpress	编辑器与运行时独立扩展，灵活但资源开销大
单应用一体化	Tracardi、Rasa OSS	部署简单但难以独立扩缩容
仅运行时 + 外部编辑器	Dialogflow CX (自托管部分)	运行时轻量但编辑器依赖云服务

六、适用场景与限制

适用场景

场景	说明
客户支持 FAQ 机器人	替代或补充人工客服，处理常见问题查询、表单收集
产品引导与营销	网站嵌入 bot，引导访客完成引导流程、收集邮箱
问卷与表单	可视化构建调查表单，结果自动同步 Google Sheets
内部流程自动化	对接 Webhook/API，触发内部系统（如工单创建、CRM 更新）
WhatsApp Business Bot	面向海外客户的 WhatsApp 渠道客服/营销 bot
教育与培训	在线问答、互动教学、学习进度收集
私域引流	结合 Telegram/WhatsApp 的多渠道触达

主要限制

双应用资源占用：Builder + Viewer 各一个 Next.js 进程，加 PostgreSQL，最低建议 2 vCPU / 4GB RAM
WhatsApp 集成需 Meta 企业认证：WhatsApp Business 渠道需 Meta 开发者账号 + 商业验证
无原生 Kubernetes Helm Chart：官方主推 Docker Compose，K8s 部署需自行编排
大流量场景需 Redis：默认无 Redis 时缓存靠进程内存，高并发下需要配置 Redis
许可证商业限制：FSL 许可证禁止商业化转售 Typebot 实例本身（但允许在自己业务中使用）

七、同类选型对比

维度	Typebot	Botpress	Rasa OSS	N8N (对话节点)	Tidio (非自托管)
自托管	✅	✅	✅	✅（Node.js）	❌
无代码编辑器	✅ 成熟	✅ 成熟	❌ 需写 YAML	⚠️ 弱	✅
架构	双 Next.js	单 Node + Botpress Studio	服务端 + 可选 Rasa X	单 Node	SaaS
存储	PostgreSQL	SQLite/Postgres/MySQL	SQLite/Postgres	SQLite/Postgres	SaaS
部署难度	低（Compose）	中（需 BP Studio）	中（Python + 服务）	低（Compose）	极低
渠道覆盖	10+ 主流	10+ 主流	广泛（需自建 adapter）	通过 HTTP 覆盖	主流
企业级特性	Workspace 多租户	Team 版付费	自定义能力强	工作流自动化	全部 SaaS
许可	FSL（2 年转 Apache 2）	AGPL-3.0	Apache 2.0	SSPL	SaaS 协议
单节点资源	2 vCPU / 4GB RAM	2 vCPU / 4GB RAM	4 vCPU / 8GB RAM（推荐）	1 vCPU / 2GB RAM	—
社区活跃度	高（~25k GitHub Stars）	中（~16k Stars）	中（~17k Stars）	高（~50k Stars）	—
商用可行性	业务内使用 OK	业务内使用 OK	完全自由	业务内使用 OK	需订阅
维护状态	单人主导，持续更新	公司维护	活跃（基金会）	公司维护	持续

选型建议

需要自托管 + 完整无代码体验 → Typebot 是最佳选择，编辑器成熟、部署简单、社区活跃
需要更强的对话编排 + 机器学习能力 → Rasa OSS（完全自由，但学习曲线陡峭）
已有 N8N 自动化工作流，只需要轻量 bot → 可在 N8N 内用 HTTP 节点实现，但体验不如 Typebot 原生
大预算 SaaS 优先 → Tidio / Intercom 等商业方案无需运维
需要私有化且预算充足 → Botpress Team 版提供企业级支持

八、参考链接

Typebot 官网：https://typebot.com
官方文档：https://docs.typebot.com
GitHub 仓库：https://github.com/baptisteArno/typebot.io
Docker Hub（Builder）：https://hub.docker.com/r/baptistearno/typebot-builder
Docker Hub（Viewer）：https://hub.docker.com/r/baptistearno/typebot-viewer
License（FSL 全文）：https://raw.githubusercontent.com/baptisteArno/typebot.io/main/LICENSE
竞品对比参考：SelfHostedHub Typebot 条目