Your AI Connector Docs

将 Android 手机用作短信网关（Beta 版）

使用您自己的 Android 手机作为短信发送端。无需连接 Twilio 账户，您只需在 Android 手机上安装一个小型开源应用，将其与您的工作区配对，即可通过该手机的号码和运营商套餐发送和接收短信。

Beta 渠道。 Android 短信网关现已向所有拥有渠道配额套餐的用户开放，但它仍处于初期阶段——可能会偶尔出现一些小问题，且请注意，随着该渠道的成熟，其行为和限制可能会发生变化。如果发现功能与描述不符，请告知支持团队。

为什么要使用此功能

Android 网关专为低频、对话式短信而设计——例如回复潜在客户、AI 对话和一对一短信。在以下情况下，它是一个不错的选择：

  • 您希望继续使用现有的个人或企业号码进行短信沟通。
  • 对于您所在的国家/地区或业务量，Twilio 的成本过高或定价不合理。
  • 您更愿意使用运营商现有的短信套餐，而不是支付按条计费的费用。
  • 您希望避免 Twilio 所要求的繁琐的运营商注册文书工作（如 A2P 10DLC 等）。

它不适用于大规模群发广播——请参阅下方的限制。

大规模和高可靠性场景请优先选择 Twilio。 如果您的发送量较大、需要保证正常运行时间或进行大规模短信广播，请改用 Twilio 号码——请参阅短信消息。两者是不同的短信传输方式；无论使用哪种方式，消息、联系人、AI 和收件箱的功能都是一样的。

您需要准备什么

  • 一部 Android 手机，配有有效的 SIM 卡和短信套餐（强烈建议使用无限量或大流量短信套餐）。
  • 免费的开源“SMS Gateway for Android”应用，可从 sms-gate.app 获取——您可以从该网站或其 GitHub 发布页面下载。我们不开发此应用，它是一个第三方项目。
  • 手机需保持开机、联网且不受限制——请参阅保持手机连接可靠性。
  • 付费套餐——Android 网关已包含在您的渠道配额中。

平台不收取按条计费的费用，也没有 Twilio 账单——您使用的是手机自身的运营商套餐。如果 AI 生成了回复，该回复仍会消耗 AI 点数，这与所有其他渠道一致。

设置网关应用

  1. 在您想要使用的手机上，从 sms-gate.app 安装 SMS Gateway for Android。
  2. 打开应用。
  3. 开启 Cloud Server（云服务器） 模式（这是最简单的选项——它通过项目的托管服务器进行中继，因此您的手机无需拥有公网地址）。
  4. 应用会在主屏幕上生成一个用户名和密码。您将在下一节中把这些信息粘贴到平台中。
  5. （推荐）在应用中，打开 Settings（设置） → Webhooks。Webhook 是应用在发生特定事件（此处指收到消息时）自动发送给平台的通知。
  6. 复制 Signing Key（签名密钥）。将其粘贴到平台中可为传入的消息增加额外的签名校验。

本地模式（高级）。 如果您希望手机直接通过您的网络与平台通信，而不是通过云中继，该应用也支持本地服务器模式。您需要将手机暴露在可访问的 HTTPS 地址上，并在连接时将该地址输入为基础 URL。对于绝大多数用户，推荐使用云模式。

将手机连接到平台

  1. 在左侧边栏中，点击底部的 Settings（设置）。
  2. 在“设置”左侧导航栏的 Channels（频道）下方，点击 Channels（频道）。
  3. 找到 Android SMS Gateway（Android 短信网关）卡片并点击 Connect（连接）。
  4. 输入 Phone number（电话号码）——即手机本身的号码，需使用国际 (E.164) 格式，例如 +14155551234。
  5. 输入网关应用主屏幕上的 Gateway username（网关用户名）和 Gateway password（网关密码）。
  6. （可选）粘贴来自应用 Webhooks 设置中的 Webhook signing key（Webhook 签名密钥）（推荐）。
  7. 点击 Connect（连接）。

平台会验证凭据，为您在网关上注册消息和送达 Webhook，并将状态切换为 Connected（已连接）。无需手动复制粘贴 Webhook URL 到应用中——注册是自动完成的。

检查状态

连接后，卡片上的按钮会从 Connect（连接）变为 Manage（管理）。点击它可重新打开网关面板，您可以在其中随时点击 Refresh status（刷新状态）。它会重新检查网关是否可达，并显示手机当前是否 online（在线）。如果手机处于休眠或离线状态，您将看到清晰的离线指示，以便您知道在手机恢复在线之前短信无法发送。

断开连接

