VS Code + OmniChannels.ai：在 Copilot 智能体模式中使用消息工具

您可以做什么

• 编写与模板匹配的代码

  Copilot 通过 MCP 列出您已审核的 WhatsApp 模板，并按每个模板所需的变量编写发送代码。

  试着这样提问

  “列出我已审核的 WhatsApp 模板，然后写一个 C# 方法，用订单号和送达日期发送 order_update 模板。”

• 搭建并测试 webhook 接口

  Copilot 为送达状态和入站消息编写接口，然后您触发一次测试发送，查看真实载荷到达。

  试着这样提问

  “写一个 FastAPI webhook 接口，按消息 ID 保存送达状态，并能接收随渠道而异的字段，然后向 447700900123 发送一条测试短信，让我观察它的到达。”

• 上线前核对送达情况

  您的代码发出测试消息后，Copilot 读取送达报告，您可以核对处理程序记录的状态是否一致。

  试着这样提问

  “查看最近发给 971500000000 的消息的送达报告，并将其状态与我们数据库中的记录对比。”

• 依据规范而非记忆

  工作区中有我们的 OpenAPI 规范时，Copilot 会使用准确的路径和字段，包括哪些发送需要 multipart/form-data。

  试着这样提问

  “根据 docs/omnichannels-openapi.yaml，编写批量 WhatsApp 发送辅助函数，并指出哪些字段以 multipart/form-data 方式发送。”

• 起草阿拉伯语和英语文案

  Copilot 起草两种语言的消息文本，并在调用任何发送工具之前先展示给您。

  试着这样提问

  “起草一条阿拉伯语和英语的预约提醒短信，各不超过一个分段，并在向 966500000000 发送测试前先给我看。”

连接方式

设置步骤

1. 1

   申请 API 访问权限

   申请测试权限并获取 API 令牌。测试发送只会发往您自己已验证的号码。

2. 2

   获取临时密钥

   在管理后台打开 Integrations，进入 MCP Integration，选择 Get temporary key。

   指南: MCP server for AI agents
3. 3

   创建 .vscode/mcp.json

   添加一个类型为 http、使用我们 URL 的 omnichannels 服务器，一个使用 ${input:omnichannels-token} 的 Authorization 请求头，以及一个 password 设为 true 的 promptString 输入项。

   指南: MCP server for AI agents
4. 4

   启动服务器并输入密钥

   在 VS Code 中启动服务器，按提示粘贴您的密钥，并确认工具已出现在 Copilot 智能体模式中。

5. 5

   限制工具范围

   在工具列表中关闭该工作区不需要的工具，并对每个发送类工具保持确认开启。

6. 6

   用自己的号码测试

   让 Copilot 向您已验证的号码发送一条测试消息，然后读取送达报告。