Digi Kedai Bot 🤖

多通道 AI 客服机器人，全天候解答顾客问题——并自动开通免费试用账号，全程无需人工介入。

🇬🇧 English · 📋 项目状态（Project state）

欢迎！这是 Digi Kedai 在 Telegram 和 WhatsApp 上运行客服的机器人。它是一个我亲手搭建、真实运行的线上系统，不是 demo。我公开这份源码，是想让你清楚看到它如何工作，也希望能帮到每一个正在构建自己 AI 客服机器人的人。

在线体验 🤖

直接和真实机器人对话： Telegram 上的 @DigiKedaiBot —— 发送 /start、询问某个商品（例如 「CZH01 有免费版吗？」），或领取免费试用。你在对话的另一端，正是这个仓库里的代码，部署在我自己的基础设施上。

关于我 👋

你好，我是 Lee Teong Hoe（Mr Hoelee）——一名驻马来西亚的全栈开发者兼 DevOps 工程师。我经营 Hoelee Enterprise / SifuMail，为马来西亚中小企业搭建网站并自托管基础设施。

我习惯从零做到完整交付：应用、Docker 栈、Cloudflare 隧道、数据库、AI 接线，全部自己搞定。这个机器人就是其中之一——从想法到上线、面向真实顾客的 Telegram 机器人，只用了几周。

我为什么做这个机器人

Digi Kedai 销售数字产品（在线课程、电子书、模板）。每一单都会带来同样的问题——「这个有免费试看吗？」「我怎么拿到账号？」「我该买哪个套餐？」。对一个人的生意来说，人工回复根本忙不过来。

这个机器人 24/7 解答这些问题，按 SKU 或自然语言检索到正确的商品，并自动发放免费试用账号——顾客得到即时答复，我也省下了时间。

这个机器人能给你带来什么

24/7 客服——即时解答商品问题，顾客无需等待人工。
真实的商品知识——按 SKU 或自然语言检索正确商品，绝不会瞎编价格或商品。
自动开通免费试用——顾客领取试用并拿到账号，端到端全自动，无需员工介入。
确定性流程——购买、试用领取、深链都用可靠的状态机处理，而非脆弱的提示词工程。
长期记忆——跨会话、跨渠道记住每位顾客，让跟进更贴心。
多通道——同一套核心今天服务 Telegram 和 WhatsApp，Shopee/Lazada 已预留接口。

技术栈

TypeScript + Node.js + grammY，Docker 化部署
Cloudflare 隧道 webhook 入口（无需公网 IP，无需开放端口）
LiteLLM OpenAI 兼容网关，位于 LLM 之前（供应商无关 + 故障转移）
PostgreSQL 存储对话与用户记忆
NocoDB 处理免费试用开通（既有 webhook 完成后续工作）

目录结构

src/
  ai/                 代理、提示词组装、检索、记忆与摘要
  channels/           telegram + whatsapp 适配器（共享核心，每通道一个适配器）
  core/               归一化消息契约、限流
  db/                 postgres schema + 启动时自迁移
  integrations/       nocodb（试用开通）+ n8n（工具调用）
  data/               生成的商品目录（SKU/名称/分类/大小/URL——不含价格）
tests/                13 个 vitest 测试套件（检索、试用、购买、记忆、契约）
docs/                 架构、决策、路线图、运维手册

快速开始（开发）

cp .env.example .env          # 填入 BOT_TOKEN、LLM_API_KEY、POSTGRES_PASSWORD
npm install
npm run dev                   # tsx watch — 未设置 webhook URL 时用长轮询

npm test                      # vitest
npm run typecheck             # tsc --noEmit

完整架构、安装与运维手册见 docs/。

想要一个这样的机器人？来聊聊 🚀

如果你经营网店、服务生意或社群，整天被同样的顾客问题淹没——一个这样的机器人可以替你全天候、用顾客的语言回答他们。

我为企业定制 Telegram/WhatsApp AI 机器人、网站，以及自托管基础设施。如果你想做一个，或者想雇佣我，我非常乐意与你交流：

📱 WhatsApp： +60 12-797 2969
📧 邮箱： [email protected]
🌐 网站： hoelee.com

很高兴为你的生意打造一个机器人，或者单纯聊聊这个机器人是怎么做的。

4.6 KiB Raw Blame History Unescape Escape