Claude Code + OmniChannels.ai：在终端中开发并测试消息功能

您可以做什么

• 依据真实模板编写代码

  Claude Code 通过 MCP 读取你已审核的 WhatsApp 模板，并写出恰好包含各模板所需变量的函数。

  试着这样提问

  “使用 omnichannels 工具列出我已审核的 WhatsApp 模板，然后编写一个 TypeScript 函数，用所需字段发送 order_update。”

• 构建 webhook 处理程序

  让 Claude Code 参考 webhook 指南，它会写出保存送达状态和入站消息的接口，并兼容各渠道不同的字段。

  试着这样提问

  “编写一个 Express webhook 处理程序，按消息 ID 记录 SUBMITTED、SENT、DELIVERED、READ、FAILED 和 REJECTED 状态，遇到未知字段时只记录日志而不报错。”

• 依据规范生成带类型的客户端

  把 OpenAPI 规范放进代码仓库后，Claude Code 会使用准确的路径和字段，而不是凭猜测。

  试着这样提问

  “使用 docs/omnichannels-openapi.yaml，编写一个通过 POST /sms/sendSms 发送短信的 Python 模块，并按规范列出你用到的每个字段及其类型。”

• 用自己的号码做端到端测试

  你批准工具调用后，Claude Code 发送一条测试消息，再查看送达报告，确认代码路径可用。

  试着这样提问

  “以 OmniDemo 为发件人，向我的号码 447700900123 发送一条测试短信，然后查看其送达报告。”

• 排查发送失败

  读取类工具让 Claude Code 把送达报告与你的日志对照，并追溯到引发失败的那次请求。

  试着这样提问

  “读取昨天活动的送达报告，总结失败原因，并对照错误指南检查我们的重试代码。”

连接方式

设置步骤

1. 1

   申请 API 访问权限

   申请测试权限并获取 API 令牌。测试消息只会发送到你已验证的本人号码。

2. 2

   获取临时密钥

   在管理后台依次打开 Integrations、MCP Integration，选择 Get temporary key，并导出为 BROADNET_TOKEN。

   指南: MCP server for AI agents
3. 3

   添加服务器

   带 Authorization 请求头运行 claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp，或为团队提交项目级 .mcp.json，然后用 /mcp 检查。

   指南: Use the MCP server with Claude Code
4. 4

   设置权限规则

   按需允许 mcp__omnichannels__get_* 等读取类工具，让所有发送类工具保持询问，并禁用项目不需要的工具。

   指南: Use the MCP server with Claude Code
5. 5

   添加 OpenAPI 规范

   把 openapi.yaml 下载到你的代码仓库，并告诉 Claude Code 以它为准确定接口路径、字段和枚举值。

   指南: OpenAPI 3.1 spec
6. 6

   用自己的号码测试

   让 Claude Code 向你已验证的号码发送一条测试消息，然后回读送达报告。