点击卡片上的 Manage（管理）重新打开网关面板，然后点击 Disconnect（断开连接）。平台会移除其在网关上注册的 Webhook 并清除连接。此后，如果您连接了 Twilio 短信号码，短信将回退至通过 Twilio 发送；如果没有连接，则短信功能将关闭。

消息流转方式

接收消息

  1. 有人向您的手机号码发送短信。
  2. 手机上的网关应用检测到短信并通知平台。
  3. 平台创建联系人（如果是新联系人），将消息放入您的收件箱，并且——如果相关的 AI 智能体处于活动状态——它会进行回复。

发送消息

  1. 您或 AI 从平台发送回复。
  2. 平台将消息交给您的网关。
  3. 手机通过您的运营商，以普通短信的形式从您的号码发送该消息。
  4. 当运营商反馈报告时，消息状态会更新为 Sent（已发送），然后是 Delivered（已送达）或 Failed（失败）。

Android 网关具有发送优先级。 当它处于连接状态时，一对一消息和 AI 回复将通过您的手机发送。如果您还连接了 Twilio 短信号码，请断开 Android 网关的连接，以便再次通过 Twilio 发送这些消息。无论哪种情况，都有一个例外：营销和广播短信群发始终通过您的 Twilio 号码发送，绝不会通过 Android 手机发送——使用个人手机进行批量发送正是导致号码被标记的原因，因此本平台不会执行此操作。

限制

Android 网关依赖于您控制的物理手机，因此它带有 Twilio 所没有的限制。在依赖它进行重要消息传递之前，请查看以下内容。

  • 手机必须保持开机且在线。 没有手机就没有短信。请保持手机充电、连接 Wi-Fi 或数据网络，并将其从电池优化中排除。
  • 仅限低容量使用。 运营商会标记并限速那些突然发送大量短信的手机。此渠道仅用于对话和一对一回复——而非群发广播。
  • 此渠道不支持短信群发。 大规模短信发送需要连接 Twilio 号码；如果您在没有 Twilio 的情况下尝试启动群发，平台会提示您。请通过 Twilio 进行广播，并将 Android 网关保留用于对话式回复。
  • 仅限文本。 此渠道不支持发送和接收彩信（媒体）。
  • 适用运营商限制。 您手机套餐的短信额度、公平使用上限以及任何按条收费的费用均由您与运营商之间决定。
  • 送达确认取决于您的运营商。 有些运营商能可靠地报告送达情况，有些则不能。“已发送”状态表示手机已发出短信。
  • 账户/号码风险。 将个人号码用于自动化的商业短信可能会违反运营商条款，如果滥用，可能会导致号码被限速或停用。请负责任地使用，获取用户同意，并包含退订说明。

保持手机可靠

为了保持消息不间断地发送：

  • 禁用电池优化：针对 SMS Gateway 应用（Android 设置 → 应用 → SMS Gateway → 电池 → 不受限制）。否则 Android 可能会在后台终止该应用。
  • 保持屏幕可访问 / 允许应用在后台运行。最好使用一台专门连接电源的手机。
  • 保持稳定的 Wi-Fi 或数据连接。如果手机失去连接，发送队列将暂停或失败，直到恢复连接。
  • 保持 SIM 卡处于活跃状态且运营商账户状态良好。

故障排除

“无法验证网关凭据”

  • 请根据网关应用主屏幕上的信息重新检查用户名和密码——如果您重新安装或重置了应用，它们会重新生成。
  • 确认手机已连接互联网，并且应用中已开启云服务器模式。

状态显示离线 / 短信无法发送

  • 在手机上打开应用，确认其正在运行并显示已连接到云服务器。
  • 检查手机是否处于“打盹模式”/省电模式，并确保该应用已排除在电池优化之外。
  • 在手机恢复在线后，点击卡片上的刷新状态。

接收到的短信未显示

  • 确认连接状态仍显示为已连接（点击刷新状态）。
  • 从另一部手机向该手机号码发送一条测试短信。
  • 确保手机的默认短信应用没有拦截或过滤发送方。

短信显示“失败”

  • 运营商拒绝了该短信——请检查收件人号码是否有效且为国际格式。
  • 确认您的 SIM 卡仍有短信额度，且号码未被停机。
  • 发送频率过高可能会触发运营商的限流机制；请降低发送速度并保持较低的发送量。

需要帮助？

Android 短信网关目前处于 Beta 测试阶段。如果您遇到此处未涵盖的问题，请联系 hi@youraiconnector.com 并提供以下信息：

  • 您连接的手机号码（非密码）。
  • 网关应用在手机上是否显示为在线。
  • 问题描述及发生时间。

我们会尽快查看。