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.
# Configuración del correo electrónico en Amazon Connect
A continuación, se presenta un resumen de los pasos para configurar el canal de correo electrónico de su centro de contacto.
+ [Habilitación de correo electrónico para su instancia de Amazon Connect](enable-email1.md). Durante este proceso, obtendrá una dirección de correo electrónico generada automáticamente. También tiene la opción de agregar cinco direcciones personalizadas.
+ [Creación de direcciones de correo electrónico](create-email-address1.md).
+ [Crear o actualizar colas](create-queue.md) para el correo electrónico: en la sección de **configuración del correo saliente**:
+ **Dirección de correo electrónico predeterminada**: especifique la dirección de correo electrónico saliente que está preseleccionada para los agentes cuando responden o inician correos electrónicos.
+ Debe ser una dirección de correo electrónico verificada de Amazon Connect (una dirección de correo electrónico creada en Amazon Connect con un dominio verificado de Amazon SES).
+ Debe ser la dirección de correo electrónico más utilizada para esta lista.
+ En el caso de los correos salientes iniciados por los agentes, los agentes pueden enviar correos electrónicos utilizando la dirección de correo electrónico predeterminada de la cola saliente predeterminada configurada en su perfil de enrutamiento. Los agentes también pueden seleccionar entre las **direcciones de correo electrónico adicionales** configuradas en la cola, lo que le brinda flexibilidad para controlar qué direcciones de correo electrónico pueden usar los agentes en función de su función o equipo.
+ Este modelo es similar al de los contactos de voz salientes, en el que se especifica el identificador de llamadas salientes y el flujo por cola, y los agentes utilizan la cola saliente predeterminada de su perfil de enrutamiento.
+ Flujo de **correo saliente: seleccione el flujo** que desee ejecutar para los correos salientes enviados desde esta cola. Puede seleccionar el flujo [Flujo saliente predeterminado en Amazon Connect: "Esta llamada no se está grabando"](default-outbound.md) u otro que sea del tipo Outbound.
+ El flujo de correo saliente que configure aquí se aplica a las respuestas del agente a los correos entrantes, a los contactos de correo electrónico recibidos en esta cola y a los correos salientes iniciados por el agente cuando se selecciona esta cola como cola saliente predeterminada en el perfil de enrutamiento del agente.
+ Si no especifica un flujo de correo saliente, se utiliza automáticamente para todos los correos salientes de [Flujo saliente predeterminado en Amazon Connect: "Esta llamada no se está grabando"](default-outbound.md) esta cola.
+ Al igual que con los contactos de voz salientes, la configuración de diferentes flujos de correo saliente por cola le brinda flexibilidad para ejecutar diferentes flujos de contactos en función de la cola. Esto le permite personalizar la experiencia del correo electrónico saliente para diferentes equipos, marcas o unidades de negocio.
En la sección **Direcciones de correo electrónico adicionales**:
+ **Buscar direcciones de correo electrónico**: seleccione hasta 49 direcciones de correo electrónico adicionales que los agentes puedan usar al responder o iniciar correos electrónicos. Los agentes pueden seleccionar entre todas las direcciones de correo electrónico configuradas (la predeterminada y las adicionales) mediante una lista desplegable en su espacio de trabajo (consulte). [Seleccione una dirección de correo electrónico de origen](agent-select-from-email.md) Puede configurar hasta 50 direcciones de correo electrónico en total por cola (1 por defecto y 49 adicionales).
La lista de direcciones de correo electrónico disponibles respeta el [control de acceso basado en etiquetas (TBAC](https://docs.aws.amazon.com/connect/latest/adminguide/tag-based-access-control.html)). Los agentes solo ven las direcciones de correo electrónico que tienen permiso para usar en función de las etiquetas asignadas.
+ [Cree o actualice los perfiles de enrutamiento](routing-profiles.md) para especificar que los agentes puedan gestionar los contactos de correo electrónico.
**importante**
En el perfil de enrutamiento:
La **cola de salida predeterminada** define la lista de direcciones de correo electrónico disponibles para los agentes para cualquier correo saliente que inicien. Los agentes pueden seleccionar entre las direcciones de correo electrónico configuradas en esta cola.
El **Número máximo de contactos por agente** define cuántos correos electrónicos pueden recibir los agentes y el doble de ese número indica cuántos correos electrónicos salientes pueden iniciar los agentes. Por ejemplo, si establece el número **máximo de contactos por agente** en 5, los agentes pueden recibir hasta 5 correos electrónicos y crear hasta 10 correos electrónicos salientes iniciados por el agente.
+ [Creación de plantillas de mensajes](create-message-templates1.md). Las plantillas de correo electrónico pueden definir la estructura del correo electrónico para el agente, por ejemplo, para una firma o una exención de responsabilidad, o pueden ser una respuesta completa.
+ Configure los flujos con el bloque [Envío de mensaje](send-message.md). Use este bloque para enviar un mensaje a su cliente en función del mensaje personalizado o de plantilla que especifique. Además, puede especificar lo siguiente:
+ Las direcciones de correo electrónico y los nombres públicos de destino y de origen. Puede especificarlos manual o dinámicamente utilizando [Atributos del sistema](connect-attrib-list.md#attribs-system-table); por ejemplo:
+ **Dirección de punto de conexión del cliente**: la dirección de correo electrónico del cliente que inició el contacto.
+ **Dirección de correo electrónico del sistema**: la dirección de correo electrónico a la que el cliente envió el correo electrónico.
+ **Nombre público del cliente**: se captura del correo electrónico que el cliente te envió.
+ **Nombre público del sistema**: el nombre público del correo electrónico al que el cliente ha hecho el envío.
+ **Lista de direcciones de correo electrónico en copia**: la lista completa de direcciones de correo electrónico en copia que figuran en el correo electrónico del cliente.
+ **Lista de direcciones de correo electrónico de destinatarios**: la lista completa de direcciones de correo electrónico de destinatarios que figuran en el correo electrónico del cliente.
Por ejemplo, para enviar una respuesta automática cuando un cliente le envíe un correo electrónico, ponga **Dirección de correo electrónico** de forma dinámica como la **Dirección de punto de conexión del cliente** y **Mostrar nombre** de forma dinámica como el **Nombre público del cliente**.
+ **Mensaje**: especifique una plantilla o introduzca texto sin formato.
+ Puede especificar el **asunto** de forma dinámica mediante **Atributo de segmento** - **Asunto del correo electrónico**.
+ Puede especificar el **mensaje** de forma dinámica seleccionando un atributo **definido por el usuario**.
+ **Enlace al contacto**: elija si desea vincular el correo de contacto entrante al correo de contacto saliente. No es recomendable elegir esta opción para los correos electrónicos de respuesta automática.
+ Use los atributos del bloque [Comprobar atributos de contacto](check-contact-attributes.md) para comprobar el canal del contacto. Si es un correo electrónico, puede utilizar el siguiente [Atributos del segmento](connect-attrib-list.md#attribs-segment-attributes) para comprobarlo:
+ **Asunto del correo electrónico**: puede comprobar el asunto, por ejemplo, con determinadas palabras clave.
+ **Veredicto sobre el spam de Amazon SES** y **Veredicto sobre el virus de Amazon SES**: cuando llega el correo electrónico del cliente, Amazon SES lo escanea en busca de spam y virus. Por ejemplo, si la condición es FAILED (es decir, el correo electrónico no pasó la verificación), puede desconectar el contacto o enviar el correo electrónico a una cola especial para que los gerentes lo revisen.
+ Asigne el siguiente permiso de perfil de seguridad a los agentes que necesiten iniciar los correos electrónicos salientes.
+ **Panel de control de contacto (CCP)** - **Iniciar conversaciones por correo electrónico**
# Cómo funciona el correo electrónico de Amazon Connect
El correo electrónico de Amazon Connect ofrece funciones integradas que facilitan la priorización, la asignación y la automatización de la resolución de los correos electrónicos de servicio al cliente, lo que mejora la satisfacción de los clientes y la productividad de los agentes. Puede recibir y responder a los correos electrónicos enviados por los clientes a [las direcciones de correo electrónico configuradas](create-email-address1.md) o enviados mediante formularios web en su sitio web o aplicación móvil mediante la [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API.
El correo electrónico de Amazon Connect se integra con [Amazon Simple Email Service (SES)](https://docs.aws.amazon.com/ses/latest/dg/Welcome.html) para enviar, recibir y supervisar correos electrónicos en busca de [contenido marcado como spam o que contenga virus](https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html#receiving-email-auth-and-scan), [tasas de éxito de entrega](https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) y [resultados de reputación del remitente](https://docs.aws.amazon.com/ses/latest/dg/monitor-sender-reputation.html).
En este tema, se explica cómo funciona el correo electrónico de Amazon Connect junto con Amazon SES para ofrecer una experiencia de cliente perfecta.
**Topics**
+ [Recepción de correos electrónicos](#email-capabilities-howreceived)
+ [Contactos por correo electrónico](#email-capabilities-howtranslated)
+ [Todos los mensajes de correo electrónico son un contacto de correo electrónico único](#email-capabilities-howmanaged)
+ [Hilos de correo electrónico](#email-capabilities-howthreadsmanaged)
+ [Enviar correos electrónicos](#email-capabilities-howemailssent)
## Recepción de correos electrónicos
Amazon Connect puede recibir correos electrónicos de tres maneras principales:
+ **Método 1**: mediante una [dirección de correo electrónico](create-email-address1.md) definida en Amazon Connect (por ejemplo, *customer-domain* support@.com) que utilice un [dominio de correo electrónico verificado de Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc), como el dominio de correo electrónico proporcionado con su instancia de Amazon Connect (por ejemplo, @ *instance-alias* .email.connect.aws) o un dominio verificado personalizado que sea de su propiedad o que le haya proporcionado su empresa (por ejemplo, @.com). *customer-domain* Consulte el [paso 3: uso de sus propios dominios de correo electrónico personalizados](enable-email1.md#use-custom-email) en [Habilitación del correo electrónico para su instancia](enable-email1.md) para obtener más información sobre la incorporación de dominios de correo electrónico personalizados.
+ **Método 2**: mediante el uso de una regla de enrutamiento en su servidor de correo electrónico (por ejemplo, [Microsoft 365 Connectors](https://learn.microsoft.com/en-us/exchange/mail-flow-best-practices/use-connectors-to-configure-mail-flow/set-up-connectors-to-route-mail) o [Google Workspace Mail Routes](https://support.google.com/a/answer/2614757?hl=en&ref_topic=2921034&sjid=9077065025577504786-NC)) para enviar el correo entrante a uno de los [puntos de enlace SMTP de Amazon SES](https://docs.aws.amazon.com/general/latest/gr/ses.html) mediante un dominio de correo electrónico verificado incorporado a Amazon SES (por ejemplo, @.com). *customer-domain*
+ **Método 3**: usar la [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API para iniciar un contacto de correo electrónico mediante un formulario web en su sitio web o en su aplicación móvil. Esto inicia los contactos de correo electrónico entrantes de forma similar a los clientes que envían correos electrónicos a sus direcciones de correo electrónico.
El siguiente diagrama ilustra cómo Amazon Connect recibe los correos electrónicos enviados por sus clientes mediante la [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API de cada uno de los métodos mencionados anteriormente.
![\[Un diagrama que muestra cómo se envía un mensaje como formulario web o correo electrónico a la StartEmailContact API.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-ses-diagram.png)
Para integrar los métodos 1 o 2, debe verificar un dominio de correo electrónico en Amazon SES antes de poder usar el dominio de correo electrónico en Amazon Connect. Para consultar las instrucciones, vaya a [Verificación de una identidad de dominio de DKIM con el proveedor de DNS](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc).
Para integrar el método 3, se utiliza la [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API. Esta es la API principal de todos los métodos de integración para los contactos de correo electrónico entrantes. Funciona de forma similar a [StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html). Requiere que dé uno de los siguientes pasos:
+ Incluir al menos una dirección de correo electrónico de su instancia de Amazon Connect en los atributos Para o CC del contacto de correo entrante.
-O BIEN-
+ Definir un flujo entrante desde su instancia de Amazon Connect para enrutar el contacto de correo entrante creado.
Si ambos están definidos, el comportamiento predeterminado prioriza el flujo entrante de su instancia de Amazon Connect para gestionar el contacto de correo entrante creado. Si se incluyen varias direcciones de correo electrónico de su instancia de Amazon Connect en los atributos de dirección de correo electrónico Para o CC, se crearán varios contactos de correo electrónico entrantes en su instancia de Amazon Connect.
## Conversión de mensajes de correo electrónico en contactos de correo
Para la recepción de correo electrónico general en Amazon Connect, incluido el correo electrónico basado en formularios web, la [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API expone los campos de correo electrónico básicos en el objeto de solicitud. Este objeto se utiliza para rellenar la información del correo electrónico e iniciar un contacto de correo electrónico en Amazon Connect. Incluye los siguientes campos:
+ Una dirección de correo electrónico De
+ Direcciones de correo electrónico Para
+ Direcciones de correo electrónico CC
+ Un asunto
+ Un cuerpo de mensaje simple o en HTML
+ Archivos adjuntos
Para obtener más información sobre cómo se rellena la información de contacto de correo electrónico en el contacto de correo electrónico, consulte el modelo de datos de contacto de correo electrónico de Amazon Connect.
Una vez que la [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API haya validado los parámetros de solicitud y se haya asegurado de que al menos una dirección de correo electrónico de destino o CC es válida y existe en la instancia de Amazon Connect, esto es lo que ocurre:
1. Se genera y devuelve un identificador de contacto como parte del cuerpo de respuesta de la API.
1. Se activa un flujo de trabajo asincrónico para realizar un procesamiento adicional de los mensajes de correo electrónico.
1. El flujo se inicia. Este es el flujo asociado a la dirección de correo electrónico que se encuentra en la instancia de Amazon Connect.
Como parte de este proceso, debe configurar el almacenamiento de mensajes de correo electrónico y archivos adjuntos para su instancia de Amazon Connect.
+ Tanto los mensajes de correo electrónico como los archivos adjuntos se almacenan en su propio bucket de Amazon SES S3, y es ahí donde se accede a ellos.
+ El resto de los atributos del contacto de correo electrónico, como Para, CC, Asunto y otros atributos, se almacenan en el contacto de correo electrónico; consulte [Modelo de datos para los registros de contactos de Amazon Connect](ctr-data-model.md).
El siguiente diagrama ilustra el flujo del mensaje de correo electrónico del cliente a Amazon SES y, después, a Amazon Connect. Muestra el contenido del mensaje de correo electrónico almacenado en su bucket de S3 y, a continuación, obtiene los datos de ese bucket para mostrárselos al agente.
![\[Diagrama que muestra el contenido de los mensajes de correo electrónico almacenado en su bucket de S3\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-concepts-translated.png)
## Todos los mensajes de correo electrónico son un contacto de correo electrónico único
El correo electrónico de Amazon Connect es diferente de la voz, el chat y las tareas.
+ Cada mensaje de correo electrónico, entrante o saliente, de Amazon Connect es su propio contacto de correo electrónico único.
+ Cada contacto de correo electrónico contiene detalles específicos de ese mensaje de correo electrónico, como la dirección de origen, la dirección de destino, la dirección CC, el asunto relatedContactId, los enlaces al cuerpo del correo electrónico y a las ubicaciones de almacenamiento de los archivos adjuntos y otros detalles relevantes para el contacto de correo electrónico individual.
Sin embargo, al igual que otros canales de Amazon Connect, un contacto de correo electrónico tiene métodos de inicio similares, como `INBOUND`, `OUTBOUND`, `TRANSFER`, `API`, `QUEUE_TRANSFER` y `END/DISCONNECT`. También tiene estados similares, como `CREATED`, `QUEUED`, `CONNECTING`, `CONNECTED`, `MISSED`, `TRANSFERRED`, `ERROR`, `ENDED/DISCONNECTED` y `REJECTED`.
Para obtener más información sobre cómo se rellena la información de contacto de correo electrónico en el contacto de correo electrónico, consulte [Modelo de datos para los registros de contactos de Amazon Connect](ctr-data-model.md).
## Hilos de correo electrónico
Los hilos de correo electrónico garantizan que los correos electrónicos salientes y las respuestas entrantes relacionadas con la consulta de un cliente se asocien entre sí de forma cronológica y organizada.
Para mantener toda la conversación por correo electrónico, Amazon Connect vincula los contactos de correo electrónico mediante algunos campos del contacto de correo electrónico, como el relatedContactId y una lista de encabezados de correo electrónico que siguen los estándares de los clientes de correo electrónico convencionales (RFC 5256).
La mayoría de los clientes de correo electrónico, como Gmail, Apple Mail y Outlook, admiten la creación de hilos de correo electrónico. No obstante, tenga en cuenta que hay algunos que no lo admiten.
Si su cliente responde al último mensaje de correo electrónico del hilo, el hilo sigue un patrón sencillo y directo, como se muestra en la siguiente imagen:
![\[El hilo de correo electrónico sigue un patrón sencillo y directo\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-threading.png)
Si el cliente responde a un mensaje anterior del hilo de correo electrónico, se forma un árbol de hilos y el patrón de hilos de correo electrónico tiene un aspecto parecido al del ejemplo de la siguiente imagen:
![\[El patrón en forma de árbol del hilo de correo electrónico\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-threading-tree.png)
En ambos casos, Amazon Connect mantiene un registro de cada uno de los mensajes de correo electrónico relacionados con un hilo. Se puede acceder a todos los mensajes de correo electrónico desde el correo electrónico anterior.
## Enviar correos electrónicos
Todos los mensajes de correo electrónico de Amazon Connect se envían desde Amazon SES directamente a su cliente. Ya sea que utilices el dominio de correo electrónico proporcionado con tu instancia de Amazon Connect (por ejemplo, @ *instance-alias* .email.connect.aws) o un dominio verificado personalizado (por ejemplo, @ .com)*customer*, Amazon SES está autorizado a enviar correos electrónicos directamente a tus clientes mediante la verificación de la identidad de un dominio.
En el siguiente diagrama se muestra que la [StartOutboundEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundEmailContact.html)API envía correos electrónicos a Amazon SES y Amazon SES los envía a su cliente.
![\[Diagrama que muestra el flujo de correo electrónico desde la StartOutboundEmailContact API a través de SES hasta el cliente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-concepts-sent.png)
La [StartOutboundEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundEmailContact.html)API es la API principal de todos los métodos de integración para los contactos de correo electrónico salientes, incluidas las respuestas de los agentes a los contactos entrantes y los contactos de correo salientes iniciados por el agente.
+ Funciona de forma similar a la [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API, pero es a la inversa, ya que es saliente.
+ Precisa al menos de una dirección de correo electrónico en los atributos de dirección de correo Para o CC, así como de un flujo de tonos salientes para gestionar el contacto saliente.
# Habilitación de correo electrónico para su instancia de Amazon Connect
Este tema está dirigido a los administradores que tienen acceso a la consola de Amazon Connect. En él se explica cómo habilitar el correo electrónico para tu instancia mediante el sitio web de Amazon Connect administración. Para obtener una lista de cómo APIs habilitar el correo electrónico mediante programación, consulte. [APIs para activar el correo electrónico](#apis-email-setup2)
Al habilitar el correo electrónico, obtiene un dominio de correo electrónico generado automáticamente. También puede usar dominios personalizados.
+ **Dominio de correo electrónico de Amazon Connect**. *El dominio de correo electrónico es *instance-alias* .email.connect.aws.*
+ Puede usar este dominio para realizar pruebas.
+ También puede utilizar este dominio de correo electrónico para integrarlo con Amazon Connect y empezar a recibir correos electrónicos en Amazon Connect. Por ejemplo, si tiene una dirección de correo electrónico como *support@example.com*, puede reenviar el correo electrónico a Amazon Connect mediante *support@example.email.connect.aws*.
+ **Dominios personalizados** Puede especificar hasta cinco dominios personalizados que se hayan [incorporado a Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc).
## Paso 1: paso de Amazon SES al modo de producción
Amazon Connect utiliza Amazon SES para enviar y recibir correos electrónicos. Si tiene una nueva instancia de Amazon SES, debe sacarla del modo de entorno de pruebas. Para ver las instrucciones, consulte [Solicitud de acceso de producción (salida del entorno de pruebas de Amazon SES)](https://docs.aws.amazon.com/ses/latest/dg/request-production-access.html) en la *Guía para desarrolladores de Amazon SES*.
Tras mover Amazon SES al modo de producción, si ya habilitó el correo electrónico al crear su instancia de Amazon Connect, pase a estos temas:
+ [(Opcional) Paso 3: uso de sus propios dominios de correo electrónico personalizados](#use-custom-email)
+ [Paso 5: Configure una política CORS en su depósito de archivos adjuntos](#config-email-attachments-cors1)
## Paso 2: obtención de un dominio de correo electrónico preconfigurado de Amazon Connect
Estos pasos solo se aplican si ya ha creado una instancia de Amazon Connect, pero no ha activado el correo electrónico. Complete estos pasos para obtener un dominio de correo electrónico preconfigurado de Amazon Connect.
1. En la consola de Amazon Connect, en el menú de navegación de la izquierda, seleccione **Correo electrónico** y, a continuación, **Crear rol de servicio**. Solo tiene que crear este rol una vez en su cuenta. Permite a Amazon SES enrutar los correos electrónicos a Amazon Connect.
1. Elija **Agregar dominio** como se muestra en la siguiente imagen.
![\[La página Administrar el correo electrónico y el botón Agregar dominio\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-aws-console1.png)
1. En el cuadro **Agregar dominio de correo electrónico**, seleccione el **dominio de correo electrónico de Amazon Connect**, como se muestra en la siguiente imagen. Al elegir esta opción, el nombre del dominio se genera automáticamente: **instance-alias*.email.connect.aws.* No puede cambiar esta dirección de correo electrónico.
![\[La casilla Agregar dominio de correo electrónico y la opción de dominio de correo electrónico de Amazon Connect\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-add-email-domain.png)
## (Opcional) Paso 3: uso de sus propios dominios de correo electrónico personalizados
Puede importar hasta cinco dominios personalizados que se hayan [incorporado a Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc).
1. En la consola de Amazon Connect, en el menú de navegación de la izquierda, seleccione **Correo electrónico** y, a continuación **Agregar dominio**, como se muestra en la siguiente imagen.
![\[El canal Correo electrónico en la consola de Amazon Connect\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-aws-console.png)
1. Seleccione **Use un dominio de correo electrónico personalizado**. Use el menú desplegable para elegir dominios personalizados que hayan sido [verificados por Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc).
![\[La opción Use un dominio de correo electrónico personalizado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-add-custom-domain.png)
## Paso 4: habilitación del correo electrónico y creación de un bucket de Amazon S3 para almacenar el correo electrónico y los archivos adjuntos
Estos pasos solo se aplican si ya ha creado una instancia de Amazon Connect, pero no ha activado el correo electrónico.
Debe actualizar la configuración de **Almacenamiento de datos** para permitir el canal de correo electrónico y especificar el bucket de Amazon S3 en el que se almacenarán los mensajes de correo electrónico y los archivos adjuntos. El correo electrónico requiere dos punteros de buckets de Amazon S3. Pueden estar en el mismo bucket de Amazon S3 o en dos buckets diferentes.
**importante**
Si elige **Habilitar el uso compartido de archivos adjuntos** para su instancia, debe crear un bucket de Amazon S3 y [configurar una política CORS en su bucket de archivos adjuntos](#config-email-attachments-cors1), tal y como se describe en este tema. Si no lo hace, **el canal de correo electrónico no funcionará para la instancia**.
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el menú de navegación de la izquierda, seleccione **Almacenamiento de datos**, **Mensajes de correo electrónico**, **Editar**, **Habilitar la exportación de mensajes de correo electrónico a S3**; luego, seleccione **Guardar**.
1. Rellene la página **Mensajes de correo electrónico** para crear o seleccionar un bucket de S3 donde se almacenen los mensajes de correo electrónico. En la siguiente imagen, se muestra un ejemplo de página completada:
![\[La opción Almacenamiento de datos en el menú y la página Mensajes de correo electrónico\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-messages-export-to-s3.png)
1. Si quiere permitir los archivos adjuntos de correo electrónico, seleccione también **Archivos adjuntos**. La siguiente imagen muestra estas opciones.
La siguiente imagen de la página **Almacenamiento de datos** muestra el bucket de Amazon S3 para mensajes de correo electrónico y archivos adjuntos.
![\[El bucket de Amazon S3 donde se almacenan los correos electrónicos y los archivos adjuntos\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/email-s3-bucket.png)
## Paso 5: Configure una política CORS en su depósito de archivos adjuntos
Para permitir que los clientes y agentes carguen y descarguen archivos, actualice su política de uso compartido de recursos entre orígenes (CORS) para permitir las solicitudes `PUT` y `GET` para el bucket de Amazon S3 que utiliza para los archivos adjuntos. Esto es más seguro que habilitar read/write el uso público en tu bucket de Amazon S3, algo que no recomendamos.
**Para configurar CORS en el bucket de archivos adjuntos**
1. Busque el nombre del bucket de Amazon S3 para almacenar los archivos adjuntos:
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la consola de Amazon Connect, elija **Almacenamiento de datos** y localice el nombre del bucket de Amazon S3.
1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En la consola de Amazon S3, seleccione su bucket de Amazon S3.
1. Elija la pestaña **Permisos** y, a continuación, desplácese hasta la sección **Uso compartido de recursos entre orígenes (CORS)**.
1. Agregue una política CORS que tenga una de las siguientes reglas en su bucket de archivos adjuntos. Para ver ejemplos de políticas CORS, consulte [Uso compartido de recursos entre orígenes: escenarios de casos de uso](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html#example-scenarios-cors) en la *Guía para desarrolladores de Amazon S3*.
+ Opción 1: enumere los puntos de conexión desde los que se enviarán y recibirán los archivos adjuntos, como el nombre del sitio web de su empresa. Esta regla permite solicitudes PUT y GET entre orígenes desde su sitio web (por ejemplo, http://www.example1.com).
Su política CORS puede parecerse al siguiente ejemplo:
```
[
{
"AllowedHeaders": [
"*"
],
"AllowedMethods": [
"PUT",
"GET"
],
"AllowedOrigins": [
"*.my.connect.aws",
"*.awsapps.com"
],
"ExposeHeaders": []
}
]
```
+ Opción 2: agregue el carácter comodín `*` a `AllowedOrigin`. Esta regla permite solicitudes PUT y GET entre orígenes de todos los orígenes, por lo que no tiene que enumerar sus puntos de conexión.
Su política CORS puede parecerse al siguiente ejemplo:
```
[
{
"AllowedMethods": [
"PUT",
"GET"
],
"AllowedOrigins": [
"*"
],
"AllowedHeaders": [
"*"
]
}
]
```
## Siguientes pasos
+ [Configuración del análisis de archivos adjuntos en Amazon Connect](setup-attachment-scanning.md): este tema va dirigido a los desarrolladores que estén familiarizados con Lambda. Puede configurar Amazon Connect para analizar los archivos adjuntos de correo electrónico con la aplicación de análisis que prefiera.
## APIs para activar el correo electrónico
Utilice lo siguiente APIs para habilitar el correo electrónico mediante programación:
+ [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)
+ [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)
+ [DescribeInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeInstanceStorageConfig.html)
# Creación de direcciones de correo electrónico
En este tema se explica cómo crear direcciones de correo electrónico mediante el sitio web de Amazon Connect administración. Puede crear direcciones de correo electrónico a las que los clientes puedan responder, así como direcciones de correo electrónico que sean solo salientes (no-reply).
Para obtener una lista de las que APIs se utilizan para crear y administrar direcciones de correo electrónico mediante programación, consulte. [APIs para crear y administrar direcciones de correo electrónico](#apis-manage-email-addresses1)
Puede especificar hasta 100 direcciones de correo electrónico.
**Cómo crear direcciones de correo electrónico**
1. Inicie sesión en el sitio web de Amazon Connect administración en https://*instance name*.my.connect.aws/. Utilice una cuenta de administrador o una cuenta que tenga el permiso **Canales y flujos** - **Direcciones de correo electrónico** - **Crear** en su perfil de seguridad.
1. En el menú de navegación, seleccione **Canales**, **Direcciones de correo electrónico**.
1. Seleccione un dominio en la lista desplegable. La lista contiene el dominio generado automáticamente que se creó al habilitar el canal de correo electrónico para la instancia. También puede mostrar hasta cinco dominios personalizados si los has agregado.
1. En **Información adicional**, puede editar la siguiente información si lo desea:
+ **Nombre descriptivo del remitente**
+ **Descripción**: este campo es para usted, el cliente no lo verá.
+ **Flujo**: elija un flujo publicado para enviar correos electrónicos. Deje este campo en blanco para que la dirección de correo electrónico se utilice únicamente para la comunicación saliente. Los clientes no podrán responder.
**sugerencia**
Para crear direcciones de correo electrónico del tipo **No-reply**, es decir, direcciones que solo se utilicen para el correo saliente y no puedan aceptar una respuesta, no seleccione un flujo para usarlo para la dirección de correo electrónico.
1. En **Etiquetas**, si lo desea, añada [etiquetas](tagging.md) para gestionar quién puede ver las direcciones de correo electrónico en Amazon Connect y en el espacio de trabajo del agente, así como acceder a estas.
1. Seleccione **Crear**.
## APIs para crear y administrar direcciones de correo electrónico
Para ver una lista de todas las direcciones de correo electrónico APIs, consulta [las acciones de correo electrónico](https://docs.aws.amazon.com/connect/latest/APIReference/email-api.html) en la *Guía de referencia de la Amazon Connect API*.
Utilice lo siguiente APIs para crear direcciones mediante programación:
+ [CreateEmailAddress](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateEmailAddress.html)
+ [DescribeEmailAddress](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeEmailAddress.html)
+ [UpdateEmailAddressMetadata](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateEmailAddressMetadata.html)
# Creación de plantillas de mensajes
Si diseña y envía con frecuencia un determinado tipo de mensaje, como un correo electrónico semanal o un recordatorio de cita, puede crearlo y guardarlo como plantilla de mensaje. A continuación, puede utilizar la plantilla como punto de partida cada vez que necesite enviar ese tipo de mensaje, en lugar de diseñar y escribir el mensaje de nuevo.
Este tema está dirigido a los administradores y gerentes de centros de contacto que desean crear plantillas de mensajes mediante el sitio web de Amazon Connect administración.
**sugerencia**
Aunque las plantillas de mensajes utilizan los agentes de Connect AI APIs, las plantillas de mensajes no conllevan una facturación adicional. Solo se paga por el precio del mensaje de chat o el precio del correo electrónico. Para obtener más información, consulte [Precios de Amazon Connect](https://aws.amazon.com/connect/pricing/).
## ¿Qué son las plantillas de mensajes?
Una *plantilla de mensaje* es un conjunto de contenido y configuración que puede crear, guardar y, a continuación, volver a utilizar en los mensajes que envíe. En algunas empresas, se denominan *plantillas de correo electrónico* y *plantillas de SMS*. Al crear una plantilla de mensaje, debe especificar el contenido que quiere reutilizar en varios componentes de los mensajes basados en la plantilla.
Al crear un mensaje, puede elegir una plantilla que se utilizará para el mensaje. Si elige una plantilla, Amazon Connect rellena el mensaje con el contenido y la configuración de la plantilla.
Puede diseñar los siguientes tipos de plantillas de mensaje en Amazon Connect:
+ **Plantillas de correo electrónico** para los mensajes de correo electrónico que usted envía en respuesta a los correos electrónicos de los clientes enviados a su contacto, o que los agentes pueden utilizar para responder a las preguntas más frecuentes. Las plantillas de correo electrónico pueden definir la estructura del correo electrónico para el agente, por ejemplo, para una firma, o pueden ser una respuesta completa.
+ **Plantillas de SMS** para mensajes de texto de SMS que envíe desde campañas o a una audiencia limitada como mensajes directos o de prueba.
+ **WhatsApp plantillas** para WhatsApp mensajes que envías desde campañas o a un público limitado como mensajes directos o de prueba.
Puede crear plantillas que tengan las siguientes características:
+ Formato de texto enriquecido (negrita, cursiva, subrayado, tachado, superíndice, subíndice), estilo de fuente de texto enriquecido (color, resaltado, tamaño, encabezado, familia, cita en bloque, bloque de código), caracteres especiales, emojis, listas (con viñetas, numeradas), alineaciones y sangrados, tablas, hipervínculos e imágenes incrustadas
+ Atributos de la plantilla de correo electrónico para definir detalles personalizados, como el nombre del cliente, el correo electrónico del cliente, el número de cuenta del cliente, el número de teléfono del cliente, la dirección del cliente y el nombre del agente.
+ Archivos adjuntos de hasta 1 MB. Para ver una lista de los tipos de archivos adjuntos admitidos, consulte [Amazon Connect especificaciones de funciones](feature-limits.md).
Al crear un mensaje de correo electrónico basado en una plantilla, Amazon Connect rellena el mensaje con el contenido y la configuración definidos en la plantilla.
## Cómo crear plantillas de mensajes
1. Inicia sesión en el sitio web de administración con una cuenta de administrador o una cuenta de usuario que **incluya Gestión de contenido** (**plantillas de mensajes**) y **cree** en su perfil de seguridad. Amazon Connect
1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**.
1. Si es la primera vez que crea plantillas, se le pedirá que cree una base de conocimientos, que es donde se almacenan las plantillas.
Una empresa puede tener varias bases de conocimiento, pero solo una de ellas puede estar asociada a las plantillas.
1. Seleccione **Crear plantilla**.
1. En **Canal**, selecciona un canal.
1. Introduzca un nombre para la plantilla en **Nombre**. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres.
1. En **Descripción (*opcional*)**, escriba una breve descripción de la plantilla. La descripción puede contener un máximo de 255 caracteres.
1. En **Perfiles de direccionamiento (*opcional*)**, introduzca los perfiles de direccionamiento para que los agentes puedan utilizar esta plantilla desde el espacio de trabajo del agente.
1. En función de si va a crear un **correo electrónico**, un **SMS** o una **WhatsApp**plantilla, realice una de las siguientes acciones:
Para plantillas de correo electrónico:
1. En **Email details (Detalles de correo electrónico)**, utilice las siguientes opciones para especificar el contenido de los mensajes que utilizan la plantilla:
+ En **Subject (Asunto)**, escriba el texto que desea mostrar en la línea de asunto del mensaje.
+ En **Cuerpo**, escriba el contenido que desea mostrar en el cuerpo del mensaje.
+ **Editor**: utilice el editor de texto enriquecido para introducir el contenido. Utilice la barra de herramientas de formato para aplicar formato y agregar enlaces u otros elementos. Para añadir archivos adjuntos, el administrador de TI debe habilitar la característica de archivos adjuntos para esta opción.
+ **Código**: introduzca manualmente el contenido HTML, como el formato, los enlaces y otras características que desee incluir en el mensaje.
Mediante los atributos, también puede incluir contenido personalizado en el asunto y el cuerpo de la plantilla. Para ello, agregue variables de mensaje que hagan referencia a atributos específicos que usted o Amazon Connect hayan creado, como un atributo que almacena el nombre de un usuario. Al utilizar variables de mensaje, puede mostrar contenido distinto para cada destinatario de un mensaje que utiliza la plantilla.
Para usar una variable de mensaje, elija el nombre de un atributo existente en el **buscador de atributos**. Amazon Connect lo pondrá en el mensaje. Puede copiarlo y pegarlo en la ubicación que desee. Para obtener más información, consulte [Cómo añadir contenido personalizado a plantillas de mensajes](personalize-templates.md).
![\[El buscador de atributos de la página de plantillas de mensajes\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/message-template-attribute-finder.png)
1. En **Encabezados *(opcional)***, puede añadir dos encabezados estáticos al mensaje de correo electrónico. Por ejemplo, para agregar un enlace para cancelar la suscripción con un clic a un correo electrónico promocional, añada los dos encabezados siguientes:
+ **List-Unsubscribe**: configúrelo en el enlace para cancelar la suscripción de su organización. El enlace debe admitir solicitudes HTTP POST para procesar la solicitud de cancelación de suscripción de los destinatarios.
+ **List-Unsubscribe-Post:** se establece en `List-Unsubscribe=One-Click`.
Incluir un enlace para cancelar la suscripción en el correo electrónico es una práctica recomendada y, en algunos países, es un requisito legal. Si la plantilla incluye un enlace con este atributo, deberá tener un sistema para gestionar las solicitudes de exclusión.
1. Cuando termine de introducir contenido y configuración para la plantilla, elija **Crear**.
1. Antes de poner la plantilla a disposición de los usuarios, le recomendamos que envíe un mensaje de correo electrónico de prueba para asegurarse de que la plantilla funciona según lo previsto.
1. Cuando esté listo para que la plantilla esté disponible en los flujos, en las campañas y para los agentes que utilizan el espacio de trabajo de agentes, complete los pasos para [activarla](#create-message-templates1).
**Para plantillas de SMS:**
1. En la sección **Detalles del SMS**, en el **cuerpo** del mensaje, escriba el mensaje. Use las instrucciones anteriores para personalizar el mensaje añadiendo atributos según sea necesario.
1. Cuando termine de introducir contenido y configuración para la plantilla, elija **Create (Crear)**.
1. Antes de poner la plantilla a disposición de los usuarios, le recomendamos que envíe un mensaje de texto de prueba para asegurarse de que la plantilla funciona según lo previsto.
1. Cuando desee que la plantilla de SMS esté disponible en el bloque **Enviar mensaje**, o si quiere que la plantilla de correo electrónico esté disponible para las campañas de correo electrónico, siga los pasos para [activarla](#create-message-templates1).
**Para WhatsApp las plantillas:**
1. En la sección de **WhatsApp detalles**, selecciona la plantilla en el menú desplegable. Ten en cuenta que solo las plantillas aprobadas por Meta se pueden usar para crear plantillas de mensajes. Asegúrese de que las plantillas importadas estén aprobadas en Meta Business WhatsApp Manager antes de continuar.
1. Defina un nombre para la plantilla y añada descripciones si es necesario.
1. Una vez que hayas seleccionado la plantilla aprobada por Meta, verás los detalles en formato **JSON (**cuerpo** y metadatos de la plantilla)**.
1. **Asignación de atributos:** para habilitar la entrega de mensajes personalizados en Amazon Connect, tendrá que asignar los metaatributos importados a texto personalizado. Al combinar los atributos de Connect existentes con texto sin formato, puede crear mensajes personalizados para sus clientes. Por ejemplo, es posible que veas Hello \$1\$11\$1\$1 en el **cuerpo** y que puedas elegir que coincidan en la lista `Attributes.Customer.FirstName` de atributos de Connect.
1. Hay varios tipos de botones que se pueden añadir a una plantilla de contenido. Si la plantilla seleccionada incluye botones, como la URL de un sitio web que incluye atributos, puede seleccionar Conectar atributos para mapear o escribir texto estático.
1. Cuando haya completado el mapeo de atributos, elija **Guardar**.
1. Antes de poner la plantilla a disposición de los usuarios, le recomendamos que envíe un mensaje de texto de prueba para asegurarse de que la plantilla funciona según lo previsto.
# Activación de una plantilla de mensaje
Para ayudarle a administrar el desarrollo y el uso de plantillas de mensajes individuales, Amazon Connect admite el control de versiones de todos los tipos de plantillas de mensajes. El control de versiones le proporciona una forma de crear un historial de cambios en una plantilla: cada versión es una instantánea de una plantilla en un momento determinado. El control de versiones también proporciona una forma de controlar el contenido y la configuración de los mensajes que utilizan una plantilla.
Solo puede activar las plantillas de mensajes que se hayan **guardado como una versión nueva**. Esto permite evitar que se activen accidentalmente plantillas que son borradores.
Cuando se **activa** una versión de plantilla, aparece como disponible para añadirla al [Bloque de flujo en Amazon Connect: Enviar mensaje](send-message.md) y puede estar disponible para los agentes en todo su espacio de trabajo.
**Cómo activar una plantilla de mensaje**
**Inicia sesión en el sitio web de administración con una cuenta de administrador o una cuenta de usuario que tenga en su perfil de seguridad la opción **Gestión de contenido** (**plantillas de mensajes**). Amazon Connect **
1. En el menú de navegación izquierdo, elija **Plantillas de mensajes**.
1. En la página **Plantillas de mensajes**, guarde la plantilla con la opción **Guardar como nueva versión**.
1. En la página **Plantillas de mensajes**, vuelva a abrir la plantilla que acaba de guardar.
1. Utilice el menú desplegable para elegir la versión de la plantilla que desee activar.
![\[El número de versión de una plantilla.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/message-template-version.png)
1. Seleccione **Activar**.
![\[El botón Activar de la página de la plantilla del mensaje.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/message-template-version-activate.png)
# Acerca del control de versiones de plantillas de mensajes
Cada vez que modifique una plantilla, puede especificar si desea guardar los cambios como un nuevo borrador de la plantilla o como una actualización del borrador existente más reciente de la plantilla. A medida que diseña, desarrolla y refina una plantilla, cada una de estas versiones sirve como instantánea que puede ayudarle a realizar un seguimiento del progreso y el estado de la plantilla. Es decir, puede usar el control de versiones para almacenar, realizar un seguimiento y administrar una plantilla a medida que cambia con el tiempo. Puedes:
+ Realizar un seguimiento del historial de una plantilla: para cada plantilla, Amazon Connect proporciona una lista de las versiones de la plantilla. En esta lista, se muestra el nombre de cada versión. La lista se ordena en orden cronológico descendente con la versión más reciente enumerada en primer lugar.
+ Consultar y comparar las versiones de una plantilla: al usar la lista de versiones, puede buscar versiones anteriores de una plantilla. Si elige una versión de la lista, Amazon Connect muestra el contenido y la configuración almacenados en esa versión.
+ Restaurar una versión anterior de una plantilla: si encuentra problemas en la versión más reciente de una plantilla, puede restaurar una versión anterior que no contenga los problemas. A continuación, puede guardar esa versión anterior como una nueva versión de la plantilla. La nueva versión se convierte entonces en la versión más reciente de la plantilla.
También puede utilizar el control de versiones para controlar qué versión de una plantilla se puede utilizar en los mensajes. Para ello, debe designar una versión específica como la versión activa de una plantilla. La versión activa suele ser la versión revisada y aprobada más recientemente para su uso en mensajes, dependiendo del flujo de trabajo de desarrollo y administración de plantillas de la organización.
Cuando designa una versión como la versión activa, habilita dicha versión para su uso en mensajes. A medida que una plantilla cambia con el tiempo, puede designar una versión diferente como la versión activa y puede cambiar esa designación en múltiples ocasiones.
# Cómo añadir contenido personalizado a plantillas de mensajes
Para entregar contenido dinámico y personalizado en mensajes que utilizan una plantilla, agregue *variables de mensaje* a la plantilla de mensaje. Una *variable de mensaje* es un marcador de posición que hace referencia a un atributo específico que usted o Amazon Connect han creado para almacenar información sobre los usuarios. Cada atributo normalmente corresponde a una característica de un usuario, como, por ejemplo, el nombre del usuario o la ciudad donde vive. Al agregar variables de mensaje a las plantillas, puede utilizar estos atributos para entregar contenido personalizado a cada destinatario de un mensaje que use una plantilla.
Si una plantilla contiene variables de mensaje, Amazon Connect reemplaza automáticamente cada variable por el valor actual correspondiente del atributo para cada destinatario. Lo hace cada vez que envía un mensaje que utiliza la plantilla. Esto significa que puede enviar contenido personalizado a cada destinatario sin crear varias versiones personalizadas de un mensaje o plantilla de mensaje. También puede sentirse seguro de que el mensaje contiene la información más reciente que tiene para un destinatario.
Por ejemplo, si su proyecto es una aplicación de fitness para corredores e incluye atributos para el nombre, la actividad preferida y el récord personal de cada usuario, podría usar las siguientes variables de texto y mensaje en una plantilla:
`Hi {{Attributes.Customer.FirstName}}, attached is information about the insurance plans we discussed.`
Cuando envía un mensaje que utiliza la plantilla, Amazon Connect sustituye las variables por el valor actual de cada atributo para cada destinatario. Los siguientes ejemplos muestran cómo lo hace.
**Ejemplo 1**
`Hi Sofia, attached is information about the insurance plans we discussed.`
**Ejemplo 2**
`Hi Alejandro, attached is information about the insurance plans we discussed.`
## Cómo añadir variables de mensaje
Puede agregar atributos de mensaje a una nueva plantilla que cree o a una plantilla existente. Si agrega variables a una plantilla existente, Amazon Connect no aplica necesariamente los cambios a los mensajes que utilizan la plantilla y que aún no se han enviado. Esto depende de la versión de la plantilla a la que agregue variables y de cómo configuró los mensajes que utilizan la plantilla.
**Para agregar una variable de mensaje a una plantilla de mensaje**
1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**.
1. En la página **Message templates (Plantillas de mensaje)**, realice una de las siguientes opciones:
+ Para crear una plantilla nueva y agregarle una variable de mensaje, elija **Create template (Crear una plantilla)**. A continuación, en la página de plantilla, introduzca un nombre para la plantilla y, opcionalmente, una descripción de la plantilla.
+ Para agregar una variable de mensaje a una plantilla existente, elija la plantilla a la que desea agregar una variable. A continuación, en la página de plantilla, elija **Edit (Editar)**. En **Template details (Detalles de la plantilla)**, utilice el selector de versiones para elegir la versión de la plantilla que desea utilizar como punto de partida. Si elige la versión más reciente, puede guardar los cambios directamente en esa versión de la plantilla. De lo contrario, puede guardar los cambios como una versión nueva de la plantilla.
1. En la sección de detalles del mensaje, determine dónde desea agregar una variable de mensaje. En el caso de las plantillas de correo electrónico, puede añadir variables al asunto o al cuerpo del mensaje. En el caso de las plantillas de SMS, puede añadir variables al cuerpo.
1. Coloque el cursor donde quiera que esté el atributo en el mensaje. Seleccione el **Buscador de atributos** y vaya al tipo de atributo para el que desea agregar una variable de mensaje.
![\[El buscador de atributos de la página de plantillas de mensajes\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/message-template-attribute-finder.png)
Puede elegir entre los siguientes tipos de atributos:
+ **Atributos del sistema**:
+ **CustomerEndpointAddress**: La dirección de correo electrónico del cliente que inició el contacto.
+ **SystemEmailAddress**: La dirección de correo electrónico a la que el cliente envió el correo electrónico.
+ **Nombre**: el nombre que se muestra en el correo electrónico que el cliente envió a su centro de contacto.
+ **Atributos del agente**:
+ **FirstName**
+ **LastName**
+ **Atributos del perfil del cliente**. Para ver una lista completa y las descripciones, consulte [Atributos de Perfiles de clientes](connect-attrib-list.md#customer-profiles-attributes).
+ **Atributos de recomendación**: cuando utilices Predictive Insights con campañas salientes, puedes incluir recomendaciones de productos personalizadas en tus plantillas de mensajes. Estos atributos están disponibles al configurar las recomendaciones en una campaña activada por eventos.
Se accede a cada recomendación mediante un índice, por ejemplo, `{{Attributes.Customer.Recommendations.[0].CatalogItem.Name}}` para la primera recomendación, `{{Attributes.Customer.Recommendations.[1].CatalogItem.Name}}` para la segunda, etc.
![\[Editor de plantillas de correo electrónico que muestra los atributos de las recomendaciones en el buscador de atributos y las recomendaciones de productos personalizadas en el cuerpo del mensaje.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/RecommendationAttributesInTemplate.png)
Para obtener más información sobre la configuración de las recomendaciones en las campañas, consulte[Creación de una campaña saliente con activadores de eventos](how-to-create-campaigns-using-event-triggers.md).
1. Al hacer clic en un atributo en el buscador de atributos, este se coloca automáticamente en el mensaje. Puede copiar y pegar el atributo en otra ubicación.
Tras pegar el atributo, Amazon Connect lo muestra entre dos conjuntos de llaves, como `{{Attributes.Agent.FirstName}}` La siguiente imagen muestra un mensaje de correo electrónico con tres atributos: el nombre y apellidos del cliente y el nombre del agente.
![\[Mensaje de correo electrónico con los atributos del mensaje\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/message-template-email-attributes.png)
1. Cuando termine, realice una de las siguientes acciones:
+ Si ha agregado variables de mensaje a una plantilla nueva, elija **Guardar**.
+ Si ha agregado variables de mensaje a una plantilla existente y desea guardar los cambios como una versión nueva de la plantilla, elija **Save as new version (Guardar como versión nueva)**.
+ Si ha agregado variables de mensaje a una plantilla existente y desea guardar los cambios como una actualización del borrador más reciente de la plantilla, elija **Guardar**. Si desea actualizar el borrador y crear una nueva versión a partir del borrador, elija **Guardar como nueva versión**.
# Uso de ayudantes de plantillas de mensajes
Con las plantillas de mensaje de Amazon Connect, los clientes pueden crear plantillas de mensajes reutilizables basadas en el lenguaje Handlebars.js. Los ayudantes ofrecen una variedad de características, como dar formato a un precio según la moneda de una región específica o agregar una ubicación basada en la zona horaria. Un ayudante puede usar una cadena o un entero específicos para el valor o una variable de mensaje de Amazon Connect específica.
Estas son las categorías de ayudantes (se describen en las secciones siguientes).
## Ayudantes predeterminados
En esta sección se describen los ayudantes **integrados** que proporciona Handlebars.
**importante**
El ayudante `with` integrado que proporciona Handlebars no es compatible. Sin embargo, todos los demás ayudantes de Handlebars son totalmente compatibles. Para ver la lista completa, consulte [Built-in Helpers](https://handlebarsjs.com/guide/builtin-helpers.html) en [handlebarsjs.com](https://handlebarsjs.com).
Estos son los ayudantes integrados:
+ `each`: itera una lista.
**nota**
El tamaño máximo de la lista es de 15 elementos.
+ `if`: evalúa una instrucción.
*cada*
Itera una lista. Este ayudante usa solo una instrucción de bloque. Si lo desea:
+ Pase `@index` en la solicitud para hacer referencia al índice de bucle actual.
+ Use el ayudante `this` para hacer referencia al elemento actual que está iterando.
+ Devuelva la respuesta del ayudante en una lista, con la etiqueta ``.
**Uso**
`{{#each value}}`
El valor en la posición `{{@index}}` es `{{this}}`.
`{{else}}`
La condición es falsa.
`{{/each}}`
`each` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/each}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, `each` se utiliza para devolver una lista de los colores favoritos de un usuario. Para `false`, se devuelve una instrucción `else`. Si la solicitud es esta:
`{{#each User.UserAttributes.FavoriteColors}}`
`{{this}}`
`{{else}}`
*You have no favorite colors.*
`{{/each}}` devuelve
+ *red*
+ *blue*
+ *yellow*
para una declaración verdadera.
*if*
Evalúa si algo es cierto y devuelve una respuesta en función de la evaluación.
**Uso**
`{{#if value}}`
El valor no es indefinido
`{{else}}`
El valor es indefinido
`{{/if}}`
`if` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/if}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, el ayudante `if` se utiliza para evaluar si el nombre de un usuario es el primero. Si se encuentra el nombre, se devuelve un saludo que pasa por el nombre del usuario en la respuesta. De lo contrario, la instrucción `else` devuelve un saludo alternativo.
`{{#if User.UserAttributes.FirstName.[0]}}`
`Hello {{User.UserAttributes.FirstName.[0]}},`
`{{else}}`
*Hello,*
`{{/if}}`
devuelve *Hello, Jane* si el `if` ayudante es verdadero.
## Ayudantes condicionales
En esta sección se describen los ayudantes **condicionales**.
Los ayudantes condicionales se pueden usar en una sola línea o en una instrucción de bloque. Puede personalizar la respuesta independientemente del método de ayudante que utilice. Puede pasar ayudantes condicionales adicionales en las instrucciones de una sola línea y en las de bloque. Los siguientes asistentes condicionales muestran el uso primero de una sola línea y, después, de una instrucción de bloque mediante una cláusula `else` opcional. Estos son los ayudantes condicionales:
+ `and`: compara si todos los elementos pasados son iguales.
+ `eq`: comprueba si dos elementos son iguales.
+ `gt`: comprueba si un elemento es mayor que otro.
+ `gte`: comprueba si un elemento es mayor que otro o igual a otro.
+ `if`: evalúa si algo es verdadero.
+ `lt`: comprueba si un elemento es inferior a otro.
+ `lte`: comprueba si un elemento es inferior o igual a otro.
+ `neq`: evalúa si dos elementos no son iguales.
+ `not`: invierte la respuesta de una operación booleana.
+ `or`: compara si alguno de los elementos del argumento es igual.
*and*
Compara si *todos* los elementos transferidos en un argumento son iguales y, a continuación, devuelve la respuesta en función del resultado. Este ayudante se puede utilizar para valores no booleanos. Debe transferir al menos dos elementos para la condición.
**Uso**
+ `{{and valuea valueb valuec valued yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#and valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/and}}`
`and` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/and}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, `eq` se utiliza en la instrucción de bloque `and` para determinar si las dos cadenas pasadas para los atributos `Location.City ` y `Location.Country` son verdaderas. Si ambas condiciones son iguales, se devuelve una instrucción verdadera. Si alguno de esos atributos es falso, se devuelve una instrucción `else`.
`{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}`
*You live in Los Angeles and the US.*
`{{else}}`
*You don’t live in Los Angeles and the US.*
`{{/and}}`
*eq*
Comprueba si dos elementos son iguales o si el valor de un elemento es igual al de una cadena pasada.
**Uso**
+ `{{eq valuea valueb yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#eq valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/eq}}`
`eq` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/eq}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, `eq` se utiliza para evaluar si el valor de `User.UserAttributes.FavoriteColors.[0]` es*Red*. Si la respuesta es `true`, se devuelve una instrucción verdadera. Si la respuesta es `false`, se devuelve una instrucción `else`.
`{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}`
*Your favorite color is red.*
`{{else}}`
*You don't like red.*
`{{/eq}}`
*gt*
Prueba si el valor de un elemento es mayor que otro.
**Uso**
+ `{{gt valuea valueb yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#gt valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/gt}}`
`gt` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/gt}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, el ayudante compara el valor del `User.UserAttributes.UserAge.[0]` atributo con una cadena *17* para comprobar si la edad del usuario es mayor de 17 años. Si la respuesta es `true`, se devuelve una instrucción verdadera. Si la respuesta es `false`, se devuelve una instrucción `else`.
`{{#gt User.UserAttributes.UserAge.[0] "17"}}`
*You are old enough to rent a car.*
`{{else}}`
*You are not old enough to rent a car.*
`{{/gt}}`
*gte*
Prueba si el valor de un elemento es mayor o igual que otro.
`Usage`
+ `{{gte valuea valueb yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#gte valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/gte}}`
`get` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/gte}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, el ayudante compara el `User.UserAttributes.UserAge.[0]` atributo con una cadena *18* para comprobar si la edad del usuario es mayor o igual a 18 años. Si la respuesta es `true`, se devuelve una instrucción verdadera. Si la respuesta es `false`, se devuelve una instrucción `else`.
`{{#gte User.UserAttributes.UserAge.[0] "18"}}`
*You are old enough to rent a car.*
`{{else}}`
*You are not old enough to rent a car.*
`{{/gte}}`
*if*
Evalúa si algo es cierto y devuelve una respuesta en función de la evaluación.
**Uso**
+ `{{#if value}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#if value}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/if}}`
`if` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/if}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, el ayudante se utiliza para evaluar si el nombre de un usuario es el primero. Si se encuentra el nombre, se devuelve un saludo que pasa por el nombre del usuario en la respuesta. De lo contrario, la instrucción else devuelve un saludo alternativo.
`{{#if User.UserAttributes.FirstName.[0]}}`
*Hello* `{{User.UserAttributes.FirstName.[0]}}`*,*
`{{else}}`
*Hello,*
`{{/if}}`
devuelve *Hello Jane,* si el ayudante es verdadero.
*lt*
Prueba si el valor de un elemento es inferior al valor de otro.
**Uso**
+ `{{lt valuea valueb yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#lt valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/lt}}`
`lt` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/lt}}` de cierre en la instrucción de bloque.
**Ejemplo**
En este ejemplo, el ayudante compara el `User.UserAttributes.UserAge.[0]` atributo con una cadena *18* para comprobar si el usuario tiene menos de 18 años. Si la respuesta es `true`, se devuelve una instrucción verdadera. Si la respuesta es `false`, se devuelve una instrucción `else`.
`{{#lt User.UserAttributes.UserAge.[0] "18"}}`
*You are not old enough to rent a car.*
`{{else}}`
*You are old enough to rent a car.*
`{{/lt}}`
*lte*
Prueba si el valor de un elemento es inferior o igual que otro.
**Uso**
+ `{{lte valuea valueb yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#lte valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/lte}}`
`lte` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/lte}}` de cierre en la instrucción de bloque.
**Ejemplo**
En esta sentencia de bloque, el ayudante compara el `User.UserAttributes.UserAge.[0]` atributo con una cadena *17* para comprobar si el usuario tiene 17 años o menos. Si la respuesta es `true`, se devuelve una instrucción verdadera. Si la respuesta es `false`, se devuelve una instrucción `else`.
`{{#lte User.UserAttributes.Age.[0] "17"}}`
*You are not old enough to rent a car.*
`{{else}}`
*You are old enough to rent a car.*
`{{/lte}}`
*neq*
Pruebe si dos elementos *no* son iguales.
**Uso**
+ `{{neq valuea valueb yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#neq valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/neq}}`
`neq` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/neq}}` de cierre en la instrucción de bloque.
**Ejemplo**
En esta instrucción de bloque, el atributo `User.UserAttributes.FavoriteColors.[0]` se compara con una cadena, `Red`. Si la respuesta es `true`, se devuelve una instrucción verdadera. Si la respuesta es `false`, se devuelve una instrucción `else`.
`{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}`
*You do not like red.*
`{{else}}`
*You like red.*
`{{/neq}}`
*no*
Invierte la respuesta de una operación booleana, de modo que si `not` es una comparación positiva, se devuelve una instrucción `true`. Si la respuesta es falsa, se devuelve una instrucción else.
**Uso**
+ `{{not value yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición.
+ `{{#not value}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/not}}`
`not` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/not}}` de cierre en la instrucción de bloque.
**Ejemplo**
En esta sentencia de bloque, el `User.UerAttributes.FavoriteColors.[0]` atributo se compara con una cadena *red* mediante el `eq` asistente. A continuación, el ayudante `not` devuelve lo contrario del ayudante `eq`. Si la respuesta devuelve un color que no sea*red*, se devuelve `true` una sentencia A. Si se devuelve la respuesta*red*, se devuelve una `else` declaración que indica que es falsa.
`{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}`
*You do not like red.*
`{{else}}`
*You like red.*
`{{/not}}`
**Ejemplo**
En este ejemplo,
`{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}`
devuelve false si `User.UserAttributes.FavoriteColors.[0]` es así*red*.
*o*
Compara si *algunos* de los elementos en el argumento son iguales y, a continuación, devuelve la respuesta en función del resultado. Este ayudante se puede utilizar para valores no booleanos.
**Uso**
+ `{{or valuea valueb valuec valued yes='y' no='n'}}`
Puede reemplazar *y* y *n* con otros valores, como *yes* y*no*, o cualquier otra cadena que desee que se devuelva, según la condición. Debe transferir al menos dos elementos para la condición.
+ `{{#or valuea valueb}}`
La condición es verdadera.
`{{else}}`
La condición es falsa.
`{{/or}}`
`or` debe ir precedido de un signo de almohadilla (`#`) y concluir con `{{/or}}` de cierre en la instrucción de bloque.
**Ejemplo**
En esta instrucción de bloque `or`, se comparan adicionalmente dos cadenas del atributo `Location.City` mediante el ayudante `eq`. Si alguno de esos atributos es `true`, se devuelve una instrucción. Si una o más de las respuestas es `false`, se devuelve una instrucción `else`.
`{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}`
*You live on the West Coast of the United States.*
`{{else}}`
*You do not live on the West Coast of the United States.*
`{{/or}}`
## Ayudantes de cadenas
En esta sección se describen los siguientes ayudantes de **cadenas**:
+ `abbreviate`: trunca un valor.
+ `capitalize`: escribe en mayúscula cada palabra entre espacios en blanco.
+ `capitalizeFirst`: pone en mayúscula el primer carácter de un valor.
+ `center`: centra un valor.
+ `cut`: recorta un valor.
+ `dateFormat`: establece el estilo de fecha.
+ `inflect`: devuelve una cadena singular o plural en función del recuento.
+ `join`: se une a una matriz, un iterador o un objeto iterable.
+ `ljust`: justifica un valor en el margen izquierdo.
+ `lower`: convierte un valor a minúsculas.
+ `now`: imprime la fecha actual.
+ `ordinalize`: ordinaliza un valor numérico.
+ `replace`: sustituye una cadena por otra.
+ `rjust`: justifica un valor en el margen derecho.
+ `slugify`: convierte un valor a minúsculas y elimina los caracteres que no son palabras, convierte los espacios en guiones y elimina los espacios en blanco del final.
+ `stripTags`: elimina las etiquetas [X]HTML de un valor.
+ `substring`: devuelve una nueva cadena como subcadena de un valor pasado.
+ `upper`: convierte el valor pasado a mayúsculas.
+ `yesno`: sustituye verdadero, falso y no por Sí, No y Quizás.
*abreviar*
Trunca un valor si el valor supera el número especificado. Los espacios en blanco se incluyen en el recuento de longitudes. Se muestra una elipsis en la respuesta para indicar un valor truncado. La elipsis cuenta para el valor truncado de la respuesta. Este tipo de ayudante es útil si tiene una tabla grande y un espacio mínimo. Al truncar los valores de una celda, se obtiene un aspecto más uniforme de la tabla.
**Uso**
`{{abbreviate value X}}`, *X* sustituyéndola por un valor numérico que indique el número de caracteres que se deben conservar. Los números negativos no se admiten.
**Ejemplo**
En este ejemplo, `abbreviate` se utiliza para truncar `User.UserAttributes.LastName.[0]` a seis (6) caracteres. La respuesta incluye una elipsis, cuyos puntos cuentan para el total de seis caracteres.
`{{abbreviate User.UserAttributes.LastName.[0] 6}}` devuelve
*Ale...*si *Alejandro* es el valor de`[0]`.
*escribir en mayúsculas*
Escriba en mayúsculas cada palabra entre espacios en blanco.
**Uso**
`{{capitalize value}}`
**Ejemplo**
En este ejemplo, se aplica el uso inicial de mayúsculas a cada palabra de la entrada `Attributes.description.[0]`.
`{{capitalize Attributes.description.[0]}}`
Si `Attributes.description.[0]` devuelve
*My First Post*, si el valor de `Attributes.description.[0]` es*my first post*.
*capitalizeFirst*
Escribe en mayúsculas el primer carácter de un valor.
**Uso**
`{{capitalizeFirst value}}`
**Ejemplo**
En este ejemplo, el uso de mayúsculas se aplica al primer carácter de la primera palabra de la entrada `Attributes.description.[0]`.
`{{capitalizeFirst Attributes.description.[0]}}` devuelve
*My first post*, si el valor de `Attributes.description.[0]` es*my first post*.
**Ejemplo**
*centro*
Centra el valor en un campo de un ancho determinado mediante el número especificado. Si lo desea, puede pasar un carácter para que se muestre como relleno o dejar el campo en blanco. Si no se pasa ningún carácter, se utiliza un espacio en blanco.
**Uso**
`{{center value size=X [pad=" "}}`, *X* sustituyéndolo por un valor numérico.
Si `pad` se mantiene en blanco, se utiliza un espacio en blanco como relleno en la respuesta. Si pasa un carácter, ese carácter se muestra en cada espacio del relleno. Los números negativos no se admiten.
**Ejemplo**
En este ejemplo, el valor de `Location.City ` se centra con un tamaño de*19*.
`{{center Location.City size=19}}` devuelve
*" Los Angeles "*Si `Location.City` lo es*Los Angeles*. Tenga en cuenta que las comillas que se muestran en el resultado del ejemplo se proporcionan solo para enfatizar.
*cortar*
Elimina el valor especificado de una cadena.
**Uso**
`{{cut value [" "]}}`, que sustituye el espacio dentro del parámetro de comillas por el valor que se va a cortar. Si no se pasa ningún valor de parámetro, se utiliza un espacio en blanco.
**Ejemplo**
En este ejemplo, se elimina la letra *e* del `Location.City` atributo.
`{{cut Location.City "e"}}` devuelve
*Los Angls*si `[Location.City` lo es*Los Angeles*.
*dateFormat*
Establece el estilo de fecha predeterminado para la fecha en cualquier respuesta. Para obtener una lista de la zona horaria IDs, consulte[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
**Uso**
`{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}`
El parámetro `format` debe ser uno de:
+ “`full`”: formato de fecha completo. Por ejemplo: *Tuesday, September 19, 2020*
+ “`long`”: formato de fecha largo. Por ejemplo: *September 19, 2020*
+ “`medium`”: formato de fecha medio. Por ejemplo: *Sept 19, 2020*
+ “`short`”: formato de fecha corto. Por ejemplo: *9/19/20*
+ “`pattern`”: utiliza un formato de patrón de fechas personalizado. Para obtener más información acerca de patrones de fecha, consulte [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html).
“`locale`”: utiliza un formato de fecha basado en una configuración local determinada. Para obtener más información sobre configuraciones locales, consulte [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).
Si no se pasa un formato, `medium` se utiliza de forma predeterminada.
**Ejemplo**
En este ejemplo, la `[0]` entrada `User.UserAttributes.StartDate.[0]` es **09/19/2020** y se envía un mensaje a un usuario con el formato de `full` fecha en función de la zona *America/Los\$1Angeles* horaria.
`We can meet with you any time on ``{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.` devuelve
*We can meet with you any time on Tuesday, September 19, 2020.*
*modular*
Devuelve una cadena singular o plural en función del valor del recuento.
**Uso**
`{{inflect count singular plural [includeCount=false]}}`
+ Ingrese las formas singular y plural de la cadena que desee incluir en el argumento.
+ Si `includeCount` se establece en `false`, no se devuelve ningún recuento en la respuesta. Si se establece en `true`, `count` se incluye en la respuesta.
**Ejemplo**
Los siguientes ejemplos muestran la inflexión de una compra de manzanas, con y sin `includeCount`.
`Thank you for your purchase of {{inflect 3 apple apples includeCount=false}}.` devuelve:
*Thank you for your purchase of apples.*
Si `includeCount` está establecido en `true`, entonces la respuesta es
*Thank you for your purchase of 3 apples.*
*unirse*
Se une a una matriz, un iterador o un objeto iterable. La respuesta devuelve una lista en la que cada valor de la lista está concatenado por el carácter que pase en `join`. Por ejemplo, es posible que separe los valores con una coma (`,`). El valor de este ayudante debe ser una lista sin un índice de posición de atributos. Por ejemplo, podría ser `Attributes.custom_attribute`.
**Uso**
`{{join value " // " [prefix=""] [suffix=""]}}`
**Ejemplo**
En este ejemplo, se devuelve una lista de colores, separada por una coma y un espacio (`", "`):
`{{join Attributes.favorite_colors ", "}}` devuelve
*blue, red, green*si `Attributes.favorite_colors` es la lista*blue,red,green*.
*ljust*
Justifica el valor en el margen izquierdo y agrega espacio a la derecha para que la longitud del valor coincida con el número. Los números negativos no se admiten.
Si lo desea, puede pasar un carácter para mostrar para `pad` o dejar el campo en blanco. Si deja en blanco el valor `pad`, el valor predeterminado es un espacio en blanco.
**Uso**
`{{ljust value size=X [pad=" "]}}`, donde *X* es la longitud total del valor, incluidos los espacios en blanco.
**Ejemplo**
En este ejemplo, se aplica un valor de *15 * justificación a la izquierda de Location.City.
`{{ljust Location.City size=15}}` devuelve
*"Los Angeles "*si el valor de `Location.City` es. *Los Angeles* Tenga en cuenta que las comillas que se muestran en el resultado del ejemplo se proporcionan solo para enfatizar.
*lower*
Convierte un valor a minúsculas.
**Uso**
`{{lower value}}`
**Ejemplo**
En este ejemplo, la entrada `[0]` para `User.UserAttributes.LastName.[0]` se cambia a minúscula.
`{{lower User.UserAttributes.LastName.[0]}}` devuelve
*santos*si *Santos* es el valor de`[0]`.
*now*
Imprime la fecha actual en función del ID de zona horaria pasado. Para obtener una lista de la zona horaria IDs, consulte[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
**Uso**
`{{now ["format"] [tz=timeZoneId] [locale=localeID]}}`
El parámetro `format` debe ser uno de:
+ “`full`”: formato de fecha completo. Por ejemplo: *Tuesday, September 19, 2020*
+ “`long`”: formato de fecha largo. Por ejemplo: *September 19, 2020*
+ “`medium`”: formato de fecha medio. Por ejemplo: 19 de septiembre de 2020
+ “`short`”: formato de fecha corto. Por ejemplo: 19/9/20
+ “`pattern`”: un patrón de fechas. Para obtener más información acerca de patrones de fecha, consulte [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html).
“`locale`”: utiliza un formato de fecha basado en una configuración local determinada. Para obtener más información sobre configuraciones locales, consulte [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).
Si no se pasa un formato, `medium` se utiliza de forma predeterminada.
**Ejemplo**
En este ejemplo, se devuelve la fecha actual de Los Ángeles con un formato `medium`.
`{{now "medium" tz=America/Los_Angeles}}` devuelve
*Sept 19, 2020*.
*ordinalizar*
Ordinaliza el valor numérico pasado en el argumento. Por ejemplo, *1* se ordinaliza como *1st* y *2* como*2nd*. Solo se admiten valores numéricos.
**Uso**
`{{ordinalize [number]}} `
**Ejemplo**
En este ejemplo, la entrada `[0]` de `User.UserAttributes.UserAge` se ordinaliza y se devuelve junto con un mensaje.
`Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!`devuelve *22* ordinalizado como. *22nd*
*Congratulations on your 22nd birthday\$1*
*replace*
Sustituye una cadena por otra. Una cadena o un valor numérico deben ser literales. No se admiten caracteres comodín.
**Uso**
`{{replace stringToReplace replacementValue}}`
**Ejemplo**
En este ejemplo, un guion bajo (\$1) sustituye un espacio en blanco.
`{{replace Location.City " " "_"}}` devuelve
*Los\$1Angeles*si lo `Location.City ` es*Los Angeles*.
*rjust*
Justifica el valor en el margen derecho y agrega espacio a la derecha para que la longitud del valor coincida con el número. Los números negativos no se admiten.
Si lo desea, puede pasar un carácter para mostrar para `pad` o mantener el campo en blanco. Si mantiene en blanco el valor de `pad`, el valor predeterminado es un espacio en blanco.
**Uso**
`{{rjust value size=X [pad=" "]}}`, donde *X* es la longitud total del valor, incluidos los espacios en blanco.
**Ejemplo**
En este ejemplo, *15* se aplica un valor de justificación correcto de al `Location.City` atributo.
`{{rjust Location.City size=15}}` devuelve
*" Los Angeles" *. si `Location.City` es*Los Angeles*. Tenga en cuenta que las comillas que se muestran en el resultado se proporcionan solo para enfatizar.
*slugify*
Convierte el valor pasado a minúsculas, elimina los caracteres que no son palabras (alfanuméricos y guiones bajos), convierte los espacios en guiones y elimina los espacios en blanco del principio y del final.
**Uso**
`{{slugify value}}`
**Ejemplo**
En este ejemplo, slugify se realiza para el atributo `Location.City`.
`{{slugify Location.City}}` devuelve
*los-angeles*si `Location.City` lo es*Los Angeles*.
*stripTags*
Elimina las etiquetas [X]HTML de un valor.
**Uso**
`{{stripTags value}}`
**Ejemplo**
En este ejemplo, las etiquetas HTML del usuario. UserAttributes.interest. [0] se eliminan.
`{{stripTags User.UserAttributes.interests.[0]}}` devuelve
*Art*, si lo `User.UserAttributes.interests.[0]` es`Art
`.
*subcadena*
Devuelve una nueva cadena como subcadena del valor pasado. La longitud y la posición vienen determinadas por los parámetros `startOffset` y `endOffset`, que deben ser números enteros. Los números negativos no se admiten. Si `endOffset` no se transfiere, la subcadena utiliza el valor final original de la cadena.
**Uso**
`{{substring value startOffset [endOffset]}}`
**Ejemplo**
En este ejemplo, se aplica un desplazamiento de 4 y un endOffset de 9 al atributo Location.City.
`{{substring Location.City 4 9}} `devuelve
`Angel`si Los Ángeles es el valor de `Location.City` nosotros*Los Angeles*.
*upper*
Convierte el valor pasado a mayúsculas.
**Uso**
`{{upper value}}`
**Ejemplo**
En este ejemplo, la entrada `[0] ` del atributo `User.UserAttributes.LastName` se convierte completamente en mayúsculas.
`{{upper User.UserAttributes.LastName.[0]}}`devuelve
*ROE*si el `User.UserAttributes.LastName.[0]` valor es*Roe*.
*yesno*
Sustituye `true`, `false` y `NULL` con `Yes`, `No` y `Maybe`.
**Uso**
`{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}`
**Ejemplo**
En este ejemplo, el atributo `IsUserSubscribed` devuelve si un usuario está suscrito a una lista determinada.
`{{yesno Attributes.IsUserSubscribed}}` devuelve
*yes*si `Attributes.IsUserSubscribed` lo es*true*.
## Ayudantes matemáticos y codificación
En esta sección se describen los ayudantes **matemáticos y de codificación**.
+ `add`: devuelve la suma de dos números.
+ `ceiling`: redondea un entero hasta su límite matemático.
+ `decode64`: decodifica un valor codificado en base64 en una cadena.
+ `divide`: devuelve el cociente de dos números.
+ `encode64`: codifica una cadena con base64.
+ `floor`: redondea un entero hasta su límite matemático.
+ `md5`— Calcula una cadena pasada mediante el MD5 algoritmo.
+ `modulo`: devuelve el resto de dos números utilizando puntos flotantes.
+ `multiply`: devuelve el producto de dos números.
+ `round`: redondea un decimal al número entero más cercano.
+ `sha256`: coloca una cadena pasada mediante SHA-256.
+ `sha512`: coloca una cadena pasada mediante SHA-512.
+ `subtract`: devuelve la diferencia de dos números.
+ `uuid`: genera al azar un UUID en formato de 128 bits.
*adición*
Devuelve la suma de dos números junto con los puntos flotantes.
**Uso**
`{{add arg1 arg2}}`
**Ejemplo**
`{{add 5 2.3}} `devuelve
*7.3*
*límite*
Redondea un entero hasta su límite matemático, que es el número entero más alto más cercano al valor pasado.
**Uso**
`{{ceiling value}}`
**Ejemplo**
`{{ceiling 5.23}}` devuelve
*6*
*decode64*
Decodifica un valor codificado en base64 en una cadena.
**Uso**
`{{decode64 "string"}}`
**Ejemplo**
`{{decode64 "SGVsbG8gd29ybGQ="}}` devuelve
*Hello World*
*dividir*
Devuelve el cociente de dos números, incluidos los puntos flotantes.
**Uso**
`{{divide arg1 arg2}}`
**Ejemplo**
`{{divide 5 2.3}}` devuelve
*2.17391304*
*encode64*
Codifica la cadena pasada en el argumento mediante base64.
**Uso**
`{{encode64 "string"}}`
**Ejemplo**
`{{encode64 "Hello World"}}`
*SGVsbG8gd29ybGQ=*
*floor*
Redondea un entero hasta su límite matemático, que es el número entero más bajo más cercano al valor pasado.
**Uso**
`{{floor value}}`
**Ejemplo**
`{{floor 5.23}}` devuelve
*5*
*md5*
Aplica un código hash a una cadena pasada mediante el MD5 algoritmo.
**Uso**
`{{md5 "string"}}`
**Ejemplo**
`{{md5 "Hello World"}}`
*3e25960a79dbc69b674cd4ec67a72c62*
*módulo*
Devuelve el resto de dos números utilizando puntos flotantes.
**Uso**
`{{modulo arg1 arg2}}`
**Ejemplo**
`{{modulo 7 2}}` devuelve
*1*
*multiplicar*
Devuelve el producto de dos números, con los puntos flotantes.
**Uso**
`{{multiply arg1 arg2}}`
**Ejemplo**
`{{multiply 5 2.3}}` devuelve
*11.5*
*round*
Redondea un decimal al número entero más cercano.
**Uso**
`{{round value}}`
**Ejemplo**
`You spent an average of {{round 19.21}} minutes on our website each day.` devuelve:
*You spent an average of 19 minutes on our website each day.*
*sha256*
Coloca una cadena pasada mediante la seguridad criptográfica SHA-256.
**Uso**
`{{sha256 "string"}}`
**Ejemplo**
`{{sha256 "Hello World"}}` devuelve
*a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e*
*sha512*
Coloca una cadena pasada mediante la seguridad criptográfica SHA-512.
**Uso**
`{{sha512 "string"}}`
**Ejemplo**
`{{sha512 "Hello World"}}` devuelve
*2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b*
*restar*
Devuelve la diferencia de dos números, con los puntos flotantes.
**Uso**
`{{subtract arg1 arg2}}`
**Ejemplo**
`{{subtract 5 2.3}} ` devuelve
*2.7*
*uuid*
Genera al azar un UUID en formato de 128 bits estándar. No es necesario ingresar ningún valor en el argumento.
**Uso**
`{{uuid}}`
**Ejemplo**
`{{uuid}} ` devuelve
**95f36680-152c-4052-99ec-cc3cdf7ca594**
## Parciales insertados
Aunque técnicamente no son una ayuda, los parciales insertados son una forma de Handlebar de optimizar las plantillas que incluyen cadenas repetidas, lo que facilita la reutilización. Para obtener más información, consulte [Parciales insertados](https://handlebarsjs.com/guide/partials.html#inline-partials) en [handlebarsjs.com](https://handlebarsjs.com).
**Uso**
`{{#* inline "inlineName"}}Content to reuse{{/inline}}`
Para hacer referencia al contenido del parcial insertado en otro lugar, use:
` {{> inlineName}}`
**Ejemplo**
En el siguiente ejemplo se crea una función parcial insertada que incluye el nombre del destinatario y, si está disponible, los apellidos agregando el siguiente código al principio de la plantilla:
`{{#* inline "fullName"}}`
`{{User.UserAttributes.FirstName.[0]}} {{#if User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}`
`{{/inline}}`
Después de crear la función parcial `fullName`, puede incluirla en cualquier lugar de la plantilla agregando delante del nombre de la función parcial un símbolo `>` (mayor que), seguido de un espacio, como en el siguiente ejemplo: `{{> fullName}}`.
*` Hello {{> fullName}}`*
devuelve el nombre y apellidos del usuario si es verdadero, por ejemplo,*Hello Jane Doe*. De lo contrario, si no se encuentra ningún apellido, *Hello Jane* se devuelve.
Los handlebars incluyen características adicionales además de las documentadas aquí. Para obtener más información, consulte [handlebarsjs.com](https://handlebarsjs.com/).
## Uso de variables con ayudantes de plantillas de mensajes
Los nombres de los atributos personalizados de Amazon Connect admiten espacios. Para tener un atributo personalizado llamado `"Last Name"`, debe formatear el atributo como `Attributes.[Last Name]`.
## Uso de ayudantes anidados
Puede agrupar varios ayudantes de plantillas de mensajes uno dentro del otro. El siguiente ejemplo muestra cómo aplicar formato a dos ayudantes: `{{ first helper (second helper)}}`. El segundo ayudante se procesa primero, seguido del primer ayudante. Recuerde que el primer ayudante siempre determina el resultado. Los ayudantes posteriores deben estar anidados dentro del ayudante anterior de la siguiente manera: `{{ first helper (second helper (third helper) )}}`.
El siguiente ejemplo muestra cómo anidar dos ayudantes para cambiar **JANE** a **Jane**: `{{capitalizeFirst (lower "JANE")}}`. `lower` primero convierte **JANE** en **jane**. Luego `capitalizeFirst` convierte **jane** en **Jane**.
# Los perfiles de seguridad no afectan a la autorización del agente para ver un hilo de correo electrónico
Cualquier usuario con el siguiente permiso en su perfil de seguridad tiene acceso para leer los correos electrónicos que gestiona o los que forman parte de un hilo en el que participa: **Panel de control de contacto (CCP)** - **Acceso al panel de control de contactos** - **Acceder**.
![\[La opción de acceso al panel de control de contacto en la página de perfiles de seguridad\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/access-ccp-perm.png)
Este comportamiento de autorización está habilitado de forma predeterminada. No requiere configurar ningún permiso o configuración adicional.
Este comportamiento se basa en las siguientes claves de contexto:
1. `connect:UserArn`: representa al usuario que tiene acceso a un contacto individual.
1. `connect:ContactAssociationId`: representa la asociación de contactos a la que tiene acceso el usuario. Para el canal de correo electrónico, una asociación de contactos siempre representa un hilo de correo electrónico.
1. `connect:Channel`: representa el canal de contactos al que tiene acceso el usuario. Para el canal de correo electrónico, esta contextKey es siempre `EMAIL`.
No recomendamos usar `connect:ContactAssociationId` en la misma política que `connect:UserArn`, ya que podría resultar en un evento no-op. Como la clave de condición `connect:UserArn` es más restrictiva, todos los contactos no gestionados por el usuario correspondiente, independientemente del acceso que tengan a las cadenas de correo electrónico, recibirán un `Deny` cuando intenten acceder.
Puede usar `connect:Channel` de forma aislada para limitar el acceso a canales específicos. Los valores aceptados son `VOICE`, `CHAT`, `TASK` o `EMAIL`. Consulte la API [Contacto](https://docs.aws.amazon.com/connect/latest/APIReference/API_Contact.html).
A continuación se muestran los datos relacionados con los contactos APIs que admiten estas claves de contexto:
1. [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)
1. [UpdateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContact.html)
1. [ListContactReferences](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactReferences.html)
1. [TagContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagContact.html)
1. [UntagContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_UntagContact.html)
1. [UpdateContactRoutingData](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactRoutingData.html)
1. [GetContactAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetContactAttributes.html)
1. [UpdateContactAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactAttributes.html)
1. [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html)
1. [StartContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactRecording.html)
1. [StopContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactRecording.html)
1. [ResumeContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_ResumeContactRecording.html)
1. [SuspendContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_SuspendContactRecording.html)
1. [UpdateContactSchedule](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactSchedule.html)
1. [TransferContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_TransferContact.html)
1. [StartScreenSharing](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartScreenSharing.html)