选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据,以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用,但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意,AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容,包括相关广告。要接受或拒绝所有非必要 Cookie,请单击“接受”或“拒绝”。要做出更详细的选择,请单击“自定义”。

AWS 最终用户消息 SMS 事件数据示例

聚焦模式
AWS 最终用户消息 SMS 事件数据示例 - AWS 最终用户消息 SMS

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS 最终用户消息 SMS 可以流式传输有关短信、彩信和语音消息传送的事件数据。承运人生成的事件最多可能需要 72 小时才能接收,因此不应将其用于确定出站邮件传送是否存在延迟。72 小时后,如果 AWS 最终用户消息短信未收到运营商的最终事件,则该服务将自动返回 UNKNOWN,messageStatus因为我们不知道该消息发生了什么。

短信示例日志

短信事件的 JSON 对象包含以下示例中显示的数据。

{ "eventType": "TEXT_SUCCESSFUL", "eventVersion": "1.0", "eventTimestamp": 1686975103470, "isFinal": true, "originationPhoneNumber": "+12065550152", "destinationPhoneNumber": "+14255550156", "isoCountryCode": "US", "mcc": "310", "mnc": "800", "messageId": "862a8790-60c0-4430-9b2b-658bdexample", "messageRequestTimestamp": 1686975103170, "messageEncoding": "GSM", "messageType": "PROMOTIONAL", "messageStatus": "SUCCESSFUL", "messageStatusDescription": "Message has been accepted by phone carrier", "context": { "account": "bar" }, "totalMessageParts": 1, "totalMessagePrice": 0.09582, "totalCarrierFee": 0.0 }
属性 描述
eventType

事件类型。值列在 短信、彩信和语音的事件类型

eventVersion

事件 JSON 架构的版本。

eventTimestamp 报告事件的时间,显示为以毫秒为单位的 Unix 时间。
isFinal True如果这是消息的最终状态。有中间消息状态,最长可能需要 72 小时才能收到最终的消息状态。
originationPhoneNumber 用于发送消息的电话号码。
destinationPhoneNumber 尝试将消息发送到的电话号码。
isoCountryCode 与接收人的电话号码关联的国家,按 ISO 3166-1 alpha-2 格式显示。
mcc 移动国家/地区代码用于标识电话号码所属的国家/地区。此字段为可选字段,可能不存在。
mnc 移动网络代码用于标识移动网络运营商。此字段为可选字段,可能不存在。
messageId AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。
messageRequestTimestamp 接收 SMS 消息请求的时间,显示为 Unix 时间,以毫秒为单位。
messageEncoding 消息的编码。可能的值为 GSMUnicode。有关消息编码的更多信息,请参阅短信字符限制
messageType 消息类型。可能的值为 PromotionalTransactional
messageStatus

消息的状态。可能的值有:

  • 成功-留言已被电话运营商接受。

  • 已@@ 送达-消息已被收件人的设备接受。

  • PENDING – 消息尚未传送到接收人的设备。

  • INVALID – 目标电话号码无效。

  • UNREACHABLE – 接收人的设备当前无法访问或者不可用。例如,设备可能已关闭,或者可能断开与网络的连接。您可以稍后再次尝试发送消息。

  • UNKNOWN –出现错误,阻止了消息的传送。此错误通常是临时的,您可以稍后再次尝试发送消息。

  • 已屏蔽-收件人的设备正在屏蔽来自发件人电话号码的 SMS 消息。

  • CARRIER_UNREACHABLE – 接收人的移动网络出现问题,阻止了消息的传送。此错误通常是临时的,您可以稍后再次尝试发送消息。

  • SPAM – 接收人的移动运营商将消息内容标识为垃圾内容并阻止了消息的传送。

  • INVALID_MESSAGE – 短信的正文无效,无法传送。

  • CARRIER_BLOCKED – 接收人的运营商阻止了此消息的传送。当运营商确定消息的内容是未经请求内容或恶意内容时,通常会出现这种情况。

  • TTL_EXPIRED – 短信无法在特定时间范围内传送。此错误通常是临时的,您可以稍后再次尝试发送消息。

  • 已接受-短信已被接受。

  • 失败 — SMS 消息未能传送到收件人的设备。

  • 已@@ 发送-消息已发送但尚未传送到收件人的设备。

  • 无法路由 — 由于帐户配置不正确,无法路由。

  • 已排队-邮件已排队等候传送

messageStatusDescription 对消息状态的描述。
context 您可以指定并将在您发送消息时记录的自定义属性。
totalMessageParts

AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。

通常,短信只能包含 160 个 GSM-7 字符或 67 个非 GSM 字符,但这些限制会因国家而异。如果您发送的消息超过了这些限制,则 AWS 最终用户消息短信会自动将消息拆分为较小的部分。我们根据您发送的消息部分数量收取费用。有关消息部分的更多信息,请参阅每秒消息分数 (MPS) 的限制是多少

totalMessagePrice 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如,如果此属性的值为 645,则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = $0.00645)。
totalCarrierFee 一条消息的运营商费用总额。

语音示例事件日志

语音事件的 JSON 对象包含以下示例中显示的数据。

{ "eventType": "VOICE_COMPLETED", "eventVersion": "1.0", "eventTimestamp": 1697835373500, "isFinal": true, "originationPhoneNumber": "+12065550153", "destinationPhoneNumber": "+14255550159", "isoCountryCode": "US", "messageId": "567f6c11-6e8b-4352-9749-a42a0example", "messageRequestTimestamp": 1697835372720, "messageStatus": "COMPLETED", "callDurationInSeconds": 60, "totalDurationInMinutes": 1, "totalMessagePrice": 0.013, "context": { "account": "bar" } }
属性 描述
eventType

