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

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

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

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

支持的服务

在 设置 > 消息 中连接以下任何服务：

  • WhatsApp Business —— 稳定
  • Telegram —— 稳定
  • Messenger (beta)
  • iMessage (beta)
  • Signal (beta)
  • Viber (beta)
  • Beeper (beta)

WhatsApp Business 和 Telegram 已稳定。其余处于 beta 阶段 —— 完全可用，仍在持续强化中。

设置

  1. 前往 设置 > 消息（消息网关）。
  2. 选择一个服务。
  3. 输入该提供商的标准机器人或商业凭据 —— 即您在该平台上进行任何集成时使用的相同令牌或商业账户。
  4. Caiioo 注册入站路由并开始监听。

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

逐对话交互模式

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

自动 (绿色)

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

介入 (蓝色)

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

聊天 (琥珀色)

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

双向媒体传输

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

隐私与架构

所有消息处理都在您的本地桌面服务器上完成。代理在您的机器上运行；对话、凭据和媒体都在那里处理 —— 而不是在云端。

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

平台支持

消息网关运行在您的桌面应用或服务器上 —— 这是入站 Webhook 中继和消息处理所在的位置：

  • macOS —— 已支持
  • Windows —— 已支持
  • Linux —— 已支持

浏览器扩展程序 (Chrome, Safari) 也可以使用网关，只要它连接到您的桌面应用 —— 桌面服务器会代表它进行实际的接收和处理。

它不适用于 iOS 或 Android。移动应用不运行网关所依赖的 Webhook 中继或本地处理，因此无法在移动端接收或回答传入的消息。

关于 Slack 的说明

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

层级

消息网关是一项 Pro 功能。

另请参阅

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