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. # Destinos de eventos en los SMS de mensajería para usuarios AWS finales El *destino de un evento* es una ubicación (como un CloudWatch grupo, una transmisión de Amazon Data Firehose o un tema de Amazon SNS) a la que se envían eventos de voz y SMS. Para usar los destinos de evento, primero debe crear el destino y, a continuación, asociarlo a un [Conjuntos de configuraciones en Mensajes SMS para usuarios finales de AWS](configuration-sets.md). Puede asociar hasta cinco destinos de evento con un solo conjunto de configuraciones. Al enviar un mensaje, la llamada a la API incluye una referencia al conjunto de configuraciones. Los eventos o recibos de entrega generados por los operadores pueden tardar hasta 72 horas en recibirse y no se deben utilizar para determinar si hay un retraso en la entrega de los mensajes salientes. Transcurridas 72 horas, si el SMS de mensajería para el usuario AWS final no ha recibido un último evento de un operador, el servicio devolverá automáticamente una incógnita, `messageStatus` ya que no sabemos qué ha ocurrido con ese mensaje. **Requisitos previos** Tiene que haber creado ya un conjunto de configuraciones al que asociar los destinos del evento, consulte [Conjuntos de configuraciones en Mensajes SMS para usuarios finales de AWS](configuration-sets.md). **Topics** + [Event types (Tipos de eventos)](configuration-sets-event-types.md) + [Ejemplo: datos de evento](configuration-sets-event-format.md) + [Configurar el destino del CloudWatch evento de Amazon](configuration-sets-cloud-watch.md) + [Configuración de un destino de Amazon Data Firehose](configuration-sets-kinesis.md) + [Configuración de un destino del evento de Amazon SNS](configuration-sets-sns.md) # Tipos de eventos para SMS, MMS y voz La forma más fácil de usar los destinos de evento es enviar todos los eventos de SMS, MMS y voz a un único destino. Sin embargo, puede configurar los destinos de los eventos para que se envíen tipos específicos de eventos a distintos destinos. Por ejemplo, puede enviar todos los eventos relacionados con la entrega a Firehose para su almacenamiento y todos los eventos de error a un tema de Amazon SNS para que pueda recibir una notificación cuando se produzcan. También puede enviar eventos de SMS y eventos de voz a diferentes ubicaciones. Puede configurar los destinos de los eventos para enviar los siguientes tipos de eventos: **Eventos de SMS, MMS y voz** + **ALL**: envía todos los eventos de SMS, MMS y voz al destino especificado. **Eventos de SMS** + **TEXT\$1ALL**: envía todos los eventos de SMS al destino especificado. + **TEXT\$1DELIVERED (entregado)**: envía todos los eventos de entrega de SMS al destino especificado. Dependiendo del país de destino, los eventos **TEXT\$1DELIVERED** y **TEXT\$1SUCCESSFUL** se pueden usar indistintamente. + **TEXT\$1SUCCESSFUL (correcto)**: los eventos de éxito se producen cuando el operador del destinatario acepta el mensaje. Dependiendo del país de destino, los eventos **TEXT\$1DELIVERED** y **TEXT\$1SUCCESSFUL** se pueden usar indistintamente. + **TEXT\$1QUEUED (en cola)**: los eventos en cola se producen cuando el mensaje está en cola para su entrega, pero aún no se ha entregado. + **TEXT\$1PENDING (pendiente)**: los eventos pendientes se producen cuando un mensaje está en proceso de entrega, pero aún no se ha entregado (o no se ha podido entregar). + **TEXT\$1BLOCKED (bloqueado)**: los eventos bloqueados se producen cuando el dispositivo o el operador del destinatario bloquean los mensajes dirigidos a ese destinatario. + **TEXT\$1TTL\$1EXPIRED (TTL caducado)**: 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. + **TEXT\$1CARRIER\$1UNREACHABLE (operador no disponible)**: los eventos de operador no disponible se producen cuando ocurre un error transitorio en la red del operador del destinatario del mensaje. + **TEXT\$1INVALID (SMS no válido)**: los eventos no válidos se producen cuando el número de teléfono de destino no es válido. + **TEXT\$1INVALID\$1MESSAGE (mensaje no válido)**: los eventos de mensaje no válidos se producen cuando el cuerpo del mensaje SMS no es válido y no se puede entregar. + **TEXT\$1CARRIER\$1BLOCKED (bloqueo del operador)**: los eventos de bloqueo del operador se producen cuando el operador del destinatario bloquea la entrega del mensaje. Esto suele ocurrir cuando el operador identifica el mensaje como malicioso (por ejemplo, si el mensaje contiene información relacionada con una estafa de suplantación de identidad) o abusivo (por ejemplo, si se sospecha que el mensaje tiene contenido no solicitado o prohibido). + **TEXT\$1UNREACHABLE (no disponible)**: los eventos no disponibles se producen cuando el dispositivo del destinatario no está disponible. Es posible que esto ocurra si el dispositivo no está conectado a una red móvil o si está apagado. + **TEXT\$1SPAM (spam)**: los eventos de spam se producen cuando el operador del destinatario identifica que el mensaje contiene contenido comercial no solicitado y bloquea la entrega del mensaje. + **TEXT\$1UNKNOWN (desconocido)**: los eventos desconocidos se producen cuando un mensaje no se entrega por un motivo que no está contemplado en ninguno de los otros tipos de eventos. Es posible que los errores desconocidos pueden sean transitorios o permanentes. + **TEXT\$1PROTECT\$1BLOCKED (bloqueado por protección)**: mensaje bloqueado por la configuración de protección. **Eventos de voz** + **VOICE\$1ALL**: envía todos los eventos de voz al destino especificado. + **VOICE\$1COMPLETED (completado)**: 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. + **VOICE\$1ANSWERED (respondido)**: los eventos respondidos se producen cuando el destinatario contesta el teléfono. + **VOICE\$1INITIATED (iniciado)**: envía eventos al destino especificado cada vez que se inicia un mensaje de voz. + **VOICE\$1TTL\$1EXPIRED (TTL caducado)**: 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. + **VOICE\$1BUSY (ocupado)**: los eventos ocupados se producen cuando la línea telefónica del destinatario está ocupada. + **VOICE\$1NO\$1ANSWER (sin respuesta)**: los eventos sin respuesta se producen después de realizar la llamada, pero el destinatario (o el sistema de correo de voz) nunca responde. + **VOICE\$1RINGING (sonando)**: los eventos de timbre se producen después de que se haya realizado la llamada, pero antes de que el destinatario responda. + **VOICE\$1FAILED (error)**: los eventos de error se producen cuando el mensaje no se entrega. **Eventos de MMS** + **MEDIA\$1ALL**: envía todos los eventos de MMS al destino especificado. + **MEDIA\$1PENDING (pendiente)**: los eventos pendientes se producen cuando un mensaje está en proceso de entrega, pero aún no se ha entregado (o no se ha podido entregar). + **MEDIA\$1QUEUED (en cola)**: los eventos en cola se producen cuando el mensaje está en cola para su entrega, pero aún no se ha entregado. + **MEDIA\$1SUCCESSFUL (éxito)**: los eventos de éxito se producen cuando el operador del destinatario acepta el mensaje. + **MEDIA\$1DELIVERED (entregado)**: envía todos los eventos de entrega de MMS al destino especificado. + **MEDIA\$1INVALID (MMS no válido)**: los eventos no válidos se producen cuando el número de teléfono de destino no es válido. + **MEDIA\$1INVALID\$1MESSAGE (mensaje no válido)**: los eventos de mensaje no válidos se producen cuando el cuerpo del mensaje MMS no es válido y no se puede entregar. + **MEDIA\$1UNREACHABLE (no disponible)**: los eventos no disponibles se producen cuando el dispositivo del destinatario no está disponible. Es posible que esto ocurra si el dispositivo no está conectado a una red móvil o si está apagado. + **MEDIA\$1CARRIER\$1UNREACHABLE (operador no disponible)**: los eventos de operador no disponible se producen cuando ocurre un error transitorio en la red del operador del destinatario del mensaje. + **MEDIA\$1BLOCKED (bloqueado)**: los eventos bloqueados se producen cuando el dispositivo o el operador del destinatario bloquean los mensajes dirigidos a ese destinatario. + **MEDIA\$1CARRIER\$1BLOCKED (operador bloqueado)**: los eventos de bloqueo del operador se producen cuando el operador del destinatario bloquea la entrega del mensaje. Esto suele ocurrir cuando el operador identifica el mensaje como malicioso (por ejemplo, si el mensaje contiene información relacionada con una estafa de suplantación de identidad) o abusivo (por ejemplo, si se sospecha que el mensaje tiene contenido no solicitado o prohibido). + **MEDIA\$1SPAM (spam)**: los eventos de spam se producen cuando el operador del destinatario identifica que el mensaje contiene contenido comercial no solicitado y bloquea la entrega del mensaje. + **MEDIA\$1UNKNOWN (desconocido)**: los eventos desconocidos se producen cuando un mensaje no se entrega por un motivo que no está contemplado en ninguno de los otros tipos de eventos. Es posible que los errores desconocidos pueden sean transitorios o permanentes. + **MEDIA\$1TTL\$1EXPIRED (TTL caducado)**: 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. + **MEDIA\$1FILE\$1TYPE\$1UNSUPPORTED (tipo de archivo no compatible)**: los eventos de tipo de archivo no compatible se producen cuando el formato de un archivo multimedia no es compatible. Para obtener una lista de los tipos de archivos compatibles, consulte [Tipos de archivos MMS, tamaño y límites de caracteres](mms-limitations-character.md) + **MEDIA\$1FILE\$1SIZE\$1EXCEED (tamaño de archivo)**: el evento de superación de tamaño de archivo se produce cuando el tamaño del archivo multimedia es superior a 600 KB. + **MEDIA\$1FILE\$1INACCESSIBLE (Archivo inaccesible)**: los eventos de archivos inaccesibles se producen cuando los mensajes SMS del usuario AWS final no tienen permisos para acceder al archivo. # Ejemplo de datos de eventos de SMS de mensajería para el usuario AWS final AWS La mensajería SMS para el usuario final puede transmitir datos de eventos para la entrega de SMS, MMS y mensajes 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 el SMS de mensajería para el usuario AWS final no ha recibido un último evento de un operador, el servicio devuelve automáticamente un mensaje, `UNKNOWN` `messageStatus` ya que no sabemos qué ha ocurrido con ese mensaje. **Topics** + [Ejemplo de registro de SMS](#configuration-sets-event-format-sms-example) + [Ejemplo de registro de SMS Protect](#configuration-sets-event-format-sms-protect-example) + [Ejemplo de registro de evento de voz](#configuration-sets-event-format-voice-example) + [Ejemplo de registro de MMS](#configuration-sets-event-format-mms-example) ## 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 | Description (Descripción) | | --- | --- | | eventType | El tipo de evento. Los valores se enumeran en [Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). | | 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 | El identificador único que genera el SMS de mensajería para el usuario AWS final 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](sms-limitations-character.md). | | 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sms-voice/latest/userguide/configuration-sets-event-format.html) | | 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 el usuario AWS final creó mediante SMS 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 supera estos límites, la mensajería SMS para el usuario AWS final divide automáticamente el mensaje 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](sms-limitations-mps.md). | | 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 costo 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](protect.md) 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 | Description (Descripción) | | --- | --- | | eventType | El tipo de evento. Los valores se enumeran en [Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). | | 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 | El identificador único que genera el usuario AWS final que envía mensajes SMS 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](sms-limitations-character.md). | | 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sms-voice/latest/userguide/configuration-sets-event-format.html) | | 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 el usuario AWS final creó mediante SMS 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 supera estos límites, la mensajería SMS para el usuario AWS final divide automáticamente el mensaje 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](sms-limitations-mps.md). | | 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 costo 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](protect.md). | | 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 | Description (Descripción) | | --- | --- | | eventType | El tipo de evento. Los valores se enumeran en [Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). | | 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 | El identificador único que el usuario AWS final genera al aceptar el mensaje SMS. | | 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sms-voice/latest/userguide/configuration-sets-event-format.html) | | 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 | Description (Descripción) | | --- | --- | | eventType | El tipo de evento. Los valores se enumeran en [Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). | | 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 | El identificador único que genera el SMS de mensajería para el usuario AWS final 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sms-voice/latest/userguide/configuration-sets-event-format.html) | | 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 creó AWS End User Messaging SMS para enviar el mensaje. Para obtener más información, consulte [Definición de los límites de partes por segundo (MPS) de mensajes](sms-limitations-mps.md). | | 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 costo total de las tarifas del operador de un mensaje. | # Configurar un destino de CloudWatch evento de Amazon en los SMS de mensajería para usuarios AWS finales Amazon CloudWatch Logs es un AWS servicio que puede utilizar para supervisar, almacenar y acceder a los archivos de registro. Al crear un destino de CloudWatch eventos, los mensajes SMS para el usuario AWS final envían a un CloudWatch grupo los tipos de eventos que especificó en el destino del evento. Para obtener más información CloudWatch, consulta la [Guía del usuario de Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). **Requisitos previos** 1. Antes de poder crear un destino para un CloudWatch evento, primero debe crear un CloudWatch grupo. Para obtener más información sobre la creación de grupos de registros, consulte [Trabajar con grupos de registros y flujos](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) de * CloudWatch registros en la Guía del usuario de Amazon Logs*. **importante** Necesitará el nombre de recurso de Amazon (ARN) del CloudWatch grupo para crear el destino del evento. 1. Debe crear un [rol de IAM](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title) que permita que los SMS de mensajería de usuario AWS final escriban en el grupo de registros. **importante** Necesitará el nombre de recurso de Amazon (ARN) del rol de IAM para crear el destino del evento. 1. También ha configurado un conjunto de configuraciones al que asociar los destinos de evento, consulte [Creación de un conjunto de configuración en AWS End User Messaging SMS](configuration-set-create.md). # Política de IAM para Amazon CloudWatch Utilice el siguiente ejemplo para crear una política para enviar eventos a un CloudWatch grupo. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": [ "arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*" ] } ] } ``` ------ Para obtener más información sobre las políticas de IAM, consulte [Políticas y permisos en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) en la *Guía del usuario de IAM*. La siguiente instrucción de ejemplo utiliza las `SourceArn` condiciones, opcionales pero recomendadas, `SourceAccount` para comprobar que solo la cuenta propietaria de los SMS de AWS End User Messaging tiene acceso al conjunto de configuración. En este ejemplo, *accountId* sustitúyala por el identificador de AWS cuenta, *region* por el Región de AWS nombre y *ConfigSetName* por el nombre del conjunto de configuraciones. Después de crear la política, se crea un nuevo rol de IAM y, a continuación, se asocia a la política. Al crear el rol, agréguele también la siguiente política de confianza: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName" } } } } ``` ------ Para obtener más información sobre la creación de roles, consulte [Creación de roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) en la *Guía del usuario de IAM*. # Cree un destino de CloudWatch evento de Amazon en los SMS de mensajería para usuarios AWS finales Tras crear el rol de IAM y el CloudWatch grupo, puede crear el destino del evento. ------ #### [ Create event destination (Console) ] Para crear un destino de evento mediante la consola de SMS de mensajería para el usuario AWS final, siga estos pasos: 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuraciones**, elija el conjunto de configuraciones al que desee añadir un destino del evento. 1. En la página **Detalles del conjunto de configuraciones**, elija **Agregar destino del evento**. 1. En la sección **Detalles del evento**, introduzca un nombre descriptivo para **Nombre del destino del evento**. 1. En el menú desplegable **Tipo de destino**, selecciona Amazon CloudWatch. 1. En **ARN de rol de IAM**, introduzca el ARN de rol de IAM. Para obtener más información sobre el ARN del rol de IAM, consulte [Política de IAM para Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md). 1. Para **Log group arn**, introduzca el ARN del grupo de registros de CloudWatch Amazon al que desea enviar los eventos. 1. Active **Publicación de eventos**. 1. En **Tipos de eventos**, elija: + **Todos los eventos de SMS (recomendado)**: selecciona esta opción para enviar todos los eventos de SMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon CloudWatch. + **Eventos de SMS personalizados: elige eventos** de SMS específicos a los que enviarlos CloudWatch. Para editar la lista de eventos, elija **Editar la selección de eventos de SMS**. Al **seleccionar Editar eventos por SMS**, selecciona solo los eventos que quieras enviar a Amazon CloudWatch. Elija **Guardar selección**. + **Todos los eventos de voz (recomendado)**: selecciona esta opción para enviar todos los eventos de voz listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon CloudWatch. + **Eventos de voz personalizados**: elige eventos de voz específicos a los que enviar CloudWatch. Para editar la lista de eventos, elija **Editar la selección de eventos de voz**. Al **seleccionar Editar eventos de voz**, selecciona solo los eventos que quieras enviar a Amazon CloudWatch. Elija **Guardar selección**. + **Todos los eventos MMS (recomendado)**: selecciona esta opción para enviar todos los eventos MMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon. CloudWatch + Eventos **MMS personalizados: elige eventos** MMS específicos a los que enviarlos. CloudWatch Para editar la lista de eventos, elija **Editar la selección de eventos de MMS**. En la **selección de eventos de Editar MMS**, selecciona solo los eventos que quieras enviar a Amazon CloudWatch. Elija **Guardar selección**. 1. Elija **Create event (Crear evento)**. ------ #### [ Create event destination (AWS CLI) ] Puedes usar el [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para crear un destino de evento. En la línea de comandos, ejecute el comando siguiente: ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por un nombre que describa el destino del evento. + *configurationSet*Sustitúyalo por el nombre del conjunto de configuraciones al que quieres asociar el destino del evento. + *eventTypes*Sustitúyalo por uno o más de los tipos de eventos que se enumeran en[Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). + Sustituya el valor de `IamRoleArn` por el Nombre de recurso de Amazon (ARN) de un rol de IAM que tenga las políticas que se describen en [Política de IAM para Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md). + Sustituya el valor de `LogGroupArn` por el ARN del CloudWatch grupo al que desea enviar los eventos. ------ # Editar el destino de un CloudWatch evento de Amazon en los SMS de mensajería para usuarios AWS finales Utilice la consola SMS de mensajería AWS CLI para el usuario AWS final o edite el destino de un CloudWatch evento. ------ #### [ Update event destination (Console) ] Para actualizar el destino de un evento mediante la consola de SMS de mensajería para el usuario AWS final, sigue estos pasos: 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuración**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuraciones**, elija el conjunto de configuraciones que desea editar. 1. En la pestaña **Configuración del evento**, selecciona un destino para CloudWatch eventos de Amazon y, a continuación, selecciona **Editar**. 1. En **Rol de IAM**, introduzca el ARN del rol de IAM. Para obtener más información sobre el rol de IAM, consulte [Política de IAM para Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md). 1. Para **Log group arn**, introduzca el ARN del grupo de registros de CloudWatch Amazon al que desea enviar los eventos. 1. En Tipos de **eventos**, elija: + **Todos los eventos de SMS (recomendado)**: selecciona esta opción para enviar todos los eventos de SMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon CloudWatch. + **Eventos de SMS personalizados**: elige esta opción y elige eventos de SMS específicos a los que enviar CloudWatch. Para editar la lista de eventos, elija **Editar la selección de eventos de SMS**. Al **seleccionar Editar eventos por SMS**, selecciona solo los eventos que quieras enviar a Amazon CloudWatch. Elija **Guardar selección**. + **Todos los eventos de voz (recomendado)**: selecciona esta opción para enviar todos los eventos de voz listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon CloudWatch. + **Eventos de voz personalizados**: elige esta opción y elige eventos de voz específicos a los que enviar CloudWatch. Para editar la lista de eventos, elija **Editar la selección de eventos de voz**. Al **seleccionar Editar eventos de voz**, selecciona solo los eventos que quieras enviar a Amazon CloudWatch. Elija **Guardar selección**. + **Todos los eventos MMS (recomendado)**: selecciona esta opción para enviar todos los eventos MMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon. CloudWatch + **Eventos MMS personalizados**: elige esta opción y elige eventos MMS específicos a los que enviar. CloudWatch Para editar la lista de eventos, elija **Editar la selección de eventos de MMS**. En la **selección de eventos de Editar MMS**, selecciona solo los eventos que quieras enviar a Amazon CloudWatch. Elija **Guardar selección**. 1. Elija **Editar activo**. ------ #### [ Update event destination AWS CLI) ] Puedes usar el [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para actualizar el destino de un evento. El procedimiento para actualizar el destino de un CloudWatch evento es similar al proceso para crear un destino de evento. En la línea de comandos, ejecute el comando siguiente: ``` $ aws pinpoint-sms-voice-v2 update-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event types eventTypes \ > --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por el nombre del destino del evento que desee modificar. + *configurationSet*Sustitúyalo por el nombre del conjunto de configuraciones al que desee asociar el destino del evento. Puede asociar el destino del evento con un conjunto de configuraciones diferente. + *eventTypes*Sustitúyalo por uno de los tipos de eventos que se enumeran en[Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). + Sustituya el valor de `IamRoleArn` por el Nombre de recurso de Amazon (ARN) de un rol de IAM que tenga las políticas que se describen en [Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). + Sustituya el valor de `LogGroupArn` por el ARN del CloudWatch grupo al que desea enviar los eventos. ------ # Eliminar el destino de un CloudWatch evento de Amazon en los SMS de mensajería para el usuario AWS final Utilice la consola SMS de mensajería para el usuario AWS final o AWS CLI para eliminar el destino de un CloudWatch evento. ------ #### [ Delete an CloudWatch event destination (Console) ] El proceso para eliminar un destino del evento es el mismo con independencia del tipo de destino del evento que desee eliminar. **Para eliminar el destino de un CloudWatch evento en la consola** 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuración**. 1. En la página **Conjuntos de configuraciones**, elija el conjunto de configuraciones en el que desea eliminar un destino del evento. 1. En la sección **Todos los destinos**, elija un destino del evento y, a continuación, **Eliminar**. ------ #### [ Delete an CloudWatch event destination (AWS CLI) ] Puede usar el [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para eliminar el destino de un evento. El proceso para eliminar un destino del evento es el mismo con independencia del tipo de destino del evento que desee eliminar. **Para eliminar el destino de un CloudWatch evento en el AWS CLI** + En la línea de comandos, ejecute el comando siguiente: ``` $ aws pinpoint-sms-voice-v2 delete-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSetName ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por el nombre o el nombre de recurso de Amazon (ARN) del destino del evento que quieres eliminar. + *configurationSetName*Sustitúyalo por el nombre o el ARN del conjunto de configuraciones al que está asociado el destino del evento. ------ # Configurar un destino de evento de Amazon Data Firehose en los SMS de mensajería para usuarios AWS finales Amazon Data Firehose es un servicio totalmente administrado que permite enviar datos de transmisión en tiempo real a varios tipos de destinos. Amazon Data Firehose forma parte de la plataforma de transmisión de datos Kinesis. Para obtener más información sobre Amazon Data Firehose, consulte la [Guía para desarrolladores de Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/). En algunos ejemplos de esta sección, se da por hecho que ya se ha instalado y configurado la AWS Command Line Interface. Para obtener más información sobre cómo configurar el AWS CLI, consulte la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/). **Requisitos previos** 1. Para poder crear un destino del evento de Amazon Data Firehose, primero debe crear una secuencia de entrega de Amazon Data Firehose. Para obtener más información sobre la creación de secuencias de entrega, consulte [Creación de una secuencia de entrega de Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) en la *Guía para desarrolladores de Amazon Data Firehose*. **importante** Necesitará el nombre de recurso de Amazon (ARN) de la secuencia de entrega de Amazon Data Firehose para crear el destino del evento. 1. Debe crear una función de IAM que permita que los SMS de mensajería de usuario AWS final escriban en el flujo de entrega; consulte[Política de IAM para Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). **importante** Necesitará el nombre de recurso de Amazon (ARN) del rol de IAM para crear el destino del evento. 1. También ha configurado un conjunto de configuraciones al que asociar los destinos de evento, consulte [Creación de un conjunto de configuración en AWS End User Messaging SMS](configuration-set-create.md). **Topics** + [Política de IAM para Amazon Data Firehose](configuration-sets-kinesis-creating-role.md) + [Cree un destino para eventos de Amazon Data Firehose](configuration-set-kinesis-add.md) + [Editar el destino de un evento de Amazon Data Firehose](configuration-set-kinesis-edit.md) + [Eliminar un destino de evento de Amazon Data Firehose](configuration-set-kinesis-delete.md) # Política de IAM para Amazon Data Firehose Con ayuda del siguiente ejemplo cree una política para enviar eventos a un secuencia de Amazon Data Firehose. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "firehose:PutRecord", "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName" } ] } ``` ------ Para obtener más información sobre las políticas de IAM, consulte [Políticas y permisos en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) en la *Guía del usuario de IAM*. La siguiente instrucción de ejemplo utiliza las `SourceArn` condiciones, opcionales pero recomendadas, `SourceAccount` para comprobar que solo la cuenta propietaria de los SMS para el usuario AWS final tiene acceso al conjunto de configuración. En este ejemplo, *accountId* sustitúyala por el identificador de AWS cuenta, *region* por el Región de AWS nombre y *ConfigSetName* por el nombre del conjunto de configuraciones. Después de crear la política, se crea un nuevo rol de IAM y, a continuación, se asocia a la política. Al crear el rol, agréguele también la siguiente política de confianza: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName" } } } } ``` ------ Para obtener más información sobre la creación de roles, consulte [Creación de roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) en la *Guía del usuario de IAM*. # Cree un destino de evento de Amazon Data Firehose en los SMS de mensajería para usuarios AWS finales Antes de poder crear un destino de eventos de Amazon Data Firehose, primero debe crear una transmisión de Amazon Data Firehose. Para obtener más información sobre la creación de grupos de registros, consulte [Creación de un flujo de entrega de Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) en la Guía para desarrolladores de *Amazon Data Firehose*. Debe crear una función de IAM que permita a la API de mensajería de usuario AWS final y de voz, versión 2, enviar datos a la transmisión. La siguiente sección contiene información sobre los requisitos para este rol. También ha configurado un conjunto de configuraciones al que asociar los destinos del evento, consulte [Conjuntos de configuraciones en Mensajes SMS para usuarios finales de AWS](configuration-sets.md). ------ #### [ Create Amazon Data Firehose event destination (Console) ] Para crear un destino de evento de Amazon Data Firehose mediante la consola SMS de AWS End User Messaging, siga estos pasos: 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones al que desee añadir un destino de eventos. 1. En la página de **detalles del conjunto de configuraciones**, elija **Agregar evento de destino**. 1. En la sección **Detalles del evento**, introduzca un nombre descriptivo para el nombre **del destino del evento**. 1. En el menú desplegable **Tipo de destino**, selecciona Amazon Data Firehose. 1. Para la **función de IAM arn**, introduzca el ARN de la función de IAM. Para obtener más información sobre el rol arn de IAM, consulte. [Política de IAM para Amazon Data Firehose](configuration-sets-kinesis-creating-role.md) 1. En **Delivery stream arn**, introduzca el ARN del grupo de registros de Amazon Data Firehose al que enviar los eventos. 1. **Active la publicación de eventos.** 1. En **Tipos de eventos**, selecciona: + **Todos los eventos de SMS (recomendado)**: seleccione esta opción para enviar todos los eventos de SMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon Data Firehose. + **Eventos de SMS personalizados**: elija eventos de SMS específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione **Editar la selección de eventos por SMS**. En la **selección de eventos de Edit SMS**, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione **Guardar selección**. + **Todos los eventos de voz (recomendado)**: elija esta opción para enviar todos los eventos de voz listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon Data Firehose. + **Eventos de voz personalizados**: elija eventos de voz específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione **Editar la selección de eventos de voz**. Al **seleccionar Editar eventos de voz**, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione **Guardar selección**. + **Todos los eventos MMS (recomendado)**: seleccione esta opción para enviar todos los eventos MMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon Data Firehose. + Eventos **MMS personalizados: elija entre 7 eventos** MMS específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione **Editar la selección de eventos de MMS**. En la **selección de eventos de Edit MMS**, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione **Guardar** selección. 1. Elija **Create event (Crear evento)**. ------ #### [ Create Amazon Data Firehose event destination (AWS CLI) ] Tras crear el rol de IAM y la transmisión de entrega de Amazon Data Firehose, puede crear el destino del evento. Puede usar el [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para crear un destino de evento. ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por un nombre que describa el destino del evento. + *configurationSet*Sustitúyalo por el nombre del conjunto de configuraciones al que quieres asociar el destino del evento. + *eventTypes*Sustitúyalo por uno o más de los tipos de eventos que se enumeran en[Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). + Sustituya el valor de `IamRoleArn` por el Nombre de recurso de Amazon (ARN) de un rol de IAM que tenga las políticas que se describen en [Política de IAM para Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). + Sustituya el valor `DeliveryStreamArn` de por el ARN de la transmisión de Amazon Data Firehose a la que desea enviar los eventos. ------ # Editar el destino de un evento de Amazon Data Firehose en los SMS de mensajería para usuarios AWS finales Utilice la consola SMS de AWS End User Messaging o AWS CLI edite el destino de un evento de Amazon Data Firehose. ------ #### [ Update Amazon Data Firehose event destination (Console) ] Para actualizar el destino de un evento de Amazon Data Firehose mediante la consola SMS de AWS End User Messaging, siga estos pasos: 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones al que desee añadir un destino de eventos. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones que desee editar. 1. **En la página de **detalles del conjunto de configuraciones**, elija un destino para el evento Amazon Data Firehose y, a continuación, edítelo.** 1. Para la **función de IAM arn**, introduzca el ARN de la función de IAM. Para obtener más información sobre el rol arn de IAM, consulte. [Política de IAM para Amazon Data Firehose](configuration-sets-kinesis-creating-role.md) 1. En **Delivery stream arn**, introduzca el ARN del grupo de registros de Amazon Data Firehose al que enviar los eventos. 1. En **Tipos de eventos**, elija: + **Todos los eventos de SMS (recomendado)**: seleccione esta opción para enviar todos los eventos de SMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon Data Firehose. + **Eventos de SMS personalizados**: elija esta opción y elija eventos de SMS específicos a los que enviar CloudWatch. Para editar la lista de eventos, selecciona **Editar la selección de eventos de SMS**. En la **selección de eventos de Edit SMS**, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione **Guardar selección**. + **Todos los eventos de voz (recomendado)**: elija esta opción para enviar todos los eventos de voz listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon Data Firehose. + **Eventos de voz personalizados**: elija esta opción y elija eventos de voz específicos para enviarlos a Amazon Data Firehose. Para editar la lista de eventos, seleccione **Editar la selección de eventos de voz**. Al **seleccionar Editar eventos de voz**, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione **Guardar selección**. + **Todos los eventos de MMS (recomendado)**: seleccione esta opción para enviar todos los eventos de MMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon Data Firehose. + Eventos **MMS personalizados: elija esta opción y elija eventos** MMS específicos a los que enviar. CloudWatch Para editar la lista de eventos, selecciona **Editar la selección de eventos de MMS.** En la **selección de eventos de Edit MMS**, marque solo los eventos que desee enviar a Amazon Data Firehose. Seleccione **Guardar** selección. 1. Selecciona **Editar evento**. ------ #### [ Update Amazon Data Firehose event destination (AWS CLI) ] Puede usar el [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para actualizar el destino de un evento. El procedimiento para actualizar el destino de un evento de Amazon Data Firehose es similar al proceso para crear un destino de evento. ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por el nombre del destino del evento que desee modificar. + *configurationSet*Sustitúyalo por el nombre del conjunto de configuraciones al que desee asociar el destino del evento. Puede asociar el destino del evento con un conjunto de configuraciones diferente. + *eventTypes*Sustitúyalo por uno de los tipos de eventos que se enumeran en[Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). + Sustituya el valor de `IamRoleArn` por el Nombre de recurso de Amazon (ARN) de un rol de IAM que tenga las políticas que se describen en [Política de IAM para Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). + Sustituya el valor `DeliveryStreamArn` de por el ARN de la transmisión de Amazon Data Firehose a la que desea enviar los eventos. ------ # Eliminar el destino de un evento de Amazon Data Firehose en los SMS de mensajería para el usuario AWS final Utilice la consola SMS de AWS End User Messaging o AWS CLI elimine el destino de un evento de Amazon Data Firehose. ------ #### [ Delete an Amazon Data Firehose event destination (Console) ] El proceso para eliminar un destino de evento es el mismo independientemente del tipo de destino de evento que desee eliminar. **Para eliminar un destino de evento de Amazon Data Firehose en la consola** 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones del que desee eliminar el destino de un evento. 1. En la sección **Todos los destinos**, elija un destino para el evento y, a continuación, elija **Eliminar**. ------ #### [ Delete an Amazon Data Firehose event destination (AWS CLI) ] Puede usar el [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para eliminar el destino de un evento. El proceso para eliminar un destino de evento es el mismo independientemente del tipo de destino de evento que desee eliminar. **Para eliminar un destino de evento de Amazon Data Firehose en el AWS CLI** + En la línea de comandos, ejecute el comando siguiente: ``` $ aws pinpoint-sms-voice-v2 delete-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSetName ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por el nombre o el nombre de recurso de Amazon (ARN) del destino del evento que quieres eliminar. + *configurationSetName*Sustitúyalo por el nombre o el ARN del conjunto de configuraciones al que está asociado el destino del evento. ------ # Configurar un destino de evento de Amazon SNS en los SMS de mensajería para usuarios AWS finales Amazon Simple Notification Service (Amazon SNS) es un servicio web que permite a las aplicaciones, los usuarios finales y los dispositivos enviar y recibir notificaciones de forma instantánea. Para obtener más información sobre Amazon SNS, consulte la [Guía para desarrolladores de Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). En algunos ejemplos de esta sección, se da por hecho que ya se ha instalado y configurado la AWS Command Line Interface. Para obtener más información sobre la configuración del AWS CLI, consulte la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/). **Topics** + [Política de acceso de Amazon SNS](configuration-sets-sns-creating-role.md) + [Crear un destino para eventos de Amazon SNS](configuration-sets-sns-add.md) + [Editar el destino de un evento de Amazon SNS](configuration-sets-sns-edit.md) + [Eliminar un destino de evento de Amazon SNS](configuration-sets-sns-delete.md) # Política de acceso de Amazon SNS El acceso a un tema de Amazon SNS se controla mediante una *política de recursos* asociada al tema de Amazon SNS, también denominada *política de acceso*. Para obtener más información sobre las *políticas de acceso* de Amazon SNS, consulte [Administración de identidades y acceso](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html) en la *Guía para desarrolladores de Amazon SNS*. **nota** Si su tema de Amazon SNS tiene habilitado el cifrado del lado del servidor, añada también la política a la clave de cifrado [simétrico](#configuration-sets-sns-creating-role-encrypted) asociada administrada por el cliente. AWS Key Management Service Actualice la *política de acceso* con la siguiente declaración para permitir que los SMS de mensajería de usuario AWS final se publiquen en el tema Amazon SNS. + *111122223333*Sustitúyalo por el identificador único de su AWS cuenta. + *TopicName*Sustitúyalo por el nombre del tema de Amazon SNS. + *Region*Sustitúyalo por el Región de AWS que contenga el tema y el conjunto de configuración de Amazon SNS. + Sustituya *ConfigSetName* por el nombre del conjunto de configuración. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:us-east-1:111122223333:TopicName", "Condition": { "StringEquals": { "aws:SourceAccount": "accountId" }, "ArnLike": { "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName" } } } ] } ``` ------ ## Política de acceso para temas de Amazon SNS cifrados Si su tema de Amazon SNS tiene activado el cifrado del lado del servidor AWS Key Management Service, añada la siguiente política a la clave de cifrado simétrico asociada gestionada por el cliente. Debe añadir la política a una clave gestionada por el cliente porque no puede modificar la clave AWS gestionada para Amazon SNS. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` ------ # Cree un destino de evento de Amazon SNS en los SMS de mensajería para usuarios AWS finales Antes de poder crear un destino de eventos de Amazon SNS, debe crear primero un tema de Amazon SNS. Para obtener más información sobre la creación de temas de Amazon SNS, consulte [Creación de un tema](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) en la Guía para *desarrolladores de Amazon Simple Notification Service*. También debe haber configurado previamente un conjunto de configuraciones al que asociar los destinos del evento; consulte[Conjuntos de configuraciones en Mensajes SMS para usuarios finales de AWS](configuration-sets.md). ------ #### [ Create an Amazon SNS event destination (Console) ] Para crear un destino de eventos de Amazon SNS mediante la consola SMS de mensajería para el usuario AWS final, siga estos pasos: 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones al que desee añadir un destino de eventos. 1. En la página de **detalles del conjunto de configuraciones**, elija **Agregar evento de destino**. 1. En la sección **Detalles del evento**, introduzca un nombre. 1. En el menú desplegable **Tipo de destino**, selecciona Amazon SNS. 1. **Nuevo tema de Amazon SNS**: elija esta opción para que AWS End User Messaging SMS cree un tema en su cuenta. El tema se crea automáticamente con todos los permisos necesarios. Para obtener más información sobre los temas de Amazon SNS, consulte [Configuración de Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) en la Guía para desarrolladores de [Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). 1. Tema de **Amazon SNS existente: elija esta opción si tiene un tema** de Amazon SNS existente en **el menú desplegable Arn del** tema. 1. En Tipos de **eventos**, selecciona: + **Todos los eventos de SMS (recomendado)**: seleccione esta opción para enviar todos los eventos de SMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon SNS. + **Eventos de SMS personalizados**: elija entre dos eventos de SMS específicos para enviarlos a Amazon SNS. Para editar la lista de eventos, seleccione **Editar la selección de eventos por SMS**. Al **seleccionar Editar eventos de SMS**, marque solo los eventos que desee enviar a Amazon SNS. Seleccione **Guardar selección**. + **Todos los eventos de voz (recomendado)**: elija esta opción para enviar todos los eventos de voz listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon SNS. + **Eventos de voz personalizados**: elija entre 7 eventos de voz específicos para enviarlos a Amazon SNS. Para editar la lista de eventos, seleccione **Editar la selección de eventos de voz**. Al **seleccionar Editar eventos de voz**, selecciona solo los eventos que quieras enviar a Amazon SNS. Seleccione **Guardar selección**. + **Todos los eventos MMS (recomendado)**: elija esta opción para enviar todos los eventos MMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon SNS. + Eventos **MMS personalizados: elija eventos** MMS específicos para enviarlos a Amazon SNS. Para editar la lista de eventos, seleccione **Editar la selección de eventos de MMS**. Al **seleccionar Editar eventos de MMS**, selecciona solo los eventos que quieras enviar a Amazon SNS. Seleccione **Guardar** selección. 1. Elija **Create event (Crear evento)**. ------ #### [ Create an Amazon SNS event destination (AWS CLI) ] Puede usar el [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para crear un destino de evento. ``` $ aws pinpoint-sms-voice-v2 create-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event-types eventTypes \ > --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por un nombre descriptivo para el destino del evento. + *configurationSet*Sustitúyalo por el nombre del conjunto de configuraciones al que desee asociar el destino del evento. + *eventTypes*Sustitúyalo por uno de los tipos de eventos que se enumeran en[Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). + Sustituya el valor de `TopicArn` por el nombre de recurso de Amazon (ARN) del tema de Amazon SNS al que desee enviar eventos. ------ # Editar el destino de un evento de Amazon SNS en los SMS de mensajería para usuarios AWS finales Utilice la consola SMS de mensajería AWS CLI para el usuario AWS final o edite el destino de un evento de Amazon SNS. ------ #### [ Update an Amazon SNS event destination (Console) ] Para actualizar el destino de un AWS evento de SMS de mensajería para el usuario AWS final mediante la consola de SMS de mensajería para el usuario final, siga estos pasos: 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones al que desee añadir un destino de eventos. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones que desee editar. 1. **En la página de **detalles del conjunto de configuraciones**, elija un destino de evento de Amazon SNS y, a continuación, edite.** 1. En el menú desplegable **Tipo de destino**, selecciona Amazon SNS. 1. **Nuevo tema de Amazon SNS**: al elegir esta opción, la mensajería SMS para el usuario AWS final crea un tema en su cuenta. El tema se crea automáticamente con todos los permisos necesarios. Para obtener más información sobre los temas de Amazon SNS, consulte [Configuración de Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) en la Guía para desarrolladores de [Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). 1. Tema de **Amazon SNS existente: elija esta opción si tiene un tema** de Amazon SNS existente en **el menú desplegable Arn del** tema. 1. En Tipos de **eventos**, selecciona: + **Todos los eventos de SMS (recomendado)**: seleccione esta opción para enviar todos los eventos de SMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon SNS. + **Eventos de SMS personalizados**: elija esta opción y elija eventos de SMS específicos para enviarlos a Amazon SNS. Para editar la lista de eventos, seleccione **Editar la selección de eventos por SMS**. Al **seleccionar Editar eventos de SMS**, marque solo los eventos que desee enviar a Amazon SNS. Seleccione **Guardar selección**. + **Todos los eventos de voz (recomendado)**: elija esta opción para enviar todos los eventos de voz listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon SNS. + **Eventos de voz personalizados**: elija esta opción y elija eventos de voz específicos para enviarlos a Amazon SNS. Para editar la lista de eventos, seleccione **Editar la selección de eventos de voz**. Al **seleccionar Editar eventos de voz**, selecciona solo los eventos que quieras enviar a Amazon SNS. Seleccione **Guardar selección**. + **Todos los eventos MMS (recomendado)**: elija esta opción para enviar todos los eventos MMS listados en [Event types (Tipos de eventos)](configuration-sets-event-types.md) Amazon SNS. + **Eventos MMS personalizados**: elija esta opción y elija eventos MMS específicos para enviarlos a Amazon SNS. Para editar la lista de eventos, seleccione **Editar la selección de eventos de MMS**. Al **seleccionar Editar eventos de MMS**, selecciona solo los eventos que quieras enviar a Amazon SNS. Seleccione **Guardar** selección. 1. Selecciona **Editar evento**. ------ #### [ Update an Amazon SNS event destination (AWS CLI) ] Puede usar el [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para actualizar el destino de un evento. El procedimiento para actualizar un destino de eventos de Amazon SNS es similar al proceso para crear un destino de evento. **Para actualizar el destino de un evento de Amazon SNS en AWS CLI** + En la línea de comandos, ejecute el comando siguiente: ``` $ aws pinpoint-sms-voice-v2 update-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSet \ > --matching-event types eventTypes \ > --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por el nombre del destino del evento que desee modificar. + *configurationSet*Sustitúyalo por el nombre del conjunto de configuraciones al que desee asociar el destino del evento. Puede asociar el destino del evento con un conjunto de configuraciones diferente. + *eventTypes*Sustitúyalo por uno o más de los tipos de eventos que se enumeran en[Tipos de eventos para SMS, MMS y voz](configuration-sets-event-types.md). + Sustituya el valor de `TopicArn` por el nombre de recurso de Amazon (ARN) del tema de Amazon SNS al que desee enviar eventos. ------ # Eliminar un destino de evento de Amazon SNS en los SMS de mensajería para usuarios AWS finales Utilice la consola SMS de AWS End User Messaging o AWS CLI elimine un tema de Amazon SNS. ------ #### [ Delete an Amazon SNS event destination (Console) ] El proceso para eliminar un destino de evento es el mismo independientemente del tipo de destino de evento que desee eliminar. **Para eliminar un destino de evento de Amazon SNS en la consola** 1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. En el panel de navegación, en **Configuraciones**, elija **Conjuntos de configuraciones**. 1. En la página **Conjuntos de configuración**, elija el conjunto de configuraciones del que desee eliminar el destino de un evento. 1. En la sección **Todos los destinos**, elija un destino para el evento y, a continuación, elija **Eliminar**. ------ #### [ Delete an Amazon SNS event destination (AWS CLI) ] Puede usar el [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para eliminar el destino de un evento. El proceso para eliminar un destino de evento es el mismo independientemente del tipo de destino de evento que desee eliminar. **Para eliminar un destino de evento de Amazon SNS en el AWS CLI** + En la línea de comandos, ejecute el comando siguiente: ``` $ aws pinpoint-sms-voice-v2 delete-event-destination \ > --event-destination-name eventDestinationName \ > --configuration-set-name configurationSetName ``` En el comando anterior, realice los siguientes cambios: + *eventDestinationName*Sustitúyalo por el nombre o el nombre de recurso de Amazon (ARN) del destino del evento que quieres eliminar. + *configurationSetName*Sustitúyalo por el nombre o el ARN del conjunto de configuraciones al que está asociado el destino del evento. ------