

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.

# Palabras clave en los SMS de mensajería para usuarios AWS finales
<a name="keywords"></a>

Una *palabra clave* es una palabra o frase específicas que un cliente puede enviar al número de teléfono para obtener una respuesta, como un mensaje informativo, una suscripción para recibir más mensajes, una oferta especial y otros mensajes promocionales y transaccionales. Cuando tu número recibe un mensaje que comienza con una palabra clave, el SMS de mensajería para el usuario AWS final responde con un mensaje personalizable.

En el caso de los códigos cortos, la consola muestra las palabras clave y las respuestas que defina inicialmente al solicitar un código abreviado Soporte. Soporte registra las palabras clave y las respuestas con los operadores de telefonía móvil cuando estos proporcionan el código abreviado.

Para códigos largos, la consola muestra las palabras clave y las respuestas predeterminadas.

**Importante**  
Las palabras clave y los mensajes de respuesta deben cumplir las directrices establecidas por los operadores de telefonía móvil y los grupos del sector de la tecnología móvil. De lo contrario, tras una auditoría, estos grupos pueden tomar medidas contra su código corto o largo. Esta acción puede incluir el rechazo de mostrar el número y bloqueo de los mensajes.

Una palabra clave puede tener entre 1 y 30 caracteres y no puede comenzar ni terminar con un espacio. Las palabras clave no distinguen entre mayúsculas y minúsculas.

En el caso de los agentes de AWS RCS, las palabras clave se configuran en el agente de AWS RCS y se aplican a todos los RCS for Business asociados IDs (agentes de pruebas y agentes de lanzamiento nacionales). Cuando un usuario final envía un mensaje con una palabra clave a su agente RCS de AWS, el SMS de mensajería para el usuario AWS final responde con la respuesta de palabra clave configurada. Para obtener más información sobre la recepción de mensajes RCS entrantes y el manejo de palabras clave, consulte. [Recepción de mensajes RCS entrantes](rcs-inbound.md)

Los operadores de telefonía inalámbrica en EE. UU. requieren códigos cortos para admitir las siguientes palabras clave. Además, AWS espera que todos los códigos largos y cortos admitan estas palabras clave:

HELP  
Se utiliza para obtener el servicio de atención al cliente. El mensaje de respuesta debe incluir la información de contacto de atención al cliente, como en el siguiente ejemplo:  
*“Para obtener ayuda con la cuenta, llame al (206) 555-0199”.*

STOP  
Se utiliza para dejar de recibir mensajes de su número. Además de *STOP*, la audiencia puede utilizar cualquier palabra clave compatible, por ejemplo, *CANCEL* u *OPTOUT*. Para ver una lista de palabras clave de cancelación admitidas, consulte [Palabras clave de exclusión obligatorias](keywords-required.md). Cuando tu número reciba un mensaje SMS que contenga una palabra clave de exclusión, AWS End User Messaging SMS dejará de enviar mensajes SMS desde tu cuenta a la persona que se excluyó.   
El mensaje de respuesta debe confirmar que dejarán de enviarse mensajes a la persona que canceló la suscripción, como en el siguiente ejemplo:  
*"Ya ha cancelado la suscripción y no recibirá más mensajes."*

**Topics**
+ [Palabras clave de exclusión obligatorias](keywords-required.md)
+ [Acciones de palabras clave](keywords-actions.md)
+ [Cómo agregar una palabra clave a un número de teléfono](keywords-manage-phone-number.md)
+ [Visualización de las palabras clave utilizadas por un número de teléfono](keywords-phone-number-list.md)
+ [Edición de una palabra clave utilizada por un número de teléfono](keywords-phone-number-edit.md)
+ [Cómo eliminar una palabra clave de un número de teléfono](keywords-phone-number-delete.md)
+ [Cómo agregar una palabra clave a un grupo de teléfonos](keywords-pool-add.md)
+ [Visualización de palabras clave utilizadas por un grupo de teléfonos](keywords-pool-list.md)
+ [Edición de una palabra clave de un grupo de teléfonos](keywords-pool-edit.md)
+ [Eliminación de una palabra clave de un grupo de teléfonos](keywords-pool-delete.md)

# Palabras clave de exclusión obligatorias
<a name="keywords-required"></a>

Cuando la legislación y las normativas locales vigentes así lo exijan (como, por ejemplo, en los EE. UU. y Canadá), los destinatarios de SMS y MMS podrán utilizar sus dispositivos para desactivar su suscripción respondiendo al mensaje con cualquiera de las palabras siguientes: 

