Your AI Connector Docs

iMessage (测试版)

将 iMessage 接入您的统一收件箱。连接一台运行 BlueBubbles 的 Mac，您的 iMessage 就会像 WhatsApp、短信、Instagram 和 Messenger 一样流入平台——并使用您在其他地方已经使用的相同 AI 智能体、广播和联系人历史记录。

测试频道。 iMessage 支持目前仅限受邀使用，我们正在完善其体验。请联系支持团队以在您的账户上启用它。功能、限制和行为可能会随着频道的成熟而改变。

概览

Apple 不提供官方的 iMessage API（即允许其他应用程序直接连接到 iMessage 的规则集）。相反，此集成通过一个名为 BlueBubbles 的开源桥接应用程序进行连接，您需要在登录了 iMessage 账户的 Mac 上运行该程序。连接后，平台将：

  • 将收到的 iMessage 作为新对话接收到“聊天”中。
  • 通过您的 Mac 发送出站回复，因此它们在收件人看来就像来自您 Apple ID 的普通蓝色气泡 iMessage。
  • 让您的 AI 智能体、标签和联系人记录像在其他所有渠道上一样正常工作。

安装好 BlueBubbles 后，设置大约需要 10 分钟。

您需要准备什么

要连接 iMessage，您需要具备以下所有条件：

  • 一台 Mac（笔记本或台式机），登录了您的 Apple ID，并在“信息”应用中启用了 iMessage。
  • Mac 必须保持在线且处于唤醒状态。 如果您的 Mac 进入睡眠、重启或断开互联网连接，iMessage 将停止传输，直到它重新上线。
  • 在该 Mac 上安装 BlueBubbles Server — 这是一个免费的开源应用程序，可在 bluebubbles.app 获取。
  • 一种将您的 Mac 暴露给互联网的方法 — 通常是像 Cloudflare Tunnel、ngrok 或 Tailscale 这样的隧道。BlueBubbles 的设置向导将引导您完成此操作。
  • 付费套餐 — iMessage 已包含在所有当前套餐的渠道配额中。

设置 BlueBubbles

BlueBubbles 是一个独立的第三方应用程序，您可以将其安装在自己的 Mac 上。我们不托管它——它在您的机器上本地运行。

  1. 从 bluebubbles.app 下载并安装 BlueBubbles Server。
  2. 授予安装程序要求的权限（辅助功能、完全磁盘访问权限、自动化）。这些权限允许 BlueBubbles 读取传入的消息并触发“信息”应用发送传出的消息。
  3. 打开 BlueBubbles → Settings → API & Webhooks。
  4. 设置一个 server password（服务器密码）。
  5. 复制您的 server URL（指向您 Mac 的公共地址）。
  6. 在继续之前，请在 BlueBubbles 中验证传入和传出的测试消息是否在本地正常工作。

完整的设置说明、故障排除和特定平台的指南位于 官方 BlueBubbles 文档 中。如果您在使用 BlueBubbles 本身时遇到困难，他们的文档和社区是解决问题的最快途径。

将 BlueBubbles 连接到平台

一旦 BlueBubbles 在您的 Mac 上运行：

  1. 在左侧边栏中，点击底部的 Settings（设置）。
  2. 在“设置”左侧导航栏的 Channels（渠道）下方，点击 Channels（渠道）。
  3. 找到 iMessage 卡片并点击 Connect（连接）。（Connect 按钮仅在您的账户启用 iMessage 后才可点击——在此之前它呈灰色，且卡片会显示提示“iMessage is in private beta and isn’t enabled on your account yet.”）
  1. 粘贴您的 BlueBubbles Server URL（服务器 URL）（例如 https://your-tunnel.example.com）。
  2. 粘贴您的 BlueBubbles server password（服务器密码）。
  3. 点击 Connect（连接）。

我们会通过连接您的 BlueBubbles 服务器来验证连接，并自动配置 Webhook（Webhook 是一个网络地址，允许 BlueBubbles 在新消息到达时自动通知平台）。如果一切正常，状态将变为 Connected（已连接）。

  1. 在 BlueBubbles 中，打开 Settings → API & Webhooks → Webhooks，确认（或粘贴）iMessage 设置页面上显示的 Webhook URL。
  2. 保存。

