跳转到正文
OmniChannels.ai

AI 助手与智能体

Google Gemini + OmniChannels.ai:为 Gemini Agent 提供消息工具

通过 MCP 连接通过 API 和 Webhook 连接更新于

简而言之

Gemini Agent 通过远程 MCP 服务器接入:ADK 的 MCPToolset 使用 Streamable HTTP,令牌放在 Authorization 请求头,Gemini CLI 同理。可发送 WhatsApp、短信和 RCS。

您可以做什么

  • 由 ADK Agent 发送客户通知

    基于 Agent Development Kit 构建的 Agent,在你的应用发出请求时发送发货或预约通知。

    试着这样提问

    “给 971500000000 发一条 WhatsApp 消息,告知其订单已发货,明天送达。”

  • 面向沙特和阿联酋客户的模板

    Agent 列出已审核的 WhatsApp 模板,并填写合适的阿拉伯语或英语版本。

    试着这样提问

    “列出我已审核的阿拉伯语 WhatsApp 模板,并向 966500000000 发送 order_update,订单号为 INV-400。”

  • 用 Gemini CLI 发送测试消息

    开发者在开发过程中,可直接在终端发送测试消息或查看送达报告。

    试着这样提问

    “向我已验证的号码发送一条测试短信,并告诉我送达状态。”

  • 送达分析

    只配备送达报告工具的只读 Agent,可为团队汇总失败情况。

    试着这样提问

    “昨天的对账单活动里有多少条消息失败?最常见的原因是什么?”

  • 与你的业务数据结合

    当 Agent 同时拥有连接 BigQuery、CRM 或店铺的工具时,可以从中获取收件人,再通过 OmniChannels.ai 发送。

    试着这样提问

    “给今天订单已发货的客户发送 WhatsApp 订单通知。”

连接方式

通过 MCP 连接通过 API 和 Webhook 连接

OmniChannels.ai 运行一个基于 Streamable HTTP 的远程 MCP 服务器。每个请求都在 Authorization: Bearer 请求头中携带你的 API 令牌,每个工具都按该令牌的权限、Sender ID 和余额执行,与你自己的代码完全一致。

在 Agent Development Kit 中,添加一个 MCPToolset,其 Streamable HTTP 连接参数包含我们的 URL 和 Authorization 请求头,并筛选出 Agent 所需的工具。ADK Agent 可部署到 Vertex AI Agent Engine;请把令牌存放在 Secret Manager 中,而不是写进代码。Gemini CLI 从其设置文件读取 MCP 服务器,用 httpUrl 指定接入点,用 headers 传递令牌。

  • 接入点:https://mcp.broadnet.me/mcp(Streamable HTTP)
  • 认证:Authorization: Bearer <token>;测试时使用临时密钥
  • ADK:带 Streamable HTTP 连接参数和 headers 的 MCPToolset
  • Gemini CLI:包含 httpUrl 和 headers 的 mcpServers 条目
  • 不使用 MCP 时,Agent 也可依据 OpenAPI 规范调用我们的 REST API

设置步骤

  1. 1

    申请 API 访问权限

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

  2. 2

    获取 MCP 密钥

    在管理后台依次打开 Integrations、MCP Integration,复制一个临时密钥。

    指南: MCP server for AI agents
  3. 3

    把工具集添加到 Agent

    在 ADK 中创建 MCPToolset,使用指向 https://mcp.broadnet.me/mcp 的 Streamable HTTP 参数和 Authorization 请求头,令牌从环境变量或密钥库读取。

  4. 4

    或者添加到 Gemini CLI

    添加 mcpServers 条目,httpUrl 设为我们的接入点,并在 headers 中填入 Authorization 请求头,然后重启 CLI。

  5. 5

    限制工具并确认发送

    只开放 Agent 需要的工具,并在任何发送之前加入确认步骤,因为每次发送都是真实计费的消息。

  6. 6

    先测试,再部署

    向你已验证的号码发送一条测试消息并检查送达报告,然后再把 Agent 部署到 Vertex AI Agent Engine。

厂商文档

Google Gemini and Vertex AI 是其所有者的商标。OmniChannels.ai 与 Google Gemini and Vertex AI 无关联,也未获得 Google Gemini and Vertex AI 的认可;本页介绍的是利用 Google Gemini and Vertex AI 自身的 MCP、HTTP 或 Webhook 功能建立的连接。

示例工作流程

一个典型请求如何从 Google Gemini and Vertex AI 传到您的客户,再返回。

  1. 01

    Gemini Agent

    基于 ADK 构建,或在本机使用 Gemini CLI

  2. 02

    OmniChannels.ai MCP 服务器

    工具集调用携带你的 Bearer 令牌

  3. 03

    客户手机

    WhatsApp、短信或 RCS 消息已送达

  4. 04

    送达报告

    Agent 通过读取工具回读状态

1. Gemini Agent: 基于 ADK 构建,或在本机使用 Gemini CLI 2. OmniChannels.ai MCP 服务器: 工具集调用携带你的 Bearer 令牌 3. 客户手机: WhatsApp、短信或 RCS 消息已送达 4. 送达报告: Agent 通过读取工具回读状态

常见问题

Gemini 有 OmniChannels.ai 官方应用吗?

没有。Gemini Agent 通过 Google 在 Agent Development Kit 和 Gemini CLI 中自带的 MCP 支持接入,使用我们的公开 MCP 接入点和你的 API 令牌。

能在 Gemini 应用中使用吗?

本页面介绍的是开发者路径:用 Agent Development Kit 构建的 Agent、Vertex AI Agent Engine 和 Gemini CLI。其他 Gemini 产品对 MCP 的支持情况,请查阅 Google 的最新文档。

生产环境中令牌应该放在哪里?

不要放在会提交的代码和配置里。在 Google Cloud 上,请存放在 Secret Manager 中,并在运行时传给 Agent。

Google 能访问我的客户数据吗?

模型只能看到工具返回的内容(如模板和送达报告)以及你的应用放入对话的内容。令牌会把 Agent 限制在你账户的权限范围内。

获取 API 与 MCP 访问权限

请告诉我们您的渠道、国家和使用场景。工程师会签发测试凭证并验证您的测试号码。