**nota**  
Puede agregar palabras clave personalizadas a los números de teléfono y grupos de teléfonos para su exclusión.
+ ARRET
+ CANCEL
+ END
+ OPT-OUT
+ OPTOUT
+ QUIT
+ REMOVE
+ STOP
+ TD
+ UNSUBSCRIBE

Para excluirse, el destinatario debe responder al mismo número de teléfono que utilizó AWS End User Messaging SMS para entregar el mensaje. Tras darse de baja, el destinatario dejará de recibir mensajes SMS o MMS de su AWS cuenta.

**nota**  
En el caso de números de teléfono gratuitos de EE. UU., las desactivaciones se administran a nivel de operador. La única palabra clave de desactivación admitida para un número gratuito de EE. UU. es STOP. No puede agregar palabras clave de desactivación adicionales ni cambiar el mensaje de respuesta que reciben los destinatarios cuando se desactivan. Un usuario puede volver a suscribirse enviando un nuevo mensaje al teléfono gratuito utilizando UNSTOP o START como palabra clave.  
Para configurar la posibilidad de que un usuario vuelva a suscribirse, agregue las palabras clave UNSTOP, START o ambas al número gratuito y configure la acción de la palabra clave en. `Opt-in`

# Acciones de palabras clave
<a name="keywords-actions"></a>

Una palabra clave puede tener asociadas una de estas tres acciones. Cuando un cliente responda con la palabra clave, se realizará la acción de agregar o eliminar al usuario de la lista de exclusión o de responder al usuario con un mensaje.
+ `Opt-out`: el destinatario se añade a la lista de exclusión y no recibirá mensajes : en el futuro.
+ `Opt-in`: el destinatario quiere recibir mensajes en el futuro.
+ `Automatic response`: se envía un mensaje al destinatario que envía el mensaje de texto con la palabra clave.

# Cómo agregar una palabra clave a un número de teléfono en AWS End User Messaging SMS
<a name="keywords-manage-phone-number"></a>

Utilice la consola de End User Messaging SMS o la AWS CLI para personalizar las respuestas de palabras clave de su número de teléfono.

------
#### [ Add a keyword (Console) ]

Utilice la consola de AWS End User Messaging SMS para agregar palabras clave a su número de teléfono. 

**Agregar una palabra clave**

1. Abra la consola de Mensajes SMS para usuarios finales de AWS 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 **Número de teléfono**.

1. En la página **Número de teléfono**, elija el número de teléfono al que desea agregar una palabra clave.

1. En la pestaña **Palabras clave**, seleccione el botón **Agregar palabra clave**.

1. En el panel de **Palabra clave personalizada**, agregue lo siguiente:
   + **Palabra clave**. La nueva palabra clave que se va a agregar.
   + **Mensaje de respuesta**: el mensaje que desea devolver al destinatario.
   + **Acción de palabra clave**: la acción que se realizará cuando se reciba la palabra clave.

1. Elija **Agregar palabra clave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Puede usar el comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para crear una nueva palabra clave o editarla. Si la palabra clave ya existe, esta se sobrescribirá.

Para crear una palabra clave, ejecute el siguiente comando en AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

En el comando anterior, realice los siguientes cambios:
+ Sustituya *OriginationIdentity* por el ID único o nombre de recurso de Amazon (ARN) del número de teléfono al que desea agregar la palabra clave.
+ Sustituya *Keyword* por la nueva palabra clave.
+ Sustituya *KeywordMessage* por el mensaje que se utilizará al responder a la palabra clave.
+ Sustituya la acción *KeywordAction* (`AUTOMATIC_RESPONSE`,`OPT_OUT`,`OPT_IN`) que se realizará cuando se reciba la palabra clave.

------

# Visualización de las palabras clave utilizadas por un número de teléfono en AWS End User Messaging SMS
<a name="keywords-phone-number-list"></a>

Puede utilizar el comando [describe-keywords](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-keywords.html) para ver información acerca de las palabras clave asociadas a una identidad de origen.

Para ver una lista de palabras mediante la AWS CLI en la línea de comando, escriba el siguiente comando:

```
$ aws pinpoint-sms-voice-v2 describe-keywords \
> --origination-identity OriginationIdentity
```

En el comando anterior, realice los siguientes cambios:

Sustituya *OriginationIdentity* por el ID único o nombre de recurso de Amazon (ARN) del número de teléfono o ID de remitente de los que desea una lista de palabras clave.

# Edición de una palabra clave utilizada por un número de teléfono en AWS End User Messaging SMS
<a name="keywords-phone-number-edit"></a>

Use la consola de AWS End User Messaging SMS o la AWS CLI para editar las respuestas de palabras clave del número de teléfono.

