

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.

# Configurar un destino de evento de Amazon SNS en los SMS de mensajería para usuarios AWS finales
<a name="configuration-sets-sns"></a>

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
<a name="configuration-sets-sns-creating-role"></a>

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
<a name="configuration-sets-sns-creating-role-encrypted"></a>

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
<a name="configuration-sets-sns-add"></a>

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
<a name="configuration-sets-sns-edit"></a>

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
<a name="configuration-sets-sns-delete"></a>

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.

------