如何从网关获取短信已读或已送达状态

如果您经营着医疗诊所、培训学校或汽车维修店等本地服务型业务，了解客户是否真的看到了您的信息至关重要。在本教程中，我们将解释如何从短信网关获取短信的已读状态，阐明短信协议的技术限制，并向您展示如何为外发通知实现可靠的送达和已读跟踪。

第一步：理解“短信已送达”与“已读”状态的区别

在深入进行 API 集成之前，了解短信已送达与已读状态之间的技术区别至关重要。传统的短信技术建立在几十年前设计的蜂窝协议基础之上。在这种环境下，“用户可以使用 160 个字符或更少字符的快速状态更新进行交流。” 由于这种陈旧的基础设施，全球电信网络仅支持送达回执，而不支持打开或已读回执。

这与现代即时通讯应用（如 WhatsApp、iMessage 或 RCS）有很大不同，在这些应用中，“这种自由流畅的对话让您可以向任何人发送消息、图片和视频”，并带有原生的正在输入提示和蓝色“已读”对勾。标准的运营商短信没有原生的网络数据包来告知网关用户何时点击并打开了短信。

相反，我们依赖于您的网关服务商所映射的短信网关状态含义 (smsgate status meaning)。以下是这些状态在您的短信网关日志中通常代表的含义：

为了准确跟踪短信是否真的被阅读，企业通常结合使用运营商级别的送达报告和应用级别的智能跟踪链接，我们将在接下来的步骤中配置这些内容。

第二步：设置您的 Android 短信网关以检查短信送达状态

要开始跟踪您的短信，您需要一个原生提供送达报告的短信网关，而不是将其隐藏在昂贵的企业合同之后。像 Twilio 这样的传统网关需要复杂的 A2P 10DLC 注册、运营商审批，并收取高额的按条计费。对于小企业来说，一个更简单、更具成本效益的替代方案是 MySMSGate。

MySMSGate 将您自己的 Android 手机和 SIM 卡变成一个短信网关。由于您是从自己的本地手机号码发送短信，因此可以绕过运营商的注册限制，并且可以直接从您的控制面板或 API 轻松检查短信送达状态。

要设置您的网关并开始跟踪送达状态，请按照以下步骤操作：

1. 前往 MySMSGate 注册页面 并创建一个免费账户。
2. 在您的手机上下载并安装 MySMSGate Android 应用程序。
3. 使用移动应用扫描网页控制面板上显示的二维码，即可立即绑定您的手机。无需手动输入任何 API 密钥。
4. 从网页控制面板发送一条测试短信。

短信发送后，您的 Android 手机将实时将运营商级别的送达报告返回给您的 MySMSGate 控制面板。如果短信发送失败，MySMSGate 会自动退还您的余额，从而保护您的运营成本。

第三步：配置 Android 短信网关送达报告状态回调 Webhook

对于将短信通知集成到自己的 CRM、预订引擎或定制软件中的开发人员来说，通过轮询 API 端点来检查送达状态是低效的。相反，您应该使用 Webhook 配置 android-sms-gateway 送达报告状态回调。

本节介绍如何从 API Webhook 配置中获取短信送达状态。当您连接的 Android 手机将短信送送到收件人的手机时，它会收到来自本地运营商的内部送达报告。MySMSGate 会捕获此事件，并立即将状态更新发送到您的服务器。

以下是如何在 Python Flask 应用程序中处理 android-sms-gateway 送达报告状态回调短信 负载的示例：

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhooks/sms-status', methods=['POST'])
def handle_sms_status_callback():
    data = request.json
    
    # Extract key parameters from the MySMSGate webhook payload
    message_id = data.get('message_id')
    status = data.get('status')  # e.g., 'delivered', 'failed', 'sent'
    recipient = data.get('to')
    error_code = data.get('error_code')
    
    print(f"Message {message_id} to {recipient} updated to status: {status}")
    
    if status == 'delivered':
        # Update your database to mark notification as delivered
        # update_booking_notification_status(message_id, 'Delivered')
        pass
    elif status == 'failed':
        # Handle failed delivery (e.g., alert staff, retry via alternative channel)
        # log_failed_delivery(message_id, error_code)
        pass
        
    return jsonify({"status": "success"}), 200