------
#### [ Edit a keyword (Console) ]

Utilice la consola de AWS End User Messaging SMS para editar palabras clave. 

**Edición de una palabra clave**

1. Abra la consola de Mensajes SMS para usuarios finales de AWS 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 **Número de teléfono**.

1. En la página **Número de teléfono**, elija un número de teléfono que contiene la palabra clave.

1. En la pestaña **Palabras clave**, elija la palabra clave que desee editar y, a continuación, el botón **Editar palabra clave**.

1. En el panel **Palabra clave personalizada**, modifique lo siguiente.
   + **Palabra clave**: la palabra clave que se va a cambiar.
   + **Mensaje de respuesta**: el mensaje que desea devolver al destinatario.
   + **Acción de palabra clave**: la acción que se realizará cuando se reciba la palabra clave.

1. Seleccione **Guardar palabra clave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Puede usar el comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para crear una nueva palabra clave o editarla. Si la palabra clave ya existe, esta se sobrescribirá.

Para crear una palabra clave, ejecute el siguiente comando en AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

En el comando anterior, realice los siguientes cambios:
+ Sustituya *OriginationIdentity* por el ID único o nombre de recurso de Amazon (ARN) del número de teléfono al que desea agregar la palabra clave.
+ Sustituya *Keyword* por la nueva palabra clave.
+ Sustituya *KeywordMessage* por el mensaje que se utilizará al responder a la palabra clave.
+ Sustituya la acción *KeywordAction* (`AUTOMATIC_RESPONSE`,`OPT_OUT`,`OPT_IN`) que se realizará cuando se reciba la palabra clave.

------

# Cómo eliminar una palabra clave de un número de teléfono en AWS End User Messaging SMS
<a name="keywords-phone-number-delete"></a>

Utilice la consola de AWS End User Messaging SMS para eliminar una palabra clave del número de teléfono.

**nota**  
Las palabras clave de exclusión obligatorias no se pueden eliminar.

**Para eliminar una palabra clave**

1. Abra la consola de Mensajes SMS para usuarios finales de AWS 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 **Números de teléfono**.

1. En la página **Números de teléfono**, elija el número de teléfono que contiene la palabra clave.

1. En la pestaña **Palabras clave**, elija la palabra clave que desea eliminar y, a continuación, **Eliminar palabra clave**. 

# Cómo agregar una palabra clave a un grupo de teléfonos en AWS End User Messaging SMS
<a name="keywords-pool-add"></a>

Utilice la consola de AWS End User Messaging SMS o la AWS CLI para personalizar las respuestas de palabras clave del grupo de teléfonos.

------
#### [ Add a keyword (Console) ]

Utilice la consola de AWS End User Messaging SMS para agregar palabras clave al grupo. 

**Agregar una palabra clave**

1. Abra la consola de Mensajes SMS para usuarios finales de AWS 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 **Grupos de teléfonos**.

1. En la página **Grupos de teléfonos**, elija el grupo al que desea agregar una palabra clave.

1. En la pestaña **Palabras clave**, seleccione **Agregar palabra clave**.

1. En el panel **Palabra clave personalizada**, agregue lo siguiente.
   + **Palabra clave**: la nueva palabra clave que se va a agregar.
   + **Mensaje de respuesta**: el mensaje que desea devolver al destinatario.
   + **Acción de palabra clave**: la acción que se realizará cuando se reciba la palabra clave.

1. Elija **Agregar palabra clave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Puede usar el comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para crear una nueva palabra clave o editarla. Si la palabra clave ya existe, esta se sobrescribirá.

Para crear una palabra clave, ejecute el siguiente comando en AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

En el comando anterior, realice los siguientes cambios:
+ Sustituya *OriginationIdentity* por el ID único o nombre de recurso de Amazon (ARN) del grupo al que desea agregar la palabra clave.
+ Sustituya *Keyword* por la nueva palabra clave.
+ Sustituya *KeywordMessage* por el mensaje que se utilizará al responder a la palabra clave.
+ Sustituya la acción *KeywordAction* (`AUTOMATIC_RESPONSE`,`OPT_OUT`,`OPT_IN`) que se realizará cuando se reciba la palabra clave.

------

# Visualización de las palabras clave utilizadas por un grupo de teléfonos en AWS End User Messaging SMS
<a name="keywords-pool-list"></a>

Utilice la consola de AWS End User Messaging SMS o la AWS CLI para ver las respuestas a las palabras clave del grupo de teléfonos.

------
#### [ View keywords (Console) ]

Utilice la consola de AWS End User Messaging SMS para ver las palabras clave del grupo. 

