本文档由英文原版机器翻译而成。如果翻译版本与英文原版之间存在任何冲突，请以英文原版为准。 阅读英文原版

消息网关：让 Caiioo 在您的联系人已使用的应用上进行回复

消息网关是一种与服务无关的方式，让 Caiioo 能够在您的客户和联系人已使用的平台上发送和接收消息。人们在 WhatsApp、Telegram 或任何他们常用的地方给您发消息，代理会自动在他们的频道中实时回答。该网关也可以反向工作：在任何线程中，代理都可以作为工具发送消息（“在 Telegram 的团队群组中发短信告知会议事宜”）。

一个网关，多种服务。您只需连接每个服务一次，Caiioo 就会在单一界面后将所有内容标准化。

支持的服务

在 Settings > Connectivity > Messaging Gateway 中连接以下任意服务：

  • WhatsApp Business — 稳定
  • Telegram — 稳定
  • Messenger（beta）
  • iMessage（beta）
  • Signal（beta）
  • Viber（beta）
  • Beeper（beta）

WhatsApp Business 和 Telegram 是稳定的。其余处于 beta 阶段——完全可用，仍在加固中。

配置

  1. 在设置 > 连接 > 设备与中继 > 专有中继中为此设备开启远程访问。这是实际将设备连接到接收传入消息的中继的关键 — 没有它，无论下方服务如何配置，均无法收到任何内容。该项默认关闭且按设备独立设置（参见下方的平台支持）。
  2. 前往设置 > 连接 > 消息网关。
  3. 选择一项服务。
  4. 输入该提供商的标准机器人或企业凭据 — 即您在该平台上进行任何集成所使用的相同令牌或企业账户。
  5. Caiioo 会注册入站路由。如果目前所有设备都未开启远程访问，设置 > 连接 > 消息网关会予以提示，并允许您在此直接开启。

每项服务只需配置一次。配置完成后，无论连接了多少个服务，智能体都将看到单一统一的消息通信能力。

逐对话交互模式

每个对话都有自己的模式，可通过线程顶部的三个按钮进行选择，因此您可以决定代理对每个联系人的表现方式：

自动 (绿色)

代理会自动回答所有人。您在同一线程中输入的任何内容都被视为辅导 —— 它会影响代理的下一次回复，但不会发送给联系人。当您希望代理处理对话但偶尔想引导它时（如“更正式一点”、“提供折扣”），请使用此模式。

介入 (蓝色)

代理仍会自动回答入站消息，但您输入的任何内容都会以您的身份直接发送给联系人。当您想亲自参与对话，同时让代理在间隙保持对话进行时，请使用此模式。

聊天 (琥珀色)

代理会暂停并退出 —— 它停止自动回复，由您亲自处理对话，您的消息将以您的身份发送给联系人。当某个线程需要人工介入且您希望代理不要干扰时，请使用此模式。

双向媒体传输

图像、音频和视频双向流动。当联系人发送照片时，它会到达模型，因此您可以询问“客户刚发的这张照片里有什么？”并直接在同一频道中回答。代理生成或附加的媒体也会以同样的方式流回给联系人。

隐私与架构

所有消息处理都在已开启远程访问的设备上本地运行——无论是桌面端应用、浏览器插件，还是两者皆有。智能体在您的机器上运行；对话、凭证和媒体都在本地处理，而不在云端。

Cloudflare 仅充当一个简单的每用户 webhook 中继。每个用户都会获得一个单租户的 Durable Object，通过私有连接将原始传入 webhook 转发到您的设备，仅此而已。这里没有云端消息存储，也没有云端处理。出站消息完全绕过 Cloudflare——您的设备直接调用服务的 API。Cloudflare 参与其中，仅仅是因为外部服务需要一个稳定的公共 URL 来交付传入的 webhook。

平台支持

实际决定您能否接收消息的是远程访问（设置 > 连接 > 设备与中继 > 专有中继）— 这是一个按设备独立设置的开关，默认关闭，且故意不在设备间同步（它是网络暴露设置，类似于开放端口）。为您希望响应消息的每台设备开启它；在不希望响应的设备上保持关闭。

  • macOS、Windows、Linux — 支持。在桌面应用中开启远程访问即可使其响应。
  • 浏览器扩展 (Chrome、Safari) — 支持，并且可以完全独立运行 — 无需桌面应用。在扩展自身的设置中开启远程访问，它即可直接连接并自行响应消息。
  • 如果您同时在桌面应用和扩展中开启了远程访问，桌面应用优先；扩展处于待命状态，作为桌面应用离线时的备用。
  • iOS 或 Android — 不支持。移动端应用不运行网关所依赖的专有中继客户端，因此无论远程访问状态如何，都无法在移动端接收或回复传入消息。

关于 Slack 的说明

Slack 不是消息网关的一部分。Slack 作为独立的 OAuth 包存在于 Community Hub 中 —— 请从那里安装。参见 Community Hub。

层级

消息网关是一项 Pro 功能。

另请参阅

This guide is maintained by the Caiioo team using Slate, our built-in editor.