WasapFlow Bridge

com.wasapflow由 wasapflow.com 发布官方发布者v1.0.1更新于 Nov 4, 2026

Official WhatsApp Business API for your own CRM or SaaS: docs, numbers, messages, webhooks.

已验证Streamable HTTP可网页运行开发者工具沟通与协作商业与电商

概览

AI 生成的概览

WasapFlow Bridge 让助手接入官方 WhatsApp Business API：查阅文档、查看号码状态、发送消息与模板、排查 webhook 问题。

可以做什么
  • 阅读集成文档与分步接入方案，获取完整文档章节
  • 列出已注册的 WhatsApp 号码、其 Meta 实时状态、模板及 Bridge 套餐用量
  • 生成短期有效的 Embedded Signup 连接链接，供商家绑定号码
  • 从已连接号码发送真实文本、模板和营销消息
  • 查看并重投失败的 webhook 事件，创建或列出支持工单
  • 直接调用其他 Bridge 接口，不可逆操作需确认
适用场景
适合在通过 WasapFlow 基于官方 WhatsApp Business API 构建或维护 CRM、SaaS 时使用，也适合让助手检查号码状态、发送测试消息或排查收不到消息的问题。
运行要求
远程 streamable HTTP 端点，无需本地安装。调用实时 API 的工具需要在 x-partner-key 请求头中提供合作伙伴密钥，可从 WasapFlow 合作伙伴门户获取；文档与入门工具无需密钥。实际接入号码需要已绑定银行卡的合作伙伴账户。
安装前请注意
发送类工具会发出真实 WhatsApp 消息，模板和营销消息可能由 Meta 收费；Bridge 本身按每三个号码每月计费。合作伙伴密钥属于机密，不应回显给用户。部分工具会修改或删除数据，通用 API 工具可触达不可逆端点，调用前应先确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 WasapFlow Bridge，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.wasapflow%2Fbridge/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "wasapflow-bridge": {
      "type": "http",
      "url": "https://officialapi.wasapflow.com/bridge/mcp"
    }
  }
}

README

WhatsApp CRM Starter: official WhatsApp Business API in your own app

A minimal, working WhatsApp CRM on the official WhatsApp Business API (Meta Cloud API) through WasapFlow Bridge. You don't need to become a Meta Tech Provider or go through Meta App Review. Clone it and run it, then let your AI (Claude Code, Cursor, Codex, Copilot) grow it into your CRM or SaaS.

It's about 400 lines of Node.js across four files, with two dependencies and no build step.

What it does

  • Connect WhatsApp button. Your client connects their number through Meta Embedded Signup. Coexistence is supported, so the business can keep using the WhatsApp Business app on their phone.
  • Signed webhooks. Incoming messages, delivery and read status, replies typed on the phone (message.echo), and chat history backfill (message.history).
  • Inbox. Conversations, unread counts, the 24-hour window, and text or template replies.
  • Multi-number. Everything is keyed by phone_number_id.
  • BSUID-safe contacts. WhatsApp usernames don't break your phone field.
  • AGENTS.md, CLAUDE.md and .cursor/rules. These tell your AI exactly how the integration works, so what it builds on top stays correct.

Run it in 5 minutes

  1. Partner account. Create a free account at https://partner.wasapflow.com/bridge/partner/register and save a card. Nothing is charged until the first number connects. After that, Bridge costs $10/month for every 3 WhatsApp numbers, and Meta bills message charges directly.
  2. Install:
    bash
    git clone https://github.com/kobaranteguh/whatsapp-crm-starter.gitcd whatsapp-crm-starternpm installcp .env.example .env
  3. Keys. Open portal → Integration and copy the Partner Key and Webhook Secret into .env.
  4. Public URL for webhooks. Deploy the app (Railway, Render, Fly, a VPS), or tunnel your local machine (cloudflared tunnel --url http://localhost:3000 or ngrok http 3000). In portal → Integration, save the webhook URL as https://<your-domain>/webhook/wasapflow.
  5. Start:
    bash
    npm start
    Open http://localhost:3000 (user admin, password = ADMIN_PASSWORD), click + Connect WhatsApp, then message that number from your phone.

Build the rest with your AI

Open the folder in your AI tool and paste one of these prompts:

Read AGENTS.md and the WasapFlow Bridge API reference. Replace lib/store.js with Postgres using Prisma, keeping the same exports. Add migrations.

Read AGENTS.md. Make this multi-tenant: users sign up, each tenant connects its own WhatsApp numbers via POST /connect/session with state = tenant id, and only sees its own inbox.

Read AGENTS.md and the Bridge docs. Add media: show incoming images and documents, and let agents send images from the composer.

Read AGENTS.md. Add a templates page: list templates with status, create new ones, and refresh on the template.status_updated webhook.

Read AGENTS.md. Add assignment and tags: assign a conversation to a staff member, tag it, and filter the inbox by tag.

Give your AI live access (optional). The WasapFlow MCP server lets it search the docs and call your Bridge account, for example to list numbers, check failed webhooks, or send a test message.

bash
claude mcp add --transport http wasapflow https://officialapi.wasapflow.com/bridge/mcp --header "x-partner-key: wf_..."
json
{ "mcpServers": { "wasapflow": { "url": "https://officialapi.wasapflow.com/bridge/mcp", "headers": { "x-partner-key": "wf_..." } } } }

Files

FileWhat it is
server.jsWebhook receiver (signature check, events), /api/*, Basic auth
lib/bridge.jsThe only module that calls Bridge (plain fetch, no SDK)
lib/store.jsJSON-file storage that you can replace with your database
public/index.htmlInbox UI
AGENTS.mdRules and recipes for AI coding tools

Links

FAQ

Do I need a Meta Business verification or app review? You don't need app review or Tech Provider status. Bridge provides both. Each business connects its own number through Meta's Embedded Signup and must follow WhatsApp's policies.

Can a business keep using WhatsApp on their phone? Yes. With Coexistence, replies typed on the phone show up in this inbox as message.echo.

Is this production-ready? The integration patterns are: signature check, deduplication, BSUID handling, multi-number, and the 24-hour window. The JSON-file storage and Basic auth are not. Swap them in for your stack (see the prompts above).

MIT licensed. © Kobaran Teguh Sdn. Bhd.

来源：README.md，提交 050e7b8

工具

16

bridge_get_started

How to integrate WasapFlow Bridge

Step-by-step plan to add the official WhatsApp Business API to the user's own CRM/SaaS with WasapFlow Bridge: account, card, keys, webhook, Connect WhatsApp button, first message. Call this first when someone wants to build or connect WhatsApp. No partner key needed.

无需输入参数。

bridge_docs_section

Read a Bridge docs section

Return the full text of one section (with its sub-sections) of the WasapFlow Bridge docs, e.g. "Verify Incoming Webhooks", "Send Template Message", "Webhook Event Payloads", "Error Codes". No partner key needed.

输入参数docheading必填

bridge_list_numbers

List connected WhatsApp numbers

List the WhatsApp Business Accounts (client numbers) registered to this partner, with status.

输入参数limit

bridge_number_status

Phone number status & quality

Live status of a number from Meta: verified name, quality rating, messaging limit, name status.

输入参数waba_id必填

bridge_send_text

Send a WhatsApp text message

Send a text message from a connected number. Free-form text only reaches people who messaged that number in the last 24 hours; otherwise use bridge_send_template. This sends a real message.

输入参数to必填text必填waba_id必填

bridge_send_template

Send a WhatsApp template message

Send an approved template (works outside the 24-hour window). components follows the Meta Cloud API format. This sends a real message and Meta may charge for it.

输入参数to必填name必填waba_id必填language必填components

bridge_send_marketing

Send a marketing template (Marketing Messages API)

Send an approved MARKETING template through Meta's Marketing Messages API (quality-based delivery, marketing metrics). Not onboarded yet? Meta falls back to Cloud API unless product_policy is STRICT. This sends a real message and Meta charges for it.

输入参数to必填name必填waba_id必填language必填componentsproduct_policy

bridge_list_templates

List message templates

List the message templates of a number with their approval status.

输入参数waba_id必填

bridge_failed_webhooks

Webhooks that failed to reach your server

Webhook events Bridge could not deliver to your webhook URL (with the error). Use when incoming messages are missing in the CRM.

输入参数limit

bridge_retry_webhooks

Redeliver failed webhooks

Redeliver one failed webhook event (event_id) or all of them (omit event_id) after the webhook endpoint is fixed.

输入参数event_id

bridge_usage

Bridge plan & usage

Current Bridge plan: active WhatsApp numbers, slots and the monthly Bridge fee.

无需输入参数。

bridge_open_ticket

Open a support ticket

Open a WasapFlow support ticket. Include what happened, when (with timezone), the exact error (Meta code, fbtrace_id), what was tried and the business impact.

输入参数message必填subject必填waba_idcategoryprioritydiagnostics

bridge_list_tickets

List support tickets

List support tickets and replies status.

输入参数status

bridge_call_api

Call any Bridge API endpoint

Call any WasapFlow Bridge endpoint not covered by the other tools (see bridge_docs_search for paths). Irreversible endpoints need {"confirm": true} in the body. Confirm with the user before any call that sends, deletes or changes something.

输入参数bodypath必填querymethod必填waba_id

版本历史

2
  1. v1.0.1最新Nov 4, 2026
  2. v1.0.0Nov 4, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分