**Agregar una palabra clave**

1. Abra la consola de Mensajes SMS para usuarios finales de AWS 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 **Grupos de teléfonos**.

1. En la página **Grupos de teléfonos**, elija el grupo.

1. En la pestaña **Palabras clave**, puede ver la palabra clave, el mensaje de respuesta y las acciones.

------
#### [ List keywords (AWS CLI) ]

Puede utilizar el comando [describe-keywords](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-keywords.html) para ver información acerca de las palabras clave asociadas a una identidad de origen.

Para ver una lista de palabras mediante la AWS CLI en la línea de comando, escriba el siguiente comando:

```
$ aws pinpoint-sms-voice-v2 describe-keywords \
> --origination-identity OriginationIdentity
```

En el comando anterior, realice los siguientes cambios:

Sustituya *OriginationIdentity* por el ID único o nombre de recurso de Amazon (ARN) del número de teléfono o ID de remitente de los que desea una lista de palabras clave.

------

# Edición de una palabra clave de un grupo de teléfonos
<a name="keywords-pool-edit"></a>

Use la consola de AWS End User Messaging SMS o la AWS CLI para editar las respuestas de palabras clave del grupo de teléfono.

------
#### [ Edit a keyword (Console) ]

Utilice la consola de AWS End User Messaging SMS para editar las palabras clave de su grupo. 

**Edición de una palabra clave**

1. Abra la consola de Mensajes SMS para usuarios finales de AWS 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 **Grupos de teléfonos**.

1. En la página **Grupos de teléfonos**, elija el grupo que contiene la palabra clave.

1. En la pestaña **Palabras clave**, elija la palabra clave que desea editar y, a continuación, **Editar palabra clave**.

1. En el panel **Palabra clave personalizada**, modifique lo siguiente.
   + **Palabra clave**: la palabra clave que se va a editar.
   + **Mensaje de respuesta**: el mensaje que desea devolver al destinatario.
   + **Acción de palabra clave**: la acción que se realizará cuando se reciba la palabra clave.

1. Seleccione **Guardar palabra clave**.

------
#### [ Add or edit a keyword (AWS CLI) ]

Puede usar el comando [put-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-keyword.html) para crear una nueva palabra clave o editarla. Si la palabra clave ya existe, esta se sobrescribirá.

Para crear una palabra clave, ejecute el siguiente comando en AWS CLI:

```
$ aws pinpoint-sms-voice-v2 put-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword \
> --keyword-message KeywordMessage \
> --keyword-action KeywordAction
```

En el comando anterior, realice los siguientes cambios:
+ Sustituya *OriginationIdentity* por el ID único o nombre de recurso de Amazon (ARN) del grupo al que desea agregar la palabra clave.
+ Sustituya *Keyword* por la nueva palabra clave.
+ Sustituya *KeywordMessage* por el mensaje que se utilizará al responder a la palabra clave.
+ Sustituya la acción *KeywordAction* (`AUTOMATIC_RESPONSE`,`OPT_OUT`,`OPT_IN`) que se realizará cuando se reciba la palabra clave.

------

# Eliminación de una palabra clave de un grupo de teléfonos en AWS End User Messaging SMS
<a name="keywords-pool-delete"></a>

Utilice la consola de AWS End User Messaging SMS o la AWS CLI para eliminar una palabra clave del grupo de teléfonos.

------
#### [ Delete a keyword (Console) ]

Utilice la consola de AWS End User Messaging SMS para eliminar las palabras clave de su grupo. 

**nota**  
Las palabras clave de exclusión obligatorias no se pueden eliminar.

**Para eliminar una palabra clave**

1. Abra la consola de Mensajes SMS para usuarios finales de AWS 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 **Grupos de teléfonos**.

1. En la página **Grupos de teléfonos**, elija el grupo que contiene la palabra clave.

1. En la pestaña **Palabras clave**, elija la palabra clave y, a continuación, **Eliminar palabra clave**. 

------
#### [ Delete a keyword (AWS CLI) ]

Puede usar la CLI [delete-keyword](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-keyword.html) para eliminar una palabra clave.

En la línea de comandos, introduzca el comando siguiente:

```
$ aws pinpoint-sms-voice-v2 delete-keyword \
> --origination-identity OriginationIdentity \
> --keyword Keyword
```

En el comando anterior, realice los siguientes cambios:
+ Sustituya *OriginationIdentity* por el ID único o nombre de recurso de Amazon (ARN) del número de teléfono o ID de remitente de los que desea eliminar la palabra clave.
+ Sustituya *Keyword* por la palabra clave a eliminar.

------