事件类型。值列在 短信、彩信和语音的事件类型

eventVersion

事件 JSON 架构的版本。

eventTimestamp 报告事件的时间,显示为以毫秒为单位的 Unix 时间。
isFinal True如果这是消息的最终状态。有中间的消息状态。
originationPhoneNumber 用于发送消息的电话号码。
destinationPhoneNumber 尝试将消息发送到的电话号码。
isoCountryCode 与接收人的电话号码关联的国家,按 ISO 3166-1 alpha-2 格式显示。
messageId AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。
messageRequestTimestamp 接收 SMS 消息请求的时间,显示为 Unix 时间,以毫秒为单位。
messageStatus

消息的状态。可能的值有:

  • 已启动 — 语音留言已准备好开始拨号。

  • RINGING — 响铃事件发生在拨打呼叫之后,但在接收者应答之前。

  • 已完成 — 将所有已完成的语音留言事件发送到指定目的地。向接收者播放音频消息时,就会发生已完成事件。此状态并不一定意味着消息已送达人类收件人。例如,它可能表示留言已传送到语音信箱系统。

  • 已回答 — 当收件人接听电话时,就会发生已应答事件。

  • 已完成-呼叫已应答并已结束。

  • 忙碌 — 当收件人的电话线占线时,就会发生忙碌事件。

  • NO_ANS WER — 拨打呼叫后不发生应答事件,但接收方(或其语音信箱系统)从不应答。

  • FAI LED — 当邮件无法传送时,就会发生失败事件。

  • TTL_EX PIRED — 当传送消息所需的时间超过您在发送消息时指定的TTL值时,就会发生 TTL 过期事件。

  • 垃圾邮件-呼叫被标记为垃圾邮件并被阻止。

callDurationInSeconds 通话时长(以秒为单位)。
totalDurationInMinutes 通话时长(以分钟为单位)。
totalMessagePrice 我们向您收取的发送语音留言的金额。此价格以千分之一美分显示。
context 您可以指定并将在您发送消息时记录的自定义属性。

彩信示例日志

彩信事件的 JSON 对象包含以下示例中显示的数据。

{ "contentType":"MMS", "eventType": "MEDIA_DELIVERED", "eventVersion": "1.0", "eventTimestamp": 1635197695208, "isFinal": true, "originationPhoneNumber": "+12065550153", "destinationPhoneNumber": "+14255550159", "isoCountryCode": "US", "messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example", "messageRequestTimestamp": 1635197693241, "messageType": "TRANSACTIONAL", "messageStatus": "DELIVERED", "messageStatusDescription": "Message has been accepted by phone", "context": {"foo":"bar"}, "totalMessageParts": 1, "totalMessagePrice": 0.0195, "totalCarrierFee": 0.00266 }
属性 描述
eventType

事件类型。值列在 短信、彩信和语音的事件类型

eventVersion

事件 JSON 架构的版本。

eventTimestamp 报告事件的时间,显示为以毫秒为单位的 Unix 时间。
isFinal True如果这是消息的最终状态。有中间消息状态,最长可能需要 72 小时才能收到最终的消息状态。
originationPhoneNumber 用于发送消息的电话号码。
destinationPhoneNumber 尝试将消息发送到的电话号码。
isoCountryCode 与接收人的电话号码关联的国家,按 ISO 3166-1 alpha-2 格式显示。
messageId AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。
messageRequestTimestamp 接收 SMS 消息请求的时间,显示为 Unix 时间,以毫秒为单位。
messageType 消息类型。可能的值为 PromotionalTransactional
messageStatus

消息的状态。可能的值有:

  • 成功-留言已被电话运营商接受。

  • 已@@ 送达-消息已被收件人的设备接受。

  • PENDING – 消息尚未传送到接收人的设备。

  • INVALID – 目标电话号码无效。

  • UNREACHABLE – 接收人的设备当前无法访问或者不可用。例如,设备可能已关闭,或者可能断开与网络的连接。您可以稍后再次尝试发送消息。

  • UNKNOWN –出现错误,阻止了消息的传送。此错误通常是临时的,您可以稍后再次尝试发送消息。

  • 已屏蔽-收件人的设备正在屏蔽来自发件人电话号码的短信/彩信。

  • CARRIER_UNREACHABLE – 接收人的移动网络出现问题,阻止了消息的传送。此错误通常是临时的,您可以稍后再次尝试发送消息。

  • SPAM – 接收人的移动运营商将消息内容标识为垃圾内容并阻止了消息的传送。

  • INVALID_MESSAGE — 短信 /彩信的正文无效,无法传送。

  • CARRIER_BLOCKED – 接收人的运营商阻止了此消息的传送。当运营商确定消息的内容是未经请求内容或恶意内容时,通常会出现这种情况。

  • TTL_EXPIRED – 短信无法在特定时间范围内传送。此错误通常是临时的,您可以稍后再次尝试发送消息。

  • 已接受-短信已被接受。

  • 失败 — 短信未能传送到收件人的设备。

  • 已@@ 发送-消息已发送但尚未传送到收件人的设备。

  • 无法路由 — 由于帐户配置不正确,无法路由。

  • 已排队-邮件已排队等候传送

messageStatusDescription 对消息状态的描述。
context 您可以指定并将在您发送消息时记录的自定义属性。
totalMessageParts

AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。有关消息部分的更多信息,请参阅每秒消息分数 (MPS) 的限制是多少

totalMessagePrice 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如,如果此属性的值为 645,则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = $0.00645)。
totalCarrierFee 一条消息的运营商费用总额。

本页内容

隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。