# 将 Android 手机用作短信网关（Beta 版） 使用您自己的 Android 手机作为短信发送端。无需连接 Twilio 账户，您只需在 Android 手机上安装一个小型开源应用，将其与您的工作区配对，即可通过该手机的号码和运营商套餐发送和接收短信。 > **Beta 渠道。** Android 短信网关现已向所有拥有渠道配额套餐的用户开放，但它仍处于初期阶段——可能会偶尔出现一些小问题，且请注意，随着该渠道的成熟，其行为和限制可能会发生变化。如果发现功能与描述不符，请告知支持团队。 --- ## 为什么要使用此功能 Android 网关专为**低频、对话式短信**而设计——例如回复潜在客户、AI 对话和一对一短信。在以下情况下，它是一个不错的选择： - 您希望继续使用**现有的个人或企业号码**进行短信沟通。 - 对于您所在的国家/地区或业务量，Twilio 的**成本过高或定价不合理**。 - 您更愿意使用**运营商现有的短信套餐**，而不是支付按条计费的费用。 - 您希望**避免** Twilio 所要求的繁琐的**运营商注册**文书工作（如 A2P 10DLC 等）。 它**不**适用于大规模群发广播——请参阅下方的[限制](#limitations)。 > **大规模和高可靠性场景请优先选择 Twilio。** 如果您的发送量较大、需要保证正常运行时间或进行大规模短信广播，请改用 Twilio 号码——请参阅[短信消息](sms.md)。两者是不同的短信传输方式；无论使用哪种方式，消息、联系人、AI 和收件箱的功能都是一样的。 --- ## 您需要准备什么 - **一部 Android 手机**，配有有效的 SIM 卡和短信套餐（强烈建议使用无限量或大流量短信套餐）。 - **免费的开源“SMS Gateway for Android”应用**，可从 [sms-gate.app](https://sms-gate.app) 获取——您可以从该网站或其 [GitHub 发布页面](https://github.com/capcom6/android-sms-gateway/releases/latest)下载。我们不开发此应用，它是一个第三方项目。 - **手机需保持开机、联网且不受限制**——请参阅[保持手机连接可靠性](#keeping-the-phone-reliable)。 - **付费套餐**——Android 网关已包含在您的渠道配额中。 平台**不收取按条计费的费用**，也没有 Twilio 账单——您使用的是手机自身的运营商套餐。如果 AI 生成了回复，该回复仍会消耗 AI 点数，这与所有其他渠道一致。 --- ## 设置网关应用 1. 在您想要使用的手机上，从 [sms-gate.app](https://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 并提供以下信息： - 您连接的手机号码（非密码）。 - 网关应用在手机上是否显示为在线。 - 问题描述及发生时间。 我们会尽快查看。