设置完成——收到的 iMessage 现在将实时到达您的收件箱。

测试连接

在 iMessage 设置页面，您可以向任何电话号码发送测试 iMessage，以确认一切配置正确。请输入 E.164 格式的收件人电话号码（例如 +14155551234）以及一条简短消息，然后发送测试。

首次测试发送可能需要一分钟，因为您 Mac 上的“信息”应用可能需要开启一个新的对话线程。后续发送几乎是即时的。

消息流转方式

接收消息

  1. 有人向您的 Apple ID 发送 iMessage。
  2. 您 Mac 上的“信息”应用接收该消息（与正常情况一样）。
  3. BlueBubbles 检测到新消息，并将其 POST 到 Webhook URL。
  4. 平台会创建一个联系人（如果是新联系人），将消息放入“聊天”中，并且——如果该渠道的 AI 智能体处于活动状态——它会进行回复。

发送消息

  1. 您或 AI 从平台发送回复。
  2. 我们将消息发送到您的 BlueBubbles 服务器。
  3. BlueBubbles 通知您 Mac 上的“信息”应用发送该 iMessage。
  4. 收件人会看到一条来自您 Apple ID 的正常蓝色气泡 iMessage。

支持的消息类型

  • 文本消息 — 完全支持双向收发。
  • 附件和媒体 — 传入的附件在 BlueBubbles 中可见，但在 Beta 测试期间尚未被接入平台。外发消息必须包含文本 — 目前尚不支持通过 iMessage 发送图片或文件。

发送限制、预热与跟进控制

iMessage 具有与 WhatsApp Web 和 Telegram 相同的保护性发送限制、自动预热和后续跟进终止开关，但有一点值得注意：在 iMessage 上，新连接的账户默认开启自动跟进功能，因此如果您希望账户在预热期间保持静默，请自行将其关闭。Apple 会积极标记表现得像批量发送者的账户，因此这些防护措施旨在保护您的 Apple ID 安全。连接后，您可以在 iMessage 设置页面上找到“发送限制与预热”卡片和“自动跟进”开关。

自动预热（爬坡）

新连接的 iMessage 账户会被刻意限流，并随时间推移逐步解锁更多容量。只有在实际发送量达到当前上限 75% 的日子里，它才会获得一个“合格日”——闲置天数不计入在内。

  • 每日消息上限 = 50 + 8 × (day − 1)，上限为 500 条/天（在第 58 天达到）。
  • 每日新联系人上限 = floor((day − 1) × 5 / 6)，上限为 50 条/天（在第 61 天达到）。

设置页面会显示当前的爬坡天数、今日使用量与上限的对比，以及距离目标还有多远。如果您的 Apple ID 已经有长期的真实 iMessage 使用记录，您可以向前移动爬坡天数滑块——但请务必诚实操作，仅限确实拥有该历史记录的账户。

爬坡后的手动覆盖

在完成 58 天的完整爬坡后，通过可选的覆盖设置，您可以将每日消息上限推高至 500 以上（以 250 条消息为步长，最高可达 5,000 条）。请保持保守——Apple 并未公布安全数值，过度发送会危及您的 Apple ID。该覆盖功能仅在账户完全完成爬坡后可用。

发送限制开关与跟进终止开关

主开关用于启用或禁用发送限制，每日新联系人上限允许您将首次联系人数限制在低于预热阶段允许的水平。自动跟进开关会停止该账户的所有自动跟进，无论广播/营销活动设置如何。在 iMessage 上，此开关默认开启，因此新连接的账户会发送自动跟进消息，直到您将其关闭——建议在账户处于新状态（预热期 30 天以内）时将其关闭。当达到每日上限时，计划的跟进任务会被推迟到第二天，而不是直接失败。

iMessage Beta 版的局限性

