Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Beispiel AWS SMS-Ereignisdaten für Endbenutzer-Nachrichten
AWS End User Messaging SMS kann Ereignisdaten für SMS-, MMS- und Sprachnachrichtenzustellungen streamen. Da es bis zu 72 Stunden dauern kann, bis von Mobilfunkanbietern generierte Ereignisse empfangen werden, sollten Sie diese nicht verwenden, um festzustellen, ob es bei der Zustellung ausgehender Nachrichten zu Verzögerungen kommt. Wenn die AWS Endbenutzer-Nachrichten-SMS nach 72 Stunden kein letztes Ereignis von einem Mobilfunkanbieter erhalten hat, gibt der Dienst automatisch eine Meldung zurück, UNKNOWN messageStatus da wir nicht wissen, was mit der Nachricht passiert ist.
Beispiele
SMS-Beispielprotokoll
Das JSON-Objekt für ein SMS-Ereignis enthält die Daten wie im folgenden Beispiel.
{ "eventType": "TEXT_SUCCESSFUL", "eventVersion": "1.0", "eventTimestamp": 1686975103470, "isFinal": true, "originationPhoneNumber": "+12065550152", "destinationPhoneNumber": "+14255550156", "isInternationalSend": false, "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 }
| Attribut | Description |
|---|---|
eventType |
Der Ereignistyp. Die Werte sind aufgeführt in Ereignistypen für SMS, MMS und Sprache |
eventVersion |
Die Version des Ereignis-JSON-Schemas. |
eventTimestamp |
Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
isFinal |
Truewenn dies der endgültige Status der Nachricht ist. Es gibt Zwischenstatus für Nachrichten, und es kann bis zu 72 Stunden dauern, bis der endgültige Nachrichtenstatus eingeht. |
originationPhoneNumber |
Die Telefonnummer oder RCS-Agenten-ID, von der die Nachricht gesendet wurde. Bei SMS- und MMS-Nachrichten ist dieser Wert eine E.164 Telefonnummer oder ein Kurzcode. Bei RCS-Nachrichten, die nativ über RCS übermittelt werden, ist dieser Wert die RCS-Agenten-ID. Bei RCS-Nachrichten, die auf SMS zurückgingen, ist dieser Wert die E.164 Telefonnummer oder der Kurzcode, der für die SMS-Zustellung verwendet wird. Wenn Sie Nachrichten mithilfe der Amazon Pinpoint SendMessages Pinpoint-API senden, lautet das entsprechende Feld im ZustellereignisoriginationNumber. |
destinationPhoneNumber |
Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
isInternationalSend |
Truewenn internationale Nachrichtenübermittlung für diese Telefonnummer aktiviert ist. |
isoCountryCode |
Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
mcc |
Mobile Country Codes identifiziert das Land, zu dem eine Telefonnummer gehört. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
mnc |
Mobile Network Codes identifiziert einen Mobilfunknetzbetreiber. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
messageId |
Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
messageRequestTimestamp |
Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
messageEncoding |
Die Kodierung der Nachricht. Mögliche Werte sind GSM und Unicode. Weitere Hinweise zur Nachrichtenkodierung finden Sie unterSMS-Zeichenbeschränkungen. |
messageType |
Der Nachrichtentyp. Mögliche Werte sind Promotional und Transactional. |
messageStatus |
Der Status der Nachricht. Die möglichen Werte sind:
|
messageStatusDescription |
Eine Beschreibung des Nachrichtenstatus. |
context |
Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
totalMessageParts |
Die Anzahl der Nachrichtenteile, die AWS End User Messaging SMS zum Senden der Nachricht erstellt hat. Im Allgemeinen können SMS-Nachrichten nur 160 GSM-7 Zeichen oder 67 Zeichen enthalten, die keine GSM-Zeichen sind. Diese Beschränkungen können jedoch je nach Land variieren. Wenn Sie eine Nachricht senden, die diese Grenzwerte überschreitet, teilt AWS End User Messaging SMS die Nachricht automatisch in kleinere Teile auf. Wir erstellen Rechnungen basierend auf der Anzahl der Mitteilungsteile, die Sie senden. Weitere Informationen zu Teilen von Nachrichten finden Sie unterWas sind die MPS-Grenzwerte (Message Parts per Second)?. |
totalMessagePrice |
Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 $). |
totalCarrierFee |
Die Gesamtkosten der Transporteurgebühren für eine Nachricht. |
Beispielprotokoll für SMS Protect
Das JSON-Objekt für ein SMS-Ereignis bei Verwendung von SMS Protect enthält die im folgenden Beispiel gezeigten Daten.
{ "eventType": "TEXT_PROTECT_BLOCKED", "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": "PROTECT_BLOCKED", "messageStatusDescription": "Message blocked by protect configuration", "context": { "account": "bar" }, "totalMessageParts": 1, "totalMessagePrice": 0, "totalCarrierFee": 0, "protectConfiguration": { "protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479", "protectStatus": "FILTER" }, "protectConfigurationAssessment": { "protectRecommendation": "BLOCK" "protectInsights": { "blockReason": "AIT_SUSPECTED" } } }
| Attribut | Description |
|---|---|
eventType |
Der Ereignistyp. Die Werte sind aufgeführt in Ereignistypen für SMS, MMS und Sprache |
eventVersion |
Die Version des Ereignis-JSON-Schemas. |
eventTimestamp |
Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
isFinal |
Truewenn dies der endgültige Status der Nachricht ist. Es gibt Zwischenstatus für Nachrichten, und es kann bis zu 72 Stunden dauern, bis der endgültige Nachrichtenstatus eingeht. |
originationPhoneNumber |
Die Telefonnummer, von der die Nachricht gesendet wurde. |
destinationPhoneNumber |
Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
isoCountryCode |
Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
mcc |
Mobile Country Codes identifizieren das Land, zu dem eine Telefonnummer gehört. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
mnc |
Mobile Network Codes identifiziert einen Mobilfunknetzbetreiber. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
messageId |
Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
messageRequestTimestamp |
Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
messageEncoding |
Die Kodierung der Nachricht. Mögliche Werte sind GSM und Unicode. Weitere Hinweise zur Nachrichtenkodierung finden Sie unterSMS-Zeichenbeschränkungen. |
messageType |
Der Nachrichtentyp. Mögliche Werte sind Promotional und Transactional. |
messageStatus |
Der Status der Nachricht. Die möglichen Werte sind:
|
messageStatusDescription |
Eine Beschreibung des Nachrichtenstatus. |
context |
Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
totalMessageParts |
Die Anzahl der Nachrichtenteile, die AWS End User Messaging SMS zum Senden der Nachricht erstellt hat. Im Allgemeinen können SMS-Nachrichten nur 160 GSM-7 Zeichen oder 67 Zeichen enthalten, die keine GSM-Zeichen sind. Diese Beschränkungen können jedoch je nach Land variieren. Wenn Sie eine Nachricht senden, die diese Grenzwerte überschreitet, teilt AWS End User Messaging SMS die Nachricht automatisch in kleinere Teile auf. Wir erstellen Rechnungen basierend auf der Anzahl der Mitteilungsteile, die Sie senden. Weitere Informationen zu Teilen von Nachrichten finden Sie unterWas sind die MPS-Grenzwerte (Message Parts per Second)?. |
totalMessagePrice |
Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 $). |
totalCarrierFee |
Die Gesamtkosten der Transporteurgebühren für eine Nachricht. |
protectConfiguration |
Die ID der Schutzkonfiguration, die beim Senden der Nachricht verwendet wurde, und der Status, in dem sich das Zielland zu diesem Zeitpunkt befand. Weitere Informationen zu SMS Protect finden Sie unter SMS Protect. |
protectConfigurationAssessment |
Eine Bewertung, ob SMS Protect der Meinung ist, dass Ihre Nachricht erlaubt oder nicht gesendet werden sollte, und die Gründe für die Sperrung, sofern verfügbar. |
Beispiel für eine Sprachausgabe, ein Ereignisprotokoll
Das JSON-Objekt für ein Voice-Ereignis enthält die im folgenden Beispiel gezeigten Daten.
{ "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" } }
| Attribut | Description |
|---|---|
eventType |
Der Ereignistyp. Die Werte sind aufgeführt in Ereignistypen für SMS, MMS und Sprache |
eventVersion |
Die Version des Ereignis-JSON-Schemas. |
eventTimestamp |
Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
isFinal |
Truewenn dies der endgültige Status der Nachricht ist. Es gibt zwischengeschaltete Nachrichtenstatus. |
originationPhoneNumber |
Die Telefonnummer, von der die Nachricht gesendet wurde. |
destinationPhoneNumber |
Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
isoCountryCode |
Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
messageId |
Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
messageRequestTimestamp |
Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
messageStatus |
Der Status der Nachricht. Die möglichen Werte sind:
|
callDurationInSeconds |
Die Dauer des Anrufs in Sekunden. |
totalDurationInMinutes |
Die Dauer des Anrufs in Minuten. |
totalMessagePrice |
Der Betrag, den wir Ihnen für das Senden der Sprachnachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. |
context |
Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
MMS-Beispielprotokoll
Das JSON-Objekt für ein MMS-Ereignis enthält die im folgenden Beispiel gezeigten Daten.
{ "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 }
| Attribut | Description |
|---|---|
eventType |
Der Ereignistyp. Die Werte sind aufgeführt in Ereignistypen für SMS, MMS und Sprache |
eventVersion |
Die Version des Ereignis-JSON-Schemas. |
eventTimestamp |
Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
isFinal |
Truewenn dies der endgültige Status der Nachricht ist. Es gibt Zwischenstatus für Nachrichten, und es kann bis zu 72 Stunden dauern, bis der endgültige Nachrichtenstatus eingeht. |
originationPhoneNumber |
Die Telefonnummer, von der die Nachricht gesendet wurde. |
destinationPhoneNumber |
Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
isoCountryCode |
Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
messageId |
Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
messageRequestTimestamp |
Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
messageType |
Der Nachrichtentyp. Mögliche Werte sind Promotional und Transactional. |
messageStatus |
Der Status der Nachricht. Die möglichen Werte sind:
|
messageStatusDescription |
Eine Beschreibung des Nachrichtenstatus. |
context |
Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
totalMessageParts |
Die Anzahl der Nachrichtenteile, die AWS End User Messaging SMS zum Senden der Nachricht erstellt hat. Weitere Informationen zu Nachrichtenteilen finden Sie unterWas sind die MPS-Grenzwerte (Message Parts per Second)?. |
totalMessagePrice |
Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 $). |
totalCarrierFee |
Die Gesamtkosten der Transporteurgebühren für eine Nachricht. |
RCS-Beispielprotokoll
Das JSON-Objekt für ein RCS-Ereignis enthält die in den folgenden Beispielen gezeigten Daten. Das originationPhoneNumber Feld unterscheidet sich je nachdem, ob die Nachricht nativ über RCS zugestellt wurde oder auf SMS zurückgegriffen wurde.
RCS-native Zustellung — Das originationPhoneNumber Feld enthält die RCS-Agenten-ID:
{ "eventType": "TEXT_SUCCESSFUL", "eventVersion": "1.0", "eventTimestamp": 1714000000000, "isFinal": true, "originationPhoneNumber": "rcs-agent-id-example", "destinationPhoneNumber": "+14255550156", "isInternationalSend": false, "messageId": "a1b2c3d4-e5f6-7890-abcd-ef1234example", "messageRequestTimestamp": 1714000000000, "messageType": "TRANSACTIONAL", "messageStatus": "SUCCESSFUL", "messageStatusDescription": "Message has been accepted by phone carrier", "totalMessageParts": 1, "totalMessagePrice": 0.003, "totalCarrierFee": 0.0 }
SMS-Ersatzzustellung — Das originationPhoneNumber Feld enthält die E.164 Telefonnummer oder den Kurzcode, der für die SMS-Zustellung verwendet wird:
{ "eventType": "TEXT_SUCCESSFUL", "eventVersion": "1.0", "eventTimestamp": 1714000000000, "isFinal": true, "originationPhoneNumber": "+12065550152", "destinationPhoneNumber": "+14255550156", "isInternationalSend": false, "messageId": "b2c3d4e5-f6a7-8901-bcde-f12345example", "messageRequestTimestamp": 1714000000000, "messageType": "TRANSACTIONAL", "messageStatus": "SUCCESSFUL", "messageStatusDescription": "Message has been accepted by phone carrier", "totalMessageParts": 1, "totalMessagePrice": 0.00645, "totalCarrierFee": 0.0 }
Untersuchen Sie das originationPhoneNumber Feld, um den Zustellungskanal zu ermitteln. Wenn der Wert eine RCS-Agenten-ID ist, wurde die Nachricht über RCS zugestellt. Handelt es sich bei dem Wert um eine E.164 Telefonnummer oder einen Kurzcode, wurde die Nachricht per SMS zugestellt (entweder direkt oder nach einem RCS-Fallback). Weitere Hinweise zum RCS-Fallback-Verhalten finden Sie unter. Fallback von RCS zu SMS mithilfe von Telefonpools