if __name__ == '__main__':
    app.run(port=5000)

通过实现此回调，您的后端应用程序将始终与外发短信的实时状态保持同步，从而使您能够针对失败的送达构建自动化的跟进工作流。

第四步：使用智能链接跟踪来追踪实际的“已读”状态

由于标准短信协议不支持原生的“已读”回执，聪明的服务型企业实际上是如何跟踪客户是否打开并阅读了他们的短信呢？行业标准的解决方案是智能链接跟踪 (Smart Link Tracking)。

与其发送纯文本短信，不如在短信中包含一个唯一的、缩短的跟踪链接。当收件人点击该链接时，他们会先经过您的跟踪服务器进行简短路由，然后再重定向到他们的目的地（例如发票、预订确认或预约详情页面）。这种重定向在毫秒内完成，并起到“已读回执”的作用。

以下是实现此方案的分步工作流程：

1. 生成唯一 Token： 对于您发送的每条短信，生成一个简短且唯一的标识符（例如 myshop.co/r/x89D2）。
2. 在数据库中映射该 Token： 将 x89D2 与收件人的手机号码、发送的具体短信以及初始化为 False 的“已读”状态相关联。
3. 发送短信： 通过 MySMSGate API 或控制面板发送包含该短链接的短信。
4. 记录重定向： 当用户点击链接时，您的服务器会记录对 x89D2 的传入请求，将数据库记录更新为 Read = True 并记录时间戳，然后立即将用户重定向到实际的落地页。

这种方法可以为您提供 100% 准确的已读跟踪，并提供关于用户参与度的宝贵数据，从而帮助您优化沟通模板。

第五步：对比不同网关的短信状态跟踪

在为您的业务选择平台时，了解不同网关如何处理送达跟踪、定价和系统复杂度会很有帮助。虽然许多开发人员在寻找 twilio 短信送达状态回调教程 (twilio sms delivery status callback tutorial)，但他们往往会发现，为了基本的本地通知而设置和维护 Twilio 的云基础设施过于复杂且昂贵。

以下是 MySMSGate 与传统云网关在跟踪能力和功能方面的直接对比：

对于在美国境外运营的本地服务型企业， MySMSGate 提供了一种更为实用的方法。您可以在我们关于 Twilio 替代方案对比 的综合指南中阅读更多关于其他选择的信息，或者查看我们的 最便宜的短信 API 指南 以优化您的沟通预算。

常见问题解答

以下是关于短信送达和已读状态跟踪的最常见问题的解答。

你能看到短信是否已被阅读或打开吗？

不能，标准的蜂窝短信协议不支持原生的已读回执。要跟踪短信是否已被阅读，您必须在短信正文中包含一个唯一的、缩短的跟踪链接，并监控收件人何时点击该链接。

已送达和已读状态之间有什么区别？

已送达状态意味着运营商网络已成功将短信传输到收件人的手机。已读状态意味着用户主动打开并查看了该短信。标准短信仅跟踪送达情况；需要应用级别的跟踪链接来跟踪已读状态。

如何使用 MySMSGate 获取实时送达报告？

MySMSGate 将送达报告直接从您 Android 手机的运营商网络转发回您的账户。您可以在网页控制面板上实时查看这些送达状态，或者配置状态回调 Webhook 以在您的服务器上接收即时 POST 请求。

我需要运营商审批或 10DLC 注册来跟踪送达状态吗？

不需要。当您使用 MySMSGate 时，您是通过自己的 Android 手机和 SIM 卡发送短信。因为您使用的是您自己的个人或商业移动线路，所以您不需要 10DLC 注册、品牌验证或运营商审批来发送和跟踪您的短信。