由于 iMessage 没有官方 API，该渠道存在您在 WhatsApp、SMS 或 Instagram 上不会遇到的限制。在将 iMessage 用于业务关键型消息传递之前，请仔细阅读以下内容。

  • 您的 Mac 必须保持在线且处于唤醒状态。 没有 Mac 就没有 iMessage。我们建议禁用运行 BlueBubbles 的 Mac 的睡眠功能，或为此使用专用的 Mac mini。
  • 仅限一对一、电话号码对话。 Beta 期间不支持群聊和 Apple ID（电子邮件）句柄，如果它们进入平台可能会出现意外行为——请仅使用基于电话号码的一对一 iMessage 对话。
  • 仅限文本。 仅包含附件的消息（照片、视频、文件）在传入时会被跳过，且外发消息必须包含文本。发送媒体的功能将在 Beta 后期添加。
  • 无模板或预先批准的消息。 所有消息均为自由格式文本。
  • 平台 UI 中无送达或已读回执。 您仍然可以在 Mac 上的“信息”应用中看到它们。
  • “已发送”状态意味着已移交，而非已送达。 “已发送”状态表示平台已将消息移交给您的 Mac，并不代表接收者已收到。由于 iMessage 没有可靠的送达确认，即使在您的 Mac 无法确认送达时（例如接收者未使用 iMessage），某些发送也会被乐观地标记为“已发送”。要确认消息是否送达，请检查 Mac 上的“信息”应用。
  • 输入指示器需要 BlueBubbles 私有 API。 当 AI 正在撰写回复时，您的联系人会看到一个“正在输入……”气泡——但这仅在您启用了 BlueBubbles 中的 Private API 功能（设置 → Private API）时有效。如果没有启用，回复仍会正常发送，只是联系人看不到输入气泡。
  • 向新联系人发送的第一条消息可能会有延迟。 发起全新的对话可能需要 30–60 秒，因为 macOS 需要打开线程；后续消息则很快。
  • 不支持群发/广播式发送。 在 Beta 期间，iMessage 最适合用于传入对话和一对一回复，而不是高容量的外发广播。Apple 会严厉限制并标记自动化的 iMessage 流量。
  • 账户风险。 Apple 官方不认可第三方 iMessage 自动化。过度或垃圾邮件式的 iMessage 自动化使用可能导致您的 Apple ID 被 Apple 标记或限制。请负责任地使用该渠道。

故障排除

“无法连接到 BlueBubbles 服务器”

  • 确认 BlueBubbles 正在您的 Mac 上运行，并且显示绿色的 Server running 指示灯。
  • 确认您的隧道（Cloudflare / ngrok / Tailscale）已启动，并且您粘贴的 URL 可从公共互联网访问——在浏览器中打开它，您应该能看到 BlueBubbles 的欢迎页面。
  • 请仔细检查服务器密码是否与 BlueBubbles → Settings → API 中设置的密码一致。

收件箱中未显示收到的消息

  • 打开 BlueBubbles → Settings → API & Webhooks → Webhooks，确认我们向您展示的 Webhook URL 已按显示内容准确保存。
  • 在 iMessage 设置页面中，使用 Refresh status 来验证连接是否仍然健康。
  • 确保发送者的号码是电话号码，而不是电子邮件地址（Beta 版不支持电子邮件句柄）。
  • 确认您的 Mac 已连接互联网且处于唤醒状态。

发送消息失败

  • 直接在 Mac 上的“信息”应用中测试同一收件人。如果 Messages.app 也无法发送（例如收件人不在 iMessage 上），则该平台也无法发送。
  • 确保您的 Mac 没有进入睡眠状态、没有被 FileVault 锁定，也没有显示系统更新对话框——这些都会阻止 BlueBubbles 所依赖的 AppleScript 自动化。
  • 确认您的账户有足够的额度。

状态显示为“已连接”但无法正常工作

  • 在 iMessage 设置页面上使用 Refresh status 重新验证连接。
  • 如果仍然失败，请断开连接，然后使用新的服务器 URL 和密码重新连接。

我的 Mac 重启了 / 断开了互联网连接

当您的 Mac 恢复在线且 BlueBubbles 重新启动后，连接会自动恢复。在 Mac 离线期间发送给您的任何消息都会在重新连接后出现在“信息”应用中，但它们可能不会全部回传到该平台——iMessage 不提供可靠的补全 API。

需要帮助？

iMessage 目前处于 Beta 阶段。如果您遇到上述未涵盖的问题，请通过 hi@youraiconnector.com 联系我们，并提供：

  • 您连接的服务器 URL（不含密码）。
  • 问题描述以及 iMessage 设置页面中的任何错误消息。
  • 问题发生的时间。

我们会尽快查看。