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

消息网关：让 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 阶段——完全可用，仍在加固中。

设置

为此设备开启 远程访问，位于 Settings > Connectivity > Connections > Private Relay。这才是真正将设备连接到接收入站消息的中继的桥梁——没有它，无论下面如何配置服务，都不会收到任何东西。它默认关闭且按设备配置（见下文平台支持）。
前往 Settings > Connectivity > Messaging Gateway。
选择一项服务。
输入该提供商的标准机器人或商务凭据——您在该平台上任何集成都会使用的相同令牌或商务账户。
Caiioo 注册入站路由。如果远程访问尚未在任何地方开启，Settings > Connectivity > Messaging Gateway 会提示您并让您直接在那里开启它。

您只需为每项服务配置一次。之后，无论连接了多少服务，代理都会看到单个消息传递能力。

逐对话交互模式

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

自动 (绿色)

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

介入 (蓝色)

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

聊天 (琥珀色)

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

双向媒体传输

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

隐私与架构

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

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

平台支持

真正决定您是否收到消息的是 远程访问（Settings > Connectivity > Connections > Private Relay）——一个按设备切换的开关，默认关闭，故意不在您的设备之间同步（这是一个网络暴露设置，类似于打开一个端口）。为您想要回答消息的每个设备打开它；在您不想回答的设备上保持关闭。

macOS、Windows、Linux — 支持。在桌面应用中打开远程访问以使其回答。
浏览器扩展程序（Chrome、Safari） — 支持，并且完全独立运行——无需桌面应用。在扩展程序自身的设置中打开远程访问，它就会直接连接并自行回答消息。
如果您同时拥有桌面应用和开启了远程访问的扩展程序，桌面应用优先；扩展程序保持待机状态作为备用，以防桌面应用离线。
iOS 或 Android — 不可用。移动应用不运行网关依赖的私密中继客户端，因此无论远程访问如何配置，都无法在那里接收或回答传入的消息。

关于 Slack 的说明

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

层级

消息网关是一项 Pro 功能。

另请参阅

工具与集成 —— 代理作为工具可以执行的所有操作，包括消息传递
Community Hub —— 从 Community Hub 安装 Slack 和其他软件包
隐私与数据 —— 您的数据如何存储和处理
平台与设置 —— 哪些功能在哪个平台上运行

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