Ejemplo de datos de evento de Mensajes SMS para usuarios finales de AWS - AWS SMS de mensajería para el usuario final
Ejemplo de registro de SMSEjemplo de registro de SMS ProtectEjemplo de registro de evento de vozEjemplo de registro de MMS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplo de datos de evento de Mensajes SMS para usuarios finales de AWS

Mensajes SMS para usuarios finales de AWS puede transmitir datos de evento para la entrega de mensajes SMS, MMS y de voz. Debido a que los eventos generados por los operadores pueden tardar hasta 72 horas en recibirse, no se deben utilizar para determinar si hay un retraso en la entrega de los mensajes salientes. Transcurridas 72 horas, si Mensajes SMS para usuarios finales de AWS no ha recibido un evento final de un operador, el servicio devuelve un UNKNOWN messageStatus, ya que desconocemos lo que ha ocurrido con ese mensaje.

Ejemplo de registro de SMS

El objeto JSON relacionado con un evento de SMS contiene los datos que se muestran en el siguiente ejemplo.


{
    "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
}
Atributo Descripción
eventType

El tipo de evento. Los valores se enumeran en Tipos de eventos para SMS, MMS y voz.
eventVersion

La versión del esquema JSON del evento.
eventTimestamp La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos.
isFinal True si este es el estado final del mensaje. Hay estados intermedios de los mensajes y pueden pasar hasta 72 horas hasta que se reciba el estado final del mensaje.
originationPhoneNumber El número de teléfono desde el que se envió el mensaje.
destinationPhoneNumber El número de teléfono al que se ha intentado enviar el mensaje.
isInternationalSend True si la mensajería internacional está habilitada para este número de teléfono.
isoCountryCode El país que está asociado al número de teléfono del destinatario, mostrado en formato ISO 3166-1 alpha-2.
mcc Los códigos de país para móviles identifican el país al que pertenece un número de teléfono móvil. Este campo es opcional y puede no estar presente.
mnc Los códigos de red móvil identifican a un operador de red móvil. Este campo es opcional y puede no estar presente.
messageId ID único que Mensajes SMS para usuarios finales de AWS genera cuando acepta el mensaje.
messageRequestTimestamp Hora en la que se recibió la solicitud de mensaje SMS, mostrada en formato de hora Unix en milisegundos.
messageEncoding Codificación del mensaje. Los valores posibles son GSM y Unicode. Para obtener más información acerca de la codificación de mensajes, consulte Límites de caracteres de SMS.
messageType Tipo de mensaje. Los valores posibles son Promotional (Promocionales) y Transactional (Transaccionales).
messageStatus

Estado del mensaje. Los valores posibles son los que se indican a continuación.

  • SUCCESSFUL: el operador de telefonía ha aceptado el mensaje.

  • DELIVERED: el dispositivo del destinatario ha aceptado el mensaje.

  • PENDING: el mensaje aún no se ha entregado al dispositivo del destinatario.

  • INVALID: el número de teléfono de destino no es válido.

  • UNREACHABLE: el dispositivo del destinatario no está disponible en este momento. Por ejemplo, el dispositivo podría estar apagado o desconectado de la red. Puede intentar enviar el mensaje de nuevo más tarde.

  • UNKNOWN. Se ha producido un error que ha impedido la entrega del mensaje. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • BLOCKED: el dispositivo del destinatario bloquea los mensajes SMS del número de teléfono de origen.

  • CARRIER_UNREACHABLE: un problema con la red móvil del destinatario impidió que se entregara el mensaje. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • SPAM: el operador de telefonía móvil del destinatario identificó el contenido del mensaje como spam y bloqueó la entrega del mensaje.

  • INVALID_MESSAGE: el cuerpo del mensaje SMS no es válido y no se puede entregar.

  • CARRIER_BLOCKED: el operador del destinatario ha bloqueado la entrega de este mensaje. Esto suele ocurrir cuando el operador identifica el contenido del mensaje como no solicitado o malintencionado.

  • TTL_EXPIRED: el mensaje SMS no se pudo entregar en un periodo de tiempo determinado. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • ACCEPTED: se ha aceptado el mensaje SMS.

  • FAILED: el mensaje aún no se ha entregado al dispositivo del destinatario.

  • SENT: el mensaje se ha enviado, pero aún no se ha entregado al dispositivo del destinatario.

  • UNROUTABLE: no se puede enrutar debido a una configuración incorrecta de la cuenta.

  • QUEUED: el mensaje está en cola para su entrega.

  • PROTECT_BLOCKED: las reglas de protección de SMS han bloqueado el mensaje SMS.
messageStatusDescription Descripción del estado de actualización.
context Atributos personalizados que puede especificar y que se registrarán al enviar un mensaje.
totalMessageParts

El número de partes de mensaje que ha creado Mensajes SMS para usuarios finales de AWS para enviar el mensaje.

Por lo general, los mensajes SMS solo pueden contener 160 caracteres GSM-7 o 67 caracteres no GSM, aunque estos límites pueden variar según el país . Si envía un mensaje que supere estos límites, Mensajes SMS para usuarios finales de AWS lo divide automáticamente en partes más pequeñas. La facturación se realiza en función del número de partes de mensajes que envíe. Para obtener más información, consulte Definición de los límites de partes por segundo (MPS) de mensajes.
totalMessagePrice La cantidad que se cobra por enviar el mensaje. Este precio se muestra en milésimas de centavo de dólar estadounidense. Por ejemplo, si el valor de este atributo es 645, se le cobran 0,645 ¢ por enviar el mensaje (645 / 1000 = 0,645 ¢ = 0,00645 USD).
totalCarrierFee El coste total de las tarifas del operador de un mensaje.

Ejemplo de registro de SMS Protect

El objeto JSON para un evento de SMS cuando se utiliza protección de SMS contiene los datos que se muestran en el siguiente ejemplo.

{
    "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" 
         }
         
    }
}
Atributo Descripción
eventType

El tipo de evento. Los valores se enumeran en Tipos de eventos para SMS, MMS y voz.
eventVersion

La versión del esquema JSON del evento.
eventTimestamp La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos.
isFinal True si este es el estado final del mensaje. Hay estados intermedios de los mensajes y pueden pasar hasta 72 horas hasta que se reciba el estado final del mensaje.
originationPhoneNumber El número de teléfono desde el que se envió el mensaje.
destinationPhoneNumber El número de teléfono al que se ha intentado enviar el mensaje.
isoCountryCode El país que está asociado al número de teléfono del destinatario, mostrado en formato ISO 3166-1 alpha-2.
mcc Los códigos de país para móviles identifican el país al que pertenece un número de teléfono móvil. Este campo es opcional y puede no estar presente.
mnc Los códigos de red móvil identifican a un operador de red móvil. Este campo es opcional y puede no estar presente.
messageId ID único que Mensajes SMS para usuarios finales de AWS genera cuando acepta el mensaje.
messageRequestTimestamp Hora en la que se recibió la solicitud de mensaje SMS, mostrada en formato de hora Unix en milisegundos.
messageEncoding Codificación del mensaje. Los valores posibles son GSM y Unicode. Para obtener más información acerca de la codificación de mensajes, consulte Límites de caracteres de SMS.
messageType Tipo de mensaje. Los valores posibles son Promotional (Promocionales) y Transactional (Transaccionales).
messageStatus

Estado del mensaje. Los valores posibles son los que se indican a continuación.

  • SUCCESSFUL: el operador de telefonía ha aceptado el mensaje.

  • DELIVERED: el dispositivo del destinatario ha aceptado el mensaje.

  • PENDING: el mensaje aún no se ha entregado al dispositivo del destinatario.

  • INVALID: el número de teléfono de destino no es válido.

  • UNREACHABLE: el dispositivo del destinatario no está disponible en este momento. Por ejemplo, el dispositivo podría estar apagado o desconectado de la red. Puede intentar enviar el mensaje de nuevo más tarde.

  • UNKNOWN: se ha producido un error que ha impedido la entrega del mensaje. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • BLOCKED: el dispositivo del destinatario bloquea los mensajes SMS del número de teléfono de origen.

  • CARRIER_UNREACHABLE: un problema con la red móvil del destinatario impidió que se entregara el mensaje. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • SPAM: el operador de telefonía móvil del destinatario identificó el contenido del mensaje como spam y bloqueó la entrega del mensaje.

  • INVALID_MESSAGE: el cuerpo del mensaje SMS no es válido y no se puede entregar.

  • CARRIER_BLOCKED: el operador del destinatario ha bloqueado la entrega de este mensaje. Esto suele ocurrir cuando el operador identifica el contenido del mensaje como no solicitado o malintencionado.

  • TTL_EXPIRED: el mensaje SMS no se pudo entregar en un periodo de tiempo determinado. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • ACCEPTED: se ha aceptado el mensaje SMS.

  • FAILED: el mensaje aún no se ha entregado al dispositivo del destinatario.

  • SENT: el mensaje se ha enviado, pero aún no se ha entregado al dispositivo del destinatario.

  • UNROUTABLE: no se puede enrutar debido a una configuración incorrecta de la cuenta.

  • QUEUED: el mensaje está en cola para su entrega.

  • PROTECT_BLOCKED: las reglas de protección de SMS han bloqueado el mensaje SMS.
messageStatusDescription Descripción del estado del mensaje.
context Atributos personalizados que puede especificar y que se registrarán al enviar un mensaje.
totalMessageParts

El número de partes del mensaje que Mensajes SMS para usuarios finales de AWS ha creado para enviar el mensaje.

Por lo general, los mensajes SMS solo pueden contener 160 caracteres GSM-7 o 67 caracteres no GSM, aunque estos límites pueden variar según el país . Si envía un mensaje que supere estos límites, Mensajes SMS para usuarios finales de AWS lo divide automáticamente en partes más pequeñas. La facturación se realiza en función del número de partes de mensajes que envíe. Para obtener más información, consulte Definición de los límites de partes por segundo (MPS) de mensajes.
totalMessagePrice La cantidad que se cobra por enviar el mensaje. Este precio se muestra en milésimas de centavo de dólar estadounidense. Por ejemplo, si el valor de este atributo es 645, se le cobran 0,645 ¢ por enviar el mensaje (645 / 1000 = 0,645 ¢ = 0,00645 USD).
totalCarrierFee El coste total de las tarifas del operador de un mensaje.
protectConfiguration El ID de la configuración de protección que se utilizó al enviar el mensaje y el estado en el que se encontraba en el país de destino en ese momento. Para obtener más información sobre la protección de SMS, consulte Protección de SMS.
protectConfigurationAssessment Evaluación de si la protección de SMS considera que su mensaje debe permitirse o bloquearse y los motivos del bloqueo, cuando estén disponibles.

Ejemplo de registro de evento de voz

El objeto JSON referente a un evento de voz contiene los datos que se muestran en el siguiente ejemplo.


{
    "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"
    }
}
Atributo Descripción
eventType

El tipo de evento. Los valores se enumeran en Tipos de eventos para SMS, MMS y voz.
eventVersion

La versión del esquema JSON del evento.
eventTimestamp La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos.
isFinal True si este es el estado final del mensaje. Hay estados de mensaje intermedios.
originationPhoneNumber El número de teléfono desde el que se envió el mensaje.
destinationPhoneNumber El número de teléfono al que se ha intentado enviar el mensaje.
isoCountryCode El país que está asociado al número de teléfono del destinatario, mostrado en formato ISO 3166-1 alpha-2.
messageId ID único que Mensajes SMS para usuarios finales de AWS genera cuando acepta el mensaje.
messageRequestTimestamp Hora en la que se recibió la solicitud de mensaje SMS, mostrada en formato de hora Unix en milisegundos.
messageStatus

Estado del mensaje. Los valores posibles son los que se indican a continuación.

  • INITIATED: el mensaje de voz está listo para empezar a marcar.

  • RINGING: los eventos de timbre se producen después de que se haya realizado la llamada, pero antes de que el destinatario responda.

  • COMPLETED: envía todos los eventos completados de los mensajes de voz al destino especificado. Los eventos completados se producen cuando el mensaje de audio se reproduce para el destinatario. Este estado no significa necesariamente que el mensaje se haya entregado a un destinatario humano. Por ejemplo, podría indicar que el mensaje se entregó a un sistema de correo de voz.

  • ANSWERED: los eventos respondidos se producen cuando el destinatario contesta el teléfono.

  • COMPLETED: se contestó y finalizó la llamada.

  • BUSY: los eventos ocupados se producen cuando la línea telefónica del destinatario está ocupada.

  • NO_ANSWER: los eventos sin respuesta se producen después de realizar la llamada, pero el destinatario (o el sistema de correo de voz) nunca responde.

  • FAILED: los eventos de error se producen cuando el mensaje no se entrega.

  • TTL_EXPIRED: los eventos de TTL caducados se producen cuando el tiempo necesario para entregar el mensaje supera el valor de TTL que especificó al enviar el mensaje.

  • SPAM: la llamada se marcó como spam y se bloqueó.

  • PROTECT_BLOCKED: las reglas de protección de SMS han bloqueado el mensaje SMS.
callDurationInSeconds Duración de la llamada, en segundos.
totalDurationInMinutes Duración de la llamada, en minutos.
totalMessagePrice La cantidad que se cobra por enviar el mensaje de voz. Este precio se muestra en milésimas de centavo de dólar estadounidense.
context Atributos personalizados que puede especificar y que se registrarán al enviar un mensaje.

Ejemplo de registro de MMS

El objeto JSON referente a un evento de MMS contiene los datos que se muestran en el siguiente ejemplo.

{
    "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
}
Atributo Descripción
eventType

El tipo de evento. Los valores se enumeran en Tipos de eventos para SMS, MMS y voz.
eventVersion

La versión del esquema JSON del evento.
eventTimestamp La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos.
isFinal True si este es el estado final del mensaje. Hay estados intermedios de los mensajes y pueden pasar hasta 72 horas hasta que se reciba el estado final del mensaje.
originationPhoneNumber El número de teléfono desde el que se envió el mensaje.
destinationPhoneNumber El número de teléfono al que se ha intentado enviar el mensaje.
isoCountryCode El país que está asociado al número de teléfono del destinatario, mostrado en formato ISO 3166-1 alpha-2.
messageId ID único que Mensajes SMS para usuarios finales de AWS genera cuando acepta el mensaje.
messageRequestTimestamp Hora en la que se recibió la solicitud de mensaje SMS, mostrada en formato de hora Unix en milisegundos.
messageType Tipo de mensaje. Los valores posibles son Promotional (Promocionales) y Transactional (Transaccionales).
messageStatus

Estado del mensaje. Los valores posibles son los que se indican a continuación.

  • SUCCESSFUL: el operador de telefonía ha aceptado el mensaje.

  • DELIVERED: el dispositivo del destinatario ha aceptado el mensaje.

  • PENDING: el mensaje aún no se ha entregado al dispositivo del destinatario.

  • INVALID: el número de teléfono de destino no es válido.

  • UNREACHABLE: el dispositivo del destinatario no está disponible en este momento. Por ejemplo, el dispositivo podría estar apagado o desconectado de la red. Puede intentar enviar el mensaje de nuevo más tarde.

  • UNKNOWN: se ha producido un error que ha impedido la entrega del mensaje. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • BLOCKED: el dispositivo del destinatario bloquea los mensajes SMS/MMS del número de teléfono de origen.

  • CARRIER_UNREACHABLE: un problema con la red móvil del destinatario impidió que se entregara el mensaje. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • SPAM: el operador de telefonía móvil del destinatario identificó el contenido del mensaje como spam y bloqueó la entrega del mensaje.

  • INVALID_MESSAGE: el cuerpo del mensaje SMS no es válido y no se puede entregar.

  • CARRIER_BLOCKED: el operador del destinatario ha bloqueado la entrega de este mensaje. Esto suele ocurrir cuando el operador identifica el contenido del mensaje como no solicitado o malintencionado.

  • TTL_EXPIRED: el mensaje SMS no se pudo entregar en un periodo de tiempo determinado. Este error suele ser transitorio y es posible intentar enviar el mensaje de nuevo más tarde.

  • ACCEPTED: se ha aceptado el mensaje SMS.

  • FAILED: el mensaje aún no se ha entregado al dispositivo del destinatario.

  • SENT: el mensaje se ha enviado, pero aún no se ha entregado al dispositivo del destinatario.

  • UNROUTABLE: no se puede enrutar debido a una configuración incorrecta de la cuenta.

  • QUEUED: el mensaje está en cola para su entrega.

messageStatusDescription Una descripción del estado del mensaje.
context Atributos personalizados que puede especificar y que se registrarán al enviar un mensaje.
totalMessageParts

El número de partes del mensaje que Mensajes SMS para usuarios finales de AWS ha creado para enviar el mensaje. Para obtener más información, consulte Definición de los límites de partes por segundo (MPS) de mensajes.
totalMessagePrice La cantidad que se cobra por enviar el mensaje. Este precio se muestra en milésimas de centavo de dólar estadounidense. Por ejemplo, si el valor de este atributo es 645, se le cobran 0,645 ¢ por enviar el mensaje (645 / 1000 = 0,645 ¢ = 0,00645 USD).
totalCarrierFee El coste total de las tarifas del operador de un mensaje.