WasapFlow Bridge

WhatsApp CRM 入门项目：在自己的应用中使用官方 WhatsApp Business API

通过 WasapFlow Bridge 接入**官方 WhatsApp Business API（Meta Cloud API）**的极简可用 WhatsApp CRM。 你无需成为 Meta 技术提供商，也无需通过 Meta 应用审核。克隆并运行项目，然后让你的 AI（Claude Code、Cursor、Codex、Copilot）将它扩展成你的 CRM 或 SaaS。

整个项目约有 400 行 Node.js 代码，分布在 4 个文件中，只有两个依赖项，无需构建。

功能

• 连接 WhatsApp按钮。客户通过 Meta Embedded Signup 连接自己的号码。 支持共存模式，因此企业可以继续在手机上使用 WhatsApp Business 应用。
• **签名 Webhook。**接收消息、送达和已读状态、在手机上输入的回复（message.echo），以及聊天记录回填（message.history）。
• **收件箱。**会话、未读数、24 小时窗口，以及文本或模板回复。
• **多号码。**所有数据都以 phone_number_id 为键。
• **兼容 BSUID 的联系人。**WhatsApp 用户名不会影响你的电话号码字段。
• **AGENTS.md、CLAUDE.md 和 .cursor/rules。**这些文件会准确告知你的 AI 集成的工作方式，确保它在此基础上构建的功能保持正确。

5 分钟内运行

1. 合作伙伴账户。在 https://partner.wasapflow.com/bridge/partner/register 创建免费账户并保存一张银行卡。首次连接号码之前不会扣费。之后，Bridge 的费用为每 3 个 WhatsApp 号码每月 $10，Meta 会直接收取消息费用。 WasapFlow Bridge 只是连接 Meta 的桥梁：此应用是你的收件箱，号码通过应用自身的连接 WhatsApp按钮连接（WasapFlow 门户中没有连接按钮）。
2. 安装：

   git clone https://github.com/kobaranteguh/whatsapp-crm-starter.git
   cd whatsapp-crm-starter
   npm install
   cp .env.example .env
   

3. **密钥。**打开门户 → 集成，将 Partner Key 和 Webhook Secret 复制到 .env 中。
4. **Webhook 公网 URL。**部署应用（Railway、Render、Fly、VPS），或为本地计算机建立隧道（cloudflared tunnel --url http://localhost:3000 或 ngrok http 3000）。 在门户 → 集成中，将 Webhook URL 保存为 https://<your-domain>/webhook/wasapflow。
5. 启动：

   npm start
   

   打开 http://localhost:3000（用户名为 admin，密码为 ADMIN_PASSWORD），点击**+ 连接 WhatsApp**，然后用手机向该号码发送消息。

使用 AI 构建其余功能

在 AI 工具中打开此文件夹，并粘贴以下提示词之一：

阅读 AGENTS.md 和 WasapFlow Bridge API 参考文档。将 lib/store.js 替换为使用 Prisma 的 Postgres，同时保留相同的导出内容。添加迁移。

阅读 AGENTS.md。将其改为多租户：用户可以注册，每个租户通过 POST /connect/session 连接自己的 WhatsApp 号码，并将 state 设为租户 ID，且只能查看自己的收件箱。

阅读 AGENTS.md 和 Bridge 文档。添加媒体功能：显示收到的图片和文档，并让客服人员可以从编辑框发送图片。

阅读 AGENTS.md。添加模板页面：列出模板及其状态、创建新模板，并在收到 template.status_updated webhook 时刷新。

阅读 AGENTS.md。添加分配和标签功能：将会话分配给一名工作人员、为会话添加标签，并按标签筛选收件箱。

**让你的 AI 实时访问（可选）。**WasapFlow MCP 服务可以让它搜索文档并调用你的 Bridge 账户，例如列出号码、检查失败的 Webhook，或发送测试消息。

claude mcp add --transport http wasapflow https://officialapi.wasapflow.com/bridge/mcp --header "x-partner-key: wf_..."

{ "mcpServers": { "wasapflow": { "url": "https://officialapi.wasapflow.com/bridge/mcp", "headers": { "x-partner-key": "wf_..." } } } }

文件

文件	说明
server.js	Webhook 接收器（签名检查、事件）、/api/*、Basic auth
lib/bridge.js	唯一调用 Bridge 的模块（原生 fetch，无 SDK）
lib/store.js	JSON 文件存储，可替换为你的数据库
public/index.html	收件箱界面
AGENTS.md	AI 编码工具的规则和操作指南

链接

• API 参考（Markdown，适用于 AI 工具）：https://raw.githubusercontent.com/kobaranteguh/api/main/README.md
• 合作伙伴指南：https://raw.githubusercontent.com/kobaranteguh/guide/main/README.md
• OpenAPI 3.1：https://officialapi.wasapflow.com/bridge/openapi.json
• Postman：https://www.postman.com/ustazzul/workspace/wasapflow-bridge-api
• 文档：https://partner.wasapflow.com/bridge/docs

常见问题

我需要通过 Meta Business 验证或应用审核吗？ 您无需通过 Meta 应用审核，也无需具备 Tech Provider 身份；Bridge 会提供这两项。每个企业都可以通过应用中的「连接 WhatsApp」按钮，使用 Meta 的 Embedded Signup 连接自己的号码，并且必须遵守 WhatsApp 的政策。

企业还能在手机上继续使用 WhatsApp 吗？ 可以。使用 Coexistence 时，在手机上输入的回复会以 message.echo 的形式显示在此收件箱中。

这是否已做好生产环境使用的准备？ 这些集成模式已准备就绪：签名检查、去重、BSUID 处理、多号码支持和 24 小时窗口。JSON 文件存储和 Basic auth 尚未准备就绪。请将它们替换为适用于您技术栈的方案（见上文的提示词）。

采用 MIT 许可。© Kobaran Teguh Sdn. Bhd.