**Aviso de fin de soporte:** el 30 de octubre de 2026, AWS finalizará el soporte para Amazon Pinpoint. Después del 30 de octubre de 2026, ya no podrá acceder a la consola de Amazon Pinpoint ni a los recursos de Amazon Pinpoint (puntos de conexión, segmentos, campañas, recorridos y análisis). Para obtener más información, consulte [Fin de soporte de Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: en** lo APIs que respecta a los SMS, este cambio no afecta a los mensajes de voz, a las notificaciones push móviles, a las OTP y a la validación de números de teléfono, y son compatibles con la mensajería para el usuario AWS final. 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. # Plantillas de mensajes de Amazon Pinpoint Si diseña y envía con frecuencia un determinado tipo de mensaje, como un boletín 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. 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 para cualquiera de los proyectos de Amazon Pinpoint. Al crear una plantilla de mensaje, debe especificar el contenido que quiere reutilizar en varios componentes de los mensajes basados en la plantilla. Estos componentes se denominan *partes de la plantilla*. Pueden contener texto estático, contenido personalizado, imágenes y otros elementos de diseño, en función del tipo de plantilla. Un elemento de plantilla también puede contener configuración específica del canal. Por ejemplo, un elemento de plantilla en una plantilla de notificación de inserción puede especificar un sonido personalizado que reproducir o una imagen que mostrar cuando un destinatario recibe una notificación de inserción basada en la plantilla. Al crear un mensaje, puede elegir una plantilla que se utilizará para el mensaje. Si elige una plantilla, Amazon Pinpoint 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 Pinpoint: + **Plantillas de correo electrónico** para mensajes de correo electrónico que envíe desde campañas o recorridos, o a una audiencia limitada como mensajes directos o de prueba. + **Plantillas de notificación push** para notificaciones push que envíe desde campañas o a una audiencia limitada como mensajes directos o de prueba. + **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. + **Plantillas de voz** para mensajes de voz que envíe como mensajes directos o de prueba. Además de admitir varios tipos de plantillas de mensajes, Amazon Pinpoint admite el control de versiones de plantillas de mensajes. El control de versiones proporciona una forma de diseñar y cambiar una plantilla a lo largo del tiempo, al tiempo que crea y mantiene un historial de la plantilla. El control de versiones también proporciona una forma de especificar qué versión de una plantilla se puede utilizar en los mensajes. Para obtener más información sobre las versiones de plantillas, consulte [Administración de versiones de plantillas de mensajes](message-templates-versioning.md). En los temas de este capítulo se explica cómo crear y administrar plantillas de mensajes para la cuenta de Amazon Pinpoint. **Topics** + [Creación de plantillas de correo electrónico](message-templates-creating-email.md) + [Creación de plantillas integradas en la aplicación](message-templates-creating-inapp.md) + [Creación de plantillas de notificaciones push](message-templates-creating-push.md) + [Creación de plantillas de SMS](message-templates-creating-sms.md) + [Creación de plantillas de voz](message-templates-creating-voice.md) + [Adición de contenido personalizado a plantillas de mensajes](message-templates-personalizing.md) + [Uso de ayudantes de plantillas de mensajes](message-template-helpers.md) + [Administración de plantillas de mensaje](message-templates-managing.md) + [Administración de versiones de plantillas de mensajes](message-templates-versioning.md) # Creación de plantillas de correo electrónico Una *plantilla de correo electrónico* es un tipo de plantilla de mensaje que incluye el contenido y la configuración que desea crear, guardar y reutilizar en los mensajes de correo electrónico que envía para cualquiera de los proyectos de Amazon Pinpoint. Puede utilizar una plantilla de correo electrónico en cualquier tipo de mensaje de correo electrónico que cree y envíe mediante Amazon Pinpoint. Cuando cree una plantilla de correo electrónico, deberá especificar el contenido y a configuración que quiera reutilizar en varios componentes de los mensajes de correo electrónico basados en la plantilla. Estos componentes, denominados *partes de la plantilla*, pueden ser el asunto del mensaje, el cuerpo del mensaje o ambos. El contenido puede ser texto estático, contenido personalizado, imágenes u otros elementos de diseño. Un elemento de plantilla también puede ser una configuración, como el cuerpo del mensaje que se va a utilizar si la aplicación de correo electrónico de un destinatario no muestra contenido HTML. Al crear un mensaje de correo electrónico basado en una plantilla, Amazon Pinpoint rellena el mensaje con el contenido y la configuración que definió en la plantilla. **Para crear una plantilla de correo electrónico** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. Seleccione **Crear plantilla**. 1. En **Channel (Canal)**, elija **Email**. 1. En **Template details (Detalles de la plantilla)**, escriba el nombre de la plantilla en **Template name (Nombre de plantilla)**. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (\$1) o guiones (-). 1. De forma opcional, en **Version description (Descripción de la versión)**, escriba una breve descripción de la plantilla. La descripción puede contener hasta 500 caracteres. 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 **Message (Mensaje)**, escriba el contenido que desea mostrar en el cuerpo del mensaje. **sugerencia** Para el cuerpo del mensaje, puede especificar el contenido mediante la vista de HTML o de diseño. Con la vista HTML, puede introducir manualmente el contenido HTML, incluidos el formato, los enlaces y otras funcionalidades que desee incluir en el mensaje. En la vista Diseño, puede utilizar un editor de texto enriquecido para introducir el contenido. Utilice la barra de herramientas de formato para aplicar formato y agregar enlaces y otras características al contenido. Para cambiar de vista, elija **HTML** o **Design (Diseño)** en el selector de vistas situado encima del editor de mensajes. 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 Pinpoint crearon como, por ejemplo, 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 Pinpoint crea una variable de mensaje para el atributo y la copia en el portapapeles. Pegue la variable en la ubicación que desee. Para obtener más información, consulte [Adición de contenido personalizado a plantillas de mensajes](message-templates-personalizing.md). 1. **nota** Debe configurar un rol de envío de orquestación de correo electrónico antes de poder utilizar encabezados de correo electrónico. Para obtener más información, consulte [Creación de un rol de envío de orquestación de correo electrónico en Amazon Pinpoint](channels-email-orchestration-sending-role.md). En **Encabezados**, seleccione **Agregar nuevos encabezados** para agregar hasta 15 encabezados para el mensaje de correo electrónico. Para obtener una lista de los encabezados compatibles, consulte [Amazon SES header fields](https://docs.aws.amazon.com/ses/latest/dg/header-fields.html) en la [Guía para desarrolladores de Amazon Simple Email Service](https://docs.aws.amazon.com//ses/latest/dg/Welcome.html). + En **Nombre**, ingrese el nombre del encabezado. + En **Valor**, ingrese el valor del encabezado. (Opcional) Para agregar un enlace para cancelar la suscripción con un clic a un correo electrónico promocional, añada los dos encabezados siguientes: 1. Cree un encabezado con `List-Unsubscribe` en **Nombre** y en **Valor** ingrese el enlace para cancelar la suscripción. El enlace debe admitir solicitudes HTTP POST para procesar la solicitud de cancelación de suscripción de los destinatarios. 1. Cree un encabezado con `List-Unsubscribe-Post` en **Nombre** y establezca `List-Unsubscribe=One-Click` en **Valor**. 1. De forma opcional, en **Plain text version (Versión de texto sin formato)**, introduzca el contenido que desea mostrar en el cuerpo de los mensajes que utilizan la plantilla y que se envían a los destinatarios cuyas aplicaciones de correo electrónico no muestran contenido HTML. 1. Si ha añadido contenido personalizado a la plantilla utilizando variables de mensaje, especifique un valor predeterminado para cada variable. Si lo hace, Amazon Pinpoint sustituye la variable por el valor que especifique, si un valor correspondiente no existe para un destinatario. Le recomendamos que haga esto para cada variable de la plantilla. Para especificar valores predeterminados para variables, amplíe la sección **Default attribute values (Valores de atributo predeterminados)**. A continuación, introduzca el valor predeterminado que desea utilizar para cada variable. Si no especifica un valor predeterminado y no existe ningún valor para el destinatario, Amazon Pinpoint no enviará el mensaje. 1. Cuando termine de introducir contenido y configuración para la plantilla, elija **Create (Crear)**. Para probar la plantilla antes de utilizarla en un mensaje de correo electrónico que vaya a enviar a los usuarios, puede [enviar un mensaje de prueba](messages-email.md) que utilice la plantilla. Si lo hace, asegúrese de completar primero el paso 9 para especificar los valores predeterminados para todas las variables de la plantilla. De lo contrario, es posible que el mensaje no se envíe o que no se procese correctamente. ## Incluir enlaces para cancelar la suscripción en las plantillas de mensajes 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. En los enlaces para cancelar la suscripción, puede incluir un atributo especial`ses:tags="unsubscribeLinkTag:value"`, donde *value* aparece cualquier valor que defina. Si un destinatario hace clic en un enlace que contiene este atributo especial, Amazon Pinpoint lo cuenta como un evento de exclusión con fines analíticos (por ejemplo, en la métrica de porcentaje de exclusión de la [página de información general de análisis](analytics-overview.md)). En el siguiente ejemplo se muestra la sintaxis para este tipo de enlace: ``` Unsubscribe ``` Si la plantilla incluye un enlace con este atributo, aún deberá desarrollar un sistema para gestionar las solicitudes de exclusión. Para ver un ejemplo de un sistema que procesa las solicitudes de exclusión, consulte la [solución Amazon Pinpoint Preference Center](https://aws.amazon.com/solutions/implementations/amazon-pinpoint-preference-center/) en la biblioteca de AWS soluciones. **nota** La solución del centro de preferencias de Amazon Pinpoint ahora tiene carácter orientativo. La solución ya no se puede implementar, pero el diagrama de arquitectura y el código se han dejado como referencia. # Creación de plantillas integradas en la aplicación Una *plantilla integrada en la aplicación* es una plantilla para los mensajes que envía desde Amazon Pinpoint a los usuarios de la aplicación. Use plantillas integradas en la aplicación para crear, guardar y reutilizar la configuración y el contenido de los mensajes integrados en la aplicación. Cuando cree una plantilla integrada en la aplicación, deberá especificar la configuración y el contenido que quiera reutilizar en el cuerpo de los mensajes integrados en la aplicación que usan la plantilla. Al crear un mensaje con la plantilla, Amazon Pinpoint rellena el mensaje con la configuración y el contenido que definió. Los mensajes en la aplicación son altamente personalizables. Pueden incluir botones que abren sitios web o llevan a los usuarios a partes específicas de la aplicación. Puede configurar los colores de fondo y del texto, colocar el texto y agregar imágenes a la notificación. Puede enviar un solo mensaje o crear un *carrusel* que contenga hasta cinco mensajes únicos por los que se pueden desplazar los usuarios. **Creación de una plantilla integrada en la aplicación** 1. Abra la consola de Amazon Pinpoint en [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/). 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. Seleccione **Crear plantilla**. 1. En **Canal**, elija **Mensajería integrada en la aplicación**. 1. En **Template details (Detalles de la plantilla)**, escriba el nombre de la plantilla en **Template name (Nombre de plantilla)**. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (\$1) o guiones (-). 1. De forma opcional, en **Version description (Descripción de la versión)**, escriba una breve descripción de la plantilla. La descripción puede contener hasta 500 caracteres. 1. En la sección de **detalles de los mensajes integrados en la aplicación**, en **Diseño**, elija el tipo de diseño de la plantilla de mensaje. Puede elegir entre las siguientes opciones: + **Banner superior**: un mensaje que aparece como un banner en la parte superior de la página. + **Banner en la parte inferior**: un mensaje que aparece como un banner en la parte inferior de la página. + **Banner central**: un mensaje que aparece como una notificación en el medio de la página. + **Pantalla completa**: un mensaje que cubre toda la pantalla. + **Modal**: un mensaje que aparece en una ventana delante de la página. + **Carrusel**: un formato desplazable de hasta cinco mensajes únicos. 1. En **Encabezado**, configure el título que aparece al principio del mensaje. Si ha creado un mensaje de carrusel, debe crear el primer mensaje del carrusel, que incluye el encabezado. 1. Para que el **texto del encabezado** se muestre en el banner. Puede ingresar hasta 64 caracteres. 1. Para **color del texto del encabezado**, elija el color del texto del encabezado. Si lo desea, puede ingresar valores RGB o un código de color hexadecimal. 1. Para la **alineación del encabezado**, elija si desea que el texto esté justificado a la **izquierda**, en el **centro** o a la **derecha**. 1. En **Mensaje**, configure el cuerpo del mensaje. 1. Para **Mensaje**, ingrese el texto del cuerpo del mensaje. El mensaje puede contener hasta 150 caracteres. 1. Para **color del texto**, elija el color del texto del cuerpo del mensaje. Si lo desea, puede ingresar valores RGB o un código de color hexadecimal. 1. Para la **alineación del texto**, elija si desea que el texto esté justificado a la **izquierda**, en el **centro** o a la **derecha**. 1. (Opcional) Cambie el color de fondo del mensaje. En **Fondo**, elija un color de fondo para el mensaje. Si lo desea, puede ingresar valores RGB o un código de color hexadecimal. 1. (Opcional) Agregue una imagen al mensaje. En **URL de la imagen**, ingrese la URL de la imagen que desea que aparezca en el mensaje. Solo se aceptan archivos .jpg y .png. Las dimensiones de la imagen dependen del tipo de mensaje: + Para un **banner**, la imagen debe ser de 100 píxeles por 100 píxeles o una relación de aspecto de 1:1. + Para un **carrusel**, la imagen debe ser de 300 píxeles por 200 píxeles o una relación de aspecto de 3:2. + Para un mensaje de **pantalla completa**, la imagen debe ser de 300 píxeles por 200 píxeles o una relación de aspecto de 3:2. 1. (Opcional) Agregue un botón al mensaje. En el **botón principal**, haga lo siguiente: 1. Elija **Agregar botón principal**. 1. En **Texto del botón**, ingrese el texto que se mostrará en el botón. Puede ingresar hasta 64 caracteres. 1. (Opcional) En el **color del texto del botón**, elija un color para el texto del botón. Si lo desea, puede ingresar valores RGB o un código de color hexadecimal. 1. (Opcional) Para **Color de fondo**, elija un color de fondo para el botón. Si lo desea, puede ingresar valores RGB o un código de color hexadecimal. 1. (Opcional) Para el **radio del borde**, ingrese un valor de radio. Los valores más bajos dan como resultado esquinas más afiladas, mientras que los números más altos dan como resultado esquinas más redondeadas. 1. En **Acciones**, elija el evento que se produce cuando el usuario pulsa el botón: + **Cerrar**: omite el mensaje. + **Ir a la URL**: abre un sitio web. + **Ir al enlace profundo**: abre una aplicación o abre un lugar concreto de una aplicación. Si desea que el comportamiento de los botones sea diferente para los distintos tipos de dispositivos, puede invalidar la acción predeterminada. En **Acción**, utilice las pestañas para elegir el tipo de dispositivo para el que desee modificar el comportamiento de los botones. Por ejemplo, elija **iOS** para modificar el comportamiento de los botones de los dispositivos iOS. A continuación, elija **Invalidar las acciones predeterminadas**. Por último, especifique una acción. 1. (Opcional) Agregue un botón secundario al mensaje. En el **botón secundario**, elija **Agregar botón secundario**. Siga los procedimientos del paso anterior para configurar el botón secundario. 1. (Opcional) Agregue datos personalizados al mensaje. Los datos personalizados son pares clave-valor que se entregan con el mensaje. Por ejemplo, es posible que desee pasar un código promocional junto con el mensaje. Si va a enviar un mensaje de carrusel, puede agregar datos personalizados a cada uno de los mensajes de carrusel. Para agregar datos personalizados, haga lo siguiente: 1. En **Datos personalizados**, elija **Agregar nuevo elemento**. 1. Ingrese una **Clave**. Por ejemplo, podría ser *PromoCode*. 1. Ingrese un **Valor** para la clave. El *PromoCode* puede ser *12345*. 1. Cuando se envía el mensaje, el código *12345* se incluye en el mensaje. 1. Para agregar más pares clave-valor, elija **Agregar nuevo elemento**. Puede agregar hasta 10 pares clave-valor al mensaje. Cuando termine de agregar datos personalizados, continúe con el siguiente paso. 1. Si el mensaje es un carrusel, puede agregar hasta cuatro mensajes únicos más. Para agregar mensajes a un carrusel, expanda la sección de **información general del carrusel**. A continuación, elija **Agregar mensaje nuevo**. Repita los pasos anteriores para configurar el mensaje. A medida que agrega mensajes al carrusel, la página de **vista previa** se actualiza mostrando iconos en la parte inferior de la página que muestran el número de mensajes incluidos en el carrusel. La siguiente imagen muestra un carrusel con dos mensajes: ![\[\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/images/channels-inapp-carousel.png) 1. Cuando haya terminado, elija **Crear**. # Creación de plantillas de notificaciones push Una *plantilla de notificaciones de inserción* es una plantilla de mensaje que con contenido y ajustes que puede utilizar con los proyectos de Amazon Pinpoint. Al utilizar una plantilla para enviar una notificación de inserción, Amazon Pinpoint rellena la notificación con el contenido y la configuración definidos en la plantilla. Cuando cree una plantilla de notificación push, deberá especificar el contenido y la configuración que quiera reutilizar en varios componentes de las notificaciones push basados en la plantilla. Estos componentes, denominados *partes de la plantilla*, pueden contener texto (como el título o el cuerpo de una notificación) o ajustes (como un sonido personalizado que se reproduce cuando un destinatario recibe una notificación). Para personalizar una plantilla para canales de notificaciones de inserción específicos, puede crear varios conjuntos de partes de plantilla en cada plantilla: un conjunto predeterminado y, opcionalmente, uno o más conjuntos específicos del servicio. El conjunto predeterminado incluye el contenido y la configuración que desea utilizar de forma predeterminada para cualquier canal de notificación push. Un conjunto específico del servicio tiene el contenido y la configuración que desee usar para un servicio de notificaciones específico, como Apple Push Notification Service o Firebase Cloud Messaging. Al agregar configuraciones específicas de servicio a una plantilla, puede personalizar las notificaciones para que muestren contenido único a cada tipo de dispositivo de destinatario. También puede [crear plantillas que contengan datos de mensajes sin procesar](#message-templates-creating-push-raw). Esta opción es más avanzada, pero resulta útil si desea especificar la configuración de un canal específico que no está presente en la plantilla de notificaciones de inserción estándar de Amazon Pinpoint. ## Creación de una plantilla de notificaciones de inserción estándar Complete este procedimiento para especificar el contenido básico del mensaje, como el título, el cuerpo del mensaje, la imagen y la acción. Para especificar el contenido sin procesar del mensaje, complete el procedimiento en [Creación de una plantilla de notificación de inserción con datos de mensajes sin procesar](#message-templates-creating-push-raw) en su lugar. **Para crear una plantilla de notificación push** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. Seleccione **Crear plantilla**. 1. En **Channel (Canal)**, elija **Push notifications (Notificaciones de inserción)**. 1. En **Template details (Detalles de la plantilla)**, escriba el nombre de la plantilla en **Template name (Nombre de plantilla)**. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (\$1) o guiones (-). 1. De forma opcional, en **Version description (Descripción de la versión)**, escriba una breve descripción de la plantilla. La descripción puede contener hasta 500 caracteres. 1. En **Detalles de notificación de inserción**, haga lo siguiente: + En **Tipo de notificación**, elija **Mensaje estándar**. + Para **Título**, escriba el título que desea mostrar en la parte superior del cuerpo del mensaje. + En **Body (Cuerpo)**, escriba el texto que desea mostrar en el cuerpo del mensaje de notificación. **sugerencia** Puede incluir contenido personalizado en el título y el cuerpo de la plantilla. Para ello, agregue variables de mensaje que hagan referencia a atributos específicos como un atributo que almacena el nombre de un usuario. Al utilizar variables de mensaje, puede mostrar contenido distinto para cada destinatario de una notificación de inserción que utiliza la plantilla. Para usar una variable de mensaje, elija el nombre de un atributo existente en el **buscador de atributos**. Amazon Pinpoint crea una variable de mensaje para el atributo y la copia en el portapapeles. Pegue la variable en la ubicación que desee. Para obtener más información, consulte [Adición de contenido personalizado a plantillas de mensajes](message-templates-personalizing.md). + En **Custom alert sound (Sonido de alerta personalizado)**, escriba el nombre del archivo de audio que contiene el sonido personalizado que desea reproducir cuando un destinatario reciba la notificación push. Este nombre debe coincidir con el nombre de un archivo de audio en el dispositivo del destinatario. + En **Action (Acción)**, elija lo que quiere que haga el dispositivo de un destinatario si este pulsa la notificación push: + **Abrir la aplicación**: abra la aplicación tráigala a primer plano si se envió al fondo. + **Ir a una URL**: abra el navegador predeterminado en el dispositivo del destinatario y cargue una página web específica. Si elige esta opción, introduzca la dirección URL de la página web en el cuadro **Destination URL (URL de destino)**. + **Abrir un enlace profundo**: abra la aplicación y muestre la interfaz de un usuario específico en la aplicación. Si elige esta opción, introduzca la dirección URL de la interfaz en el cuadro **Destination URL (Dirección URL de destino)**. 1. (Opcional) Para personalizar la plantilla para servicios de notificación de inserción específicos, elija la pestaña de servicios adecuada en **Personalizar contenido para servicios de inserción individuales**. A continuación, elija las opciones que desee para ese servicio. Si selecciona la casilla de verificación **Invalidar contenido de inserción predeterminado** en la pestaña para un servicio, Amazon Pinpoint sustituye automáticamente el contenido y la configuración predeterminados que eligió en el paso anterior por las opciones que elija en la pestaña. Si desea conservar el contenido y la configuración predeterminados y solo personalizar la plantilla para que utilice configuraciones específicas de canal adicionales, no active esta casilla de verificación. **Apple** Usa estas opciones para especificar el contenido y la configuración personalizados de las notificaciones push que envíes a través del canal del servicio de notificaciones push de Apple (APNs) a las aplicaciones que se ejecutan en dispositivos iOS. Además del contenido y la configuración estándares, puede incluir una imagen personalizada o un vídeo en las notificaciones push que utilicen la plantilla. Para ello, introduzca la URL del archivo de imagen o vídeo en el cuadro **iOS media (Multimedia de iOS)**. La URL debe ser de acceso público. De lo contrario, el dispositivo del destinatario no podrá mostrar la imagen o el vídeo. **Google** Utilice estas opciones para especificar el contenido personalizado y la configuración de las notificaciones de inserción que envíe a través del canal de Google Firebase Cloud Messaging (FCM) a las aplicaciones que se ejecutan en dispositivos Android. Además del contenido y la configuración estándares, puede elegir las siguientes opciones para mostrar imágenes personalizadas en las notificaciones push que utilicen la plantilla: + **Imagen de Android**: ingrese la URL de la imagen que se mostrará en el cuerpo de la notificación de inserción. + **Icono de Android**: ingrese la URL de la imagen de icono grande que se mostrará en la vista de contenido de la notificación de inserción. + **Icono de Android pequeño**: ingrese la URL de la imagen de icono pequeña que se mostrará en la barra de estado y en la vista de contenido de la notificación de inserción. **Amazon** Utilice estas opciones para especificar el contenido personalizado y la configuración de las notificaciones push que envíe a través del canal Amazon Device Messaging (ADM) a aplicaciones que se ejecutan en dispositivos Amazon, como las tablets Kindle Fire. Además del contenido y la configuración estándares, puede elegir las siguientes opciones para mostrar imágenes personalizadas en las notificaciones push que utilicen la plantilla: + **Imagen de Android**: ingrese la URL de la imagen que se mostrará en el cuerpo de la notificación de inserción. + **Icono de Android**: ingrese la URL de la imagen de icono grande que se mostrará en la vista de contenido de la notificación de inserción. + **Icono de Android pequeño**: ingrese la URL de la imagen de icono pequeña que se mostrará en la barra de estado y en la vista de contenido de la notificación de inserción. **Baidu** Utilice estas opciones para especificar el contenido personalizado y la configuración de las notificaciones push que envíe a través del canal de Baidu a las aplicaciones que utilizan la plataforma Baidu Cloud Push. Además del contenido y la configuración estándares, puede elegir las siguientes opciones para mostrar imágenes personalizadas en las notificaciones push que utilicen la plantilla: + **Imagen de Android**: ingrese la URL de la imagen que se mostrará en el cuerpo de la notificación de inserción. + **Icono de Android**: ingrese la URL de la imagen de icono grande que se mostrará en la vista de contenido de la notificación de inserción. + **Icono de Android pequeño**: ingrese la URL de la imagen de icono pequeña que se mostrará en la barra de estado y en la vista de contenido de la notificación de inserción. 1. Si ha añadido contenido personalizado a la plantilla utilizando variables de mensaje, especifique un valor predeterminado para cada variable. Si lo hace, Amazon Pinpoint sustituye la variable por el valor que especifique, si un valor correspondiente no existe para un destinatario. Le recomendamos que haga esto para cada variable de la plantilla. Para especificar valores predeterminados para variables, amplíe la sección **Default attribute values (Valores de atributo predeterminados)**. A continuación, introduzca el valor predeterminado que desea utilizar para cada variable. Si no especifica un valor predeterminado y no existe ningún valor para el destinatario, Amazon Pinpoint no enviará el mensaje. 1. Cuando termine de introducir contenido y configuración para la plantilla, elija **Create (Crear)**. ## Creación de una plantilla de notificación de inserción con datos de mensajes sin procesar Complete este procedimiento para especificar manualmente la carga útil del mensaje sin procesar. Solo necesita especificar la carga del mensaje sin procesar si desea utilizar una característica de un servicio de notificaciones de inserción específico que Amazon Pinpoint no le permite configurar. Si necesita especificar el contenido del mensaje sin procesar, debería completar el procedimiento en [Creación de una plantilla de notificaciones de inserción estándar](#message-templates-creating-push-standard) en su lugar. Un ejemplo de un caso de uso que requiere el uso de una plantilla de mensaje sin procesar es cuando se desean enviar mensajes a los usuarios del navegador web Safari del escritorio. En este caso, debe incluir un atributo específico en la carga útil del mensaje sin procesar. Para obtener más información, consulte [Sending a message](https://docs.aws.amazon.com/push-notifications/latest/userguide/reference-send-message.html) en la *Guía del usuario de Mensajes push para usuarios finales de AWS *. **Para crear una plantilla de notificación push** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. Seleccione **Crear plantilla**. 1. En **Channel (Canal)**, elija **Push notifications (Notificaciones de inserción)**. 1. En **Template details (Detalles de la plantilla)**, escriba el nombre de la plantilla en **Template name (Nombre de plantilla)**. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (\$1) o guiones (-). 1. De forma opcional, en **Version description (Descripción de la versión)**, escriba una breve descripción de la plantilla. La descripción puede contener hasta 500 caracteres. 1. En **Detalles de las notificaciones de inserción**, para **Tipo de notificación**, elija **Mensaje sin procesar**. El editor de mensajes muestra un esquema del código que se va a utilizar para la plantilla. En el editor de mensajes, escriba la configuración que desee utilizar para cada servicio de notificaciones de inserción incluida la configuración opcional (como imágenes, sonidos y acciones) que desee especificar para la plantilla. Para obtener más información, consulte la documentación de los servicios de notificación de inserción que utiliza. 1. Cuando termine de ingresar contenido de mensaje sin formato, elija **Crear**. Para probar la plantilla antes de utilizarla en una notificación push que vaya a enviar a los usuarios, puede [enviar una notificación de prueba](messages-mobile.md) que utilice la plantilla. Si lo hace, asegúrese de completar primero el paso 10 para especificar los valores predeterminados para todas las variables de la plantilla. De lo contrario, es posible que la notificación push no se envíe o que no se procese correctamente. # Creación de plantillas de SMS Una *plantilla de SMS* es un tipo de plantilla de mensaje que incluye contenido y configuraciones que desea crear, guardar y reutilizar en mensajes de texto SMS que envía para cualquiera de los proyectos de Amazon Pinpoint. Puede utilizar una plantilla de SMS en los mensajes de texto que envíe desde campañas o a una audiencia limitada como mensajes directos o de prueba. Cuando cree una plantilla de SMS, deberá especificar la configuración y el contenido que quiera reutilizar en el cuerpo de los mensajes de texto basados en la plantilla. Al crear un mensaje basado en la plantilla, Amazon Pinpoint rellena el mensaje con la configuración y el contenido definidos en la plantilla. **Para crear una plantilla de SMS** 1. Abra la consola de Amazon Pinpoint en [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/). 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. Seleccione **Crear plantilla**. 1. En **Channel (Canal)**, elija **SMS**. 1. En **Template details (Detalles de la plantilla)**, escriba el nombre de la plantilla en **Template name (Nombre de plantilla)**. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (\$1) o guiones (-). 1. De forma opcional, en **Version description (Descripción de la versión)**, escriba una breve descripción de la plantilla. La descripción puede contener hasta 500 caracteres. 1. En **SMS details (Detalles de SMS)**, para **Mensaje (Message)**, escriba el contenido que desea mostrar en el cuerpo de los mensajes que utilizan la plantilla. El cuerpo del mensaje puede contener hasta 1600 caracteres. **sugerencia** Puede incluir contenido personalizado en el cuerpo de la plantilla. Para ello, agregue variables de mensaje que hagan referencia a atributos específicos que usted o Amazon Pinpoint crearon como, por ejemplo, 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 Pinpoint crea una variable de mensaje para el atributo y la copia en el portapapeles. Pegue la variable en la ubicación que desee. Para obtener más información, consulte [Adición de contenido personalizado a plantillas de mensajes](message-templates-personalizing.md). 1. Si ha añadido contenido personalizado a la plantilla utilizando variables de mensaje, especifique un valor predeterminado para cada variable. Si lo hace, Amazon Pinpoint sustituye la variable por el valor que especifique, si un valor correspondiente no existe para un destinatario. Le recomendamos que haga esto para cada variable de la plantilla. Para especificar valores predeterminados para variables, amplíe la sección **Default attribute values (Valores de atributo predeterminados)**. A continuación, introduzca el valor predeterminado que desea utilizar para cada variable. Si no especifica un valor predeterminado y no existe ningún valor para el destinatario, Amazon Pinpoint no enviará el mensaje. 1. Cuando termine de introducir contenido y configuración para la plantilla, elija **Create (Crear)**. Para probar la plantilla antes de utilizarla en un mensaje que vaya a enviar a los usuarios, puede [enviar un mensaje de prueba](messages-sms.md) que utilice la plantilla. Si lo hace, asegúrese de completar primero el paso 8 para especificar los valores predeterminados para todas las variables de la plantilla. De lo contrario, es posible que el mensaje no se envíe o que no se procese correctamente. # Creación de plantillas de voz Una *plantilla de voz* es un tipo de plantilla de mensaje que incluye contenido y configuración que desea para crear, guardar y reutilizar en mensajes de voz que envía para cualquiera de los proyectos de Amazon Pinpoint. Puede utilizar una plantilla de voz en los mensajes de voz que envíe como mensajes directos o de prueba. Al crear una plantilla de voz, debe especificar el contenido y la configuración que quiere reutilizar en varios componentes de los mensajes de voz basados en la plantilla. Estos componentes se denominan *partes de la plantilla*. Pueden contener el texto del guion del mensaje o la configuración, como la voz que se utilizará al entregar el mensaje. El guion de mensaje puede incluir texto estático y, opcionalmente, contenido personalizado que defina. Al crear un mensaje de voz basado en una plantilla, Amazon Pinpoint rellena el mensaje con el contenido y la configuración definidos en la plantilla. **Para crear una plantilla de voz** 1. Abra la consola de Amazon Pinpoint en [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/). 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. Seleccione **Crear plantilla**. 1. En **Channel (Canal)**, elija **Voice (Voz)**. 1. En **Template details (Detalles de la plantilla)**, escriba el nombre de la plantilla en **Template name (Nombre de plantilla)**. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (\$1) o guiones (-). 1. De forma opcional, en **Version description (Descripción de la versión)**, escriba una breve descripción de la plantilla. La descripción puede contener hasta 500 caracteres. 1. En **Voice message details (Detalles para mensaje de voz)**, para **Message (Mensaje)**, introduzca el texto que desea utilizar como guion de mensaje para los mensajes que utilizan la plantilla. El guion puede contener hasta 10 000 caracteres y debe aparecer como texto sin formato. **sugerencia** Puede incluir contenido personalizado en el guion de mensaje. Para ello, agregue variables de mensaje que hagan referencia a atributos específicos que usted o Amazon Pinpoint crearon como, por ejemplo, un atributo que almacena el nombre de un usuario. Al utilizar variables de mensaje, puede reproducir contenido distinto para cada destinatario de un mensaje que utilice la plantilla. Para usar una variable de mensaje, elija el nombre de un atributo existente en el **buscador de atributos**. Amazon Pinpoint crea una variable de mensaje para el atributo y la copia en el portapapeles. Pegue la variable en la ubicación que desee. Para obtener más información, consulte [Adición de contenido personalizado a plantillas de mensajes](message-templates-personalizing.md). 1. En **Idioma y región**, elija el idioma en el que está escrito el texto del script del mensaje. Amazon Pinpoint usa esta configuración para determinar qué fonemas y otros ajustes específicos del idioma se deben usar al convertir el texto del guion en voz. 1. En **Voice (Voz)**, elija la voz que desea que lea el mensaje a los destinatarios. Cada voz se crea con hablantes nativos del idioma, por lo que existen variaciones entre las voces, incluso dentro del mismo idioma. Por lo tanto, es buena idea probar cada voz con su guion. La lista de voces cambia según el idioma que haya elegido en el paso 8. En la mayoría de los casos, la lista incluye al menos una voz masculina y una voz femenina. En algunos casos, solo hay una voz disponible. Admitimos continuamente idiomas adicionales y creamos voces para los idiomas admitidos. 1. Elija **Play message (Reproducir mensaje)** para comprobar cómo sonará el mensaje cuando se entregue a los destinatarios. Ajuste el contenido y la configuración hasta que la plantilla tenga el diseño que desee. 1. Si ha añadido contenido personalizado a la plantilla utilizando variables de mensaje, especifique un valor predeterminado para cada variable. Si lo hace, Amazon Pinpoint sustituye la variable por el valor que especifique, si un valor correspondiente no existe para un destinatario. Le recomendamos que haga esto para cada variable de la plantilla. Para especificar valores predeterminados para variables, amplíe la sección **Default attribute values (Valores de atributo predeterminados)**. A continuación, introduzca el valor predeterminado que desea utilizar para cada variable. Si no especifica un valor predeterminado y no existe ningún valor para el destinatario, Amazon Pinpoint no enviará el mensaje. 1. Cuando termine de introducir contenido y configuración para la plantilla, elija **Create (Crear)**. # Adición de 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 Pinpoint ha 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 Pinpoint sustituye 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 {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!` Cuando envía un mensaje que utiliza la plantilla, Amazon Pinpoint 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, congratulations on your new half marathon record of 1:42:17!` **Ejemplo 2** `Hi Alejandro, congratulations on your new 5K record of 20:52!` Si no existe un valor de atributo para un destinatario, Amazon Pinpoint puede sustituir una variable por un valor predeterminado que especifique para la variable. Por ejemplo, si un usuario de su aplicación de fitness no ha elegido su actividad preferida, usted podría usar `running` como valor predeterminado para la variable `{{User.UserAttributes.Activity}}`. En este caso, Amazon Pinpoint sustituye la variable tal como se muestra en los siguientes ejemplos: **Ejemplo 1** `Hi Jane, congratulations on your new running record of 1:42:17!` **Ejemplo 2** `Hi John, congratulations on your new running record of 20:52!` Si no especifica un valor predeterminado y no existe un valor para un destinatario, Amazon Pinpoint omite todo el texto de la variable cuando envía un mensaje a dicho destinatario. Por ejemplo: `Hi Mary, congratulations on your new record of 20:52!` Se recomienda especificar un valor predeterminado para cada variable que se incluya en una plantilla. ## Adición de 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 Pinpoint no aplica necesariamente los cambios a los mensajes existentes que utilizan la plantilla y que aún no se han enviado, como los mensajes de campaña que están programados para enviarse más adelante. 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 obtener más información, consulte [Administración de versiones de plantillas de mensajes](message-templates-versioning.md). **nota** Las plantillas de mensajería en la aplicación no admiten el uso de variables de mensaje. **Para agregar una variable de mensaje a una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 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. Puede agregar una variable al cuerpo del mensaje de cualquier tipo de plantilla. Para las plantillas de notificación de inserción y correo electrónico, también puede agregar una variable al asunto o título del mensaje. 1. En el **Attribute finder (Buscador de atributos)**, expanda la sección del tipo de atributo para el que desea agregar una variable de mensaje. Puede elegir entre los siguientes tipos de atributos: **Atributos estándar** Estos son atributos que Amazon Pinpoint crea automáticamente para cualquier proyecto. Esto significa que puede usarlos en mensajes que envíe para cualquier proyecto. Para obtener información detallada sobre cada uno de estos atributos, consulte [Atributos de admitidos](#message-templates-variables). Para agregar una variable para un atributo estándar, elija el atributo de la lista. **Custom attributes (Atributos personalizados)** Estos son atributos que puede crear opcionalmente para proyectos individuales. Dado que es posible que estos atributos no estén disponibles para algunos de los proyectos, es posible que Amazon Pinpoint no pueda reemplazar la variable por un valor para cada uno de los destinatarios de un mensaje que utiliza la plantilla. Para ayudarle a evitar este problema, Amazon Pinpoint proporciona opciones que le ayudarán a elegir un atributo que exista para proyectos específicos o para todos los proyectos. Para agregar un atributo personalizado: 1. Elija **Atributos personalizados** y, a continuación, elija **Cargar atributos personalizados**. En la ventana que aparece, Amazon Pinpoint muestra todos los proyectos que ha creado. Al elegir cada proyecto, los atributos comunes a los proyectos seleccionados se muestran en el panel de navegación de la derecha. Si no se muestra ningún atributo, significa que no hay atributos comunes entre esos proyectos. 1. Realice una de las siguientes acciones: + Para usar todos los atributos comunes a los proyectos seleccionados, elija **Cargar atributos personalizados**. + Para utilizar un atributo específico de la lista, ingrese cualquier parte del nombre del atributo en el campo de búsqueda. Se muestran los atributos que coinciden con el texto ingresado. Elija **Cargar atributos personalizados** cuando se muestre el atributo que desea utilizar. El **buscador de atributos** muestra los atributos personalizados recién agregados. **nota** No puede agregar atributos comunes de diferentes conjuntos de proyectos ni modificar la sección **Atributos personalizados** del **Buscador de atributos**. Para realizar cambios en los atributos personalizados, elija **X** para borrar el **Buscador de atributos** y después vuelva a empezar. 1. En el **Attribute finder (Buscador de atributos)**, elija el atributo para el que desea agregar una variable. **Recommended attributes (Atributos recomendados)** Estos son los atributos que puede crear opcionalmente para la cuenta cuando se configura Amazon Pinpoint para recuperar recomendaciones personalizadas de un modelo de recomendación. Para obtener información sobre el uso de modelos de recomendación, consulte [Modelos de aprendizaje automático](ml-models.md). Puede agregar variables para este tipo de atributo a plantillas de correo electrónico, plantillas de notificación push y plantillas de SMS. No puede agregarlas a plantillas de voz. Para agregar una variable para un atributo recomendado, elija el atributo de la lista. Si el **Buscador de atributos** no muestra ningún atributo recomendado, tendrá que conectar primero la plantilla a un modelo de recomendaciones. Para agregar un atributo recomendado: 1. Elija **Conectar modelo**. 1. Seleccione el modelo del que desea recuperar las recomendaciones cuando envíe mensajes que utilicen la plantilla. 1. Elija **Conectar modelo**. 1. Cuando elige un atributo del **Buscador de atributos**, Amazon Pinpoint crea una variable de mensaje para el atributo y la copia en el portapapeles. Pegue la variable en la ubicación que desee. Si tiene una lista larga de atributos, ingrese el texto de búsqueda para reducir la lista. Elija **X** para borrar el campo de búsqueda. Tras pegar la variable, Amazon Pinpoint la muestra como el nombre del atributo asociado, entre dos conjuntos de llaves, por ejemplo, `{{User.UserAttributes.FirstName}}`. 1. Repita los pasos 4 a 6 para cada variable de mensaje que desee agregar. 1. Para especificar un valor predeterminado para una variable de mensaje, expanda la sección **Default attribute values (Valores de atributo predeterminados)**. A continuación, en la lista de variables, introduzca el valor predeterminado que desea utilizar para la variable. **nota** Le recomendamos que haga esto para cada variable de la plantilla. De lo contrario, es posible que Amazon Pinpoint no pueda enviar un mensaje que utilice la plantilla o que el mensaje se muestre de formas inesperadas o no deseadas. 1. Cuando termine, realice una de las siguientes acciones: + Si ha agregado variables de mensaje a una plantilla nueva, elija **Create (Crear)**. + 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 de la versión más reciente de la plantilla, elija **Update version (Actualizar versión)**. Esta opción solo está disponible si ha abierto la versión más reciente de la plantilla en el paso 3. ## Atributos de admitidos Cada proyecto puede tener atributos estándar y atributos personalizados. Los atributos estándar son atributos que Amazon Pinpoint crea automáticamente para cualquier proyecto. Los atributos personalizados son atributos que puede definir opcionalmente para un proyecto. Hay tres tipos de atributos personalizados: + **Atributos de usuario**: estos atributos describen a un usuario, por ejemplo, el nombre, los apellidos y la fecha de nacimiento. Un *usuario* es un individuo que tiene un ID de usuario único para un proyecto. + **Atributos de punto de conexión**: estos atributos describen un punto de conexión específico para un usuario. Un *punto de conexión* es un destino al que puede enviar mensajes, como una dirección de correo electrónico, un número de teléfono o un dispositivo móvil. Cada usuario se puede asociar a uno o varios puntos de enlace. Por ejemplo, si se comunica con un usuario por correo electrónico, SMS y teléfono, el usuario podría estar asociado a tres puntos de conexión: uno para la dirección de correo electrónico del usuario, otro para el número de teléfono móvil del usuario y otro para el número de teléfono de casa (fijo) del usuario. + **Atributos de métricas**: estos atributos son métricas numéricas de las que la aplicación informa a Amazon Pinpoint para puntos de conexión individuales, como el número de sesiones de una aplicación móvil o el número de artículos que quedan en la cesta. + **Atributos Pinpoint**: estos atributos son identificadores únicos para su aplicación, campaña o recorrido. Además de los atributos personalizados y estándar que usted o Amazon Pinpoint crean para los proyectos, Amazon Pinpoint admite *atributos recomendados*. Un *atributo recomendado* es un atributo que almacena temporalmente las recomendaciones personalizadas para los usuarios o puntos de conexión. Amazon Pinpoint recupera estas recomendaciones de los modelos recomendados para los que se configura. Los atributos recomendados no están asociados a proyectos específicos. En su lugar, están asociados a la cuenta de Amazon Pinpoint. Para obtener información sobre el uso de modelos de recomendación, consulte [Modelos de aprendizaje automático](ml-models.md). Puede utilizar cualquier atributo estándar, personalizado o recomendado en una variable de mensaje. La tabla siguiente indica el texto que aparece en una variable de mensaje para cada atributo admitido y describe cada atributo. En la tabla, *custom\$1attribute* indica el texto que aparece en una variable para un atributo personalizado. En esos casos, *custom\$1attribute* sustitúyalo por el nombre del atributo personalizado. Por ejemplo, si el proyecto almacena los nombres de los usuarios en un atributo de usuario personalizado denominado `FirstName` y agrega una variable para ese atributo, el texto de la variable es `{{User.UserAttributes.FirstName}}`. | Atributo | Description (Descripción) | | --- | --- | | Address | La dirección de destino de los mensajes o las notificaciones de inserción que envía al punto de conexión, por ejemplo, una dirección de correo electrónico, un número de teléfono o un token de dispositivo. | | Pinpoint.ApplicationId | El identificador único de la aplicación. | | Attributes.custom\$1attribute | Un atributo de punto de enlace personalizado que describe el punto de enlace. | | Pinpoint.CampaignId | El identificador único de la campaña. | | ChannelType | El canal que se va a utilizar al enviar mensajes o notificaciones de inserción al punto de enlace. Por ejemplo:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/message-templates-personalizing.html) | | CreationDate | La fecha y hora en que se agregó el punto de enlace al proyecto, en [formato ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Por ejemplo, 2019-06-30T11:45:25.220Z para las 11:45 UTC 30 de junio de 2019. | | Demographic.AppVersion | El número de versión de la aplicación que está asociada al punto de enlace. | | Demographic.Locale | La configuración regional del punto de enlace, en el formato siguiente: el código [ISO 639-1 alfa-2](https://en.wikipedia.org/wiki/ISO_639-1) seguido de un guion bajo (\$1), seguido de un valor [ISO 3166-1 alfa-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Por ejemplo, en\$1US es la configuración regional en inglés para los Estados Unidos. | | Demographic.Make | El fabricante del dispositivo del punto de enlace, como, por ejemplo, apple o samsung. | | Demographic.Model | Nombre o número del modelo del dispositivo del punto de enlace, como iPhone o SM-G900F. | | Demographic.ModelVersion | La versión de modelo del dispositivo del punto de enlace. | | Demographic.Platform | El sistema operativo del dispositivo del punto de enlace, como, por ejemplo, ios o android. | | Demographic.PlatformVersion | La versión del sistema operativo en el dispositivo del punto de enlace. | | Demographic.Timezone | La zona horaria del punto de enlace, como un valor de [base de datos de zona horaria](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Por ejemplo, America/Los\$1Angeles para la hora del Pacífico (América del Norte). | | EffectiveDate | La fecha y la hora de la última actualización del punto de enlace, en [formato ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Por ejemplo, 2019-08-23T10:54:35.220Z para 10:54 UTC 23 de agosto de 2019. | | EndpointId | El identificador único para el punto de enlace. | | EndpointStatus | Si desea enviar mensajes o notificaciones de inserción al punto de conexión: ACTIVE, enviar mensajes al punto de conexión; o INACTIVE, no enviar mensajes al punto de conexión. | | Id | El identificador único para el punto de enlace. | | Pinpoint.JourneyId | El identificador único del recorrido. | | Location.City | La ciudad en la que se encuentra el punto de enlace. | | Location.Country | El código de dos caracteres, en [formato ISO 3166-1 alfa-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), del país o región en que se encuentra el punto de enlace. Por ejemplo, US para los Estados Unidos. | | Location.Latitude | La coordenada de latitud de la ubicación del punto de enlace, redondeada a un decimal. | | Location.Longitude | La coordenada de longitud de la ubicación del punto de enlace, redondeada a un decimal. | | Location.PostalCode | El código postal del área donde se encuentra el punto de enlace. | | Location.Region | El nombre de la región, como un estado o una provincia, en la que se encuentra ubicado el punto de enlace. | | Metrics.custom\$1attribute | Una métrica numérica personalizada de la que la aplicación informa a Amazon Pinpoint para el punto de conexión. | | OptOut | Si el usuario ha cancelado la opción de recibir sus mensajes y notificaciones push de usted: ALL, el usuario ha cancelado la opción de recibir mensajes o notificaciones push; o NONE, el usuario no ha cancelado la opción de recibir mensajes y desea recibir todos los mensajes y notificaciones push. | | RecommendationItems | Un atributo recomendado estándar que almacena una recomendación para el punto de enlace o el usuario. Este atributo contiene texto proporcionado directamente por un modelo de recomendación. | | RecommendationItems.[\$1] | Un atributo recomendado estándar que almacena una lista ordenada de 2-5 recomendaciones para el punto de conexión o el usuario. Este atributo contiene texto proporcionado directamente por un modelo de recomendación. El marcador de posición numérico (.[\$1]) indica que el atributo contiene varios valores. Una variable de mensaje para este atributo puede hacer referencia a un valor específico de la lista. | | Recommendations.custom\$1attribute | Un atributo recomendado personalizado que almacena una recomendación para el punto de enlace o el usuario. Este atributo contiene contenido proporcionado por un modelo de recomendación y mejorado por una AWS Lambda función. | | Recommendations.custom\$1attribute.[\$1] | Un atributo recomendado personalizado que almacena varias recomendaciones para el punto de enlace o el usuario. Este atributo incluye contenido proporcionado por un modelo de recomendación y mejorado por una función de AWS Lambda . El marcador de posición numérico (.[\$1]) indica que el atributo contiene varios valores. Una variable de mensaje para este atributo puede hacer referencia específicamente a uno de esos valores. | | RequestId | El identificador único de la solicitud más reciente para actualizar el punto de enlace. | | User.UserAttributes.custom\$1attribute | Un atributo de usuario personalizado que describe al usuario. | | User.UserId | Un identificador único para el usuario. | # Uso de ayudantes de plantillas de mensajes Con las plantillas de Amazon Pinpoint, 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 Pinpoint específica. Estas son las categorías de ayudantes, que se describen en las secciones siguientes: ## Ayudantes predeterminados En esta sección se describen los ayudantes **integrados** que proporciona Handlebars. Para ver la lista completa, consulte los [ayudantes integrados](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}}` regresa *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="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 el `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 atributos personalizados de Amazon Pinpoint, por ejemplo `User.UserAttributes.LastName`, se almacenan como una lista, independientemente de si hay un solo elemento o varios. Al pasar una lista a un ayudante que espera una cadena, debe especificar el valor del índice del atributo junto con el nombre del atributo. Este valor del índice de atributos indica la posición de un valor de la lista de atributos: `.[0]` para la primera entrada de la lista, `.[1]` para la segunda, `.[2]` para la tercera, etc. Por ejemplo, supongamos que está utilizando el asistente `upper` para convertir la primera entrada (`[0]`) de `User.UserAttributes.LastName` en mayúsculas. El uso del ayudante es `{{upper value}}` y el atributo tiene el formato correspondiente `User.UserAttributes.LastName`. *value*Sustitúyalo por el nombre del atributo y el valor del índice del atributo de la `.[0]` siguiente manera:`{{upper User.UserAttributes.LastName.[0]}}`. A continuación, la respuesta devuelve la entrada `[0]` de la lista, formateada en mayúsculas. Por ejemplo, si el valor de `[0]` es*Santos*, la respuesta devuelve*SANTOS*. Los nombres de los atributos personalizados de Amazon Pinpoint admiten espacios. Para tener un atributo personalizado llamado `"Last Name"`, debe formatear el atributo como `User.UserAttributes.[Last Name]`. Para acceder a la primera entrada de la lista de índices de atributos, el formato es `User.UserAttributes.[Last Name].[0]`. Un nombre de atributo personalizado puede contener hasta 50 caracteres. Un valor de atributo puede contener hasta 100 caracteres. Al definir el nombre de un atributo personalizado, evite utilizar los siguientes caracteres: signo numérico (\$1), dos puntos (:), signo de interrogación (?) , barra diagonal inversa (\$1) y barra diagonal (/). La consola Amazon Pinpoint no puede mostrar nombres de atributos que contengan estos caracteres. Esta restricción no se aplica a los valores de atributo. ## 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**. # Administración de plantillas de mensaje La página de **plantillas de mensajes** de la consola de Amazon Pinpoint proporciona una ubicación única para crear, ver y gestionar todas las plantillas de mensajes de su cuenta de Amazon Pinpoint en la región actual. AWS Mediante esta página, puede administrar las plantillas de mensajes como una sola colección. Esto puede ayudarle a diseñar mensajes coherentes y reutilizar el contenido de forma más fácil y eficaz. Puede utilizar esta página para realizar tareas de administración, como ver y editar plantillas o copiar, eliminar y crear plantillas. **Topics** + [Visualización de su colección de plantillas de mensaje](message-templates-managing-view-all.md) + [Abrir una plantilla de mensaje](message-templates-managing-open.md) + [Editar una plantilla de mensaje](message-templates-managing-edit.md) + [Copiar una plantilla de mensaje](message-templates-managing-copy.md) + [Eliminar una plantilla de mensaje](message-templates-managing-delete.md) + [Agregar una etiqueta a una plantilla](message-templates-managing-add-tag.md) + [Eliminación de una etiqueta de una plantilla](message-templates-managing-remove-tag.md) Para obtener información sobre cómo crear una plantilla de mensaje, consulte [Creación de plantillas de correo electrónico](message-templates-creating-email.md), [Creación de plantillas de notificaciones push](message-templates-creating-push.md), [Creación de plantillas de SMS](message-templates-creating-sms.md) o [Creación de plantillas de voz](message-templates-creating-voice.md) según el tipo de plantilla que desee crear. Para obtener información sobre cómo ver y administrar versiones de plantillas, consulte [Administración de versiones de plantillas de mensajes](message-templates-versioning.md). # Visualización de su colección de plantillas de mensaje En la página **Plantillas de mensajes** se muestra una lista de todas las plantillas de mensajes de la cuenta de Amazon Pinpoint en la Región de AWS actual. Para examinar la lista o encontrar plantillas específicas rápidamente, puede ordenar y filtrar la lista, elegir las columnas que desea mostrar y cambiar otros ajustes de visualización de la lista. **Para ver la colección de plantillas de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. Se abre la página **Message templates (Plantillas de mensaje)** y se muestra el número de plantillas de la colección y una lista de dichas plantillas. 1. Para personalizar la lista o encontrar una plantilla específica rápidamente, elija cualquiera de las siguientes opciones: + Para ordenar la lista por un tipo específico de valor, seleccione el encabezado de la columna correspondiente a ese valor. Para cambiar el orden de clasificación de ascendente a descendente o viceversa, seleccione de nuevo en el encabezado de la columna. + Para aplicar un filtro que muestre solo un tipo específico de plantilla, utilice el selector de canales en la parte superior de la página para elegir el canal. Para eliminar el filtro, seleccione **All message channels (Todos los canales de mensajes)** en el selector de canales. + Para aplicar un filtro que muestre solo las plantillas cuyos nombres contengan texto específico, escriba el texto en el cuadro **Search (Buscar)** situado encima de la lista. Para quitar el filtro, elija la **X** en el cuadro **Search (Buscar)**. + Para cambiar el número de plantillas que se muestran en la lista, elija el icono de configuración en la parte superior de la página. A continuación, en **Page size (Tamaño de la página)**, elija el número de plantillas que desea mostrar y elija **Save changes (Guardar cambios)**. + Para agregar o quitar columnas de la lista, elija el icono de configuración en la parte superior de la página. A continuación, en **Choose visible columns (Elegir columnas visibles)**, active o desactive cada columna y elija **Save changes (Guardar cambios)**. # Abrir una plantilla de mensaje En la página **Message templates (Plantillas de mensaje)** puede buscar y abrir rápidamente una plantilla de mensaje específica para ver el contenido de la plantilla y la información sobre la plantilla. Por ejemplo, puede ver las versiones actuales y anteriores de la plantilla y determinar cuándo se actualizó por última vez. Tras abrir una plantilla, también puede [editarla](message-templates-managing-edit.md). **Para abrir una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** elija la plantilla que desea abrir. Se abre la página de la plantilla con información sobre la misma. También aparece el contenido de la versión activa de la plantilla. 1. Para ver una versión diferente de la plantilla, utilice el selector de versiones en **Template details (Detalles de la plantilla)** para elegir la versión que desea ver. # Editar una plantilla de mensaje Puede abrir una plantilla de mensaje para editarla de dos maneras: al crear un mensaje que utiliza la plantilla y desde la página **Message templates (Plantillas de mensaje)**. En este tema se explica cómo abrir y editar una plantilla desde la página **Message templates (Plantillas de mensaje)**. Si edita una plantilla, Amazon Pinpoint podría aplicar los cambios a los mensajes existentes que la utilicen y que aún no se hayan enviado, como mensajes de campaña programados para enviarse más adelante. Esto depende de si edita la versión activa de la plantilla y de cómo configuró los mensajes que la utilizan. Para obtener más información, consulte [Administración de versiones de plantillas de mensajes](message-templates-versioning.md). **Edición de una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** elija la plantilla que desee editar. Se abre la página de la plantilla con información sobre la misma. También muestra el contenido y la configuración de la versión activa de la plantilla. 1. Elija **Edit (Edición de)**. 1. 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 para los cambios. Si elige la versión más reciente de la plantilla, 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. Haga los cambios que desee. Puede cambiar cualquier contenido o configuración de la plantilla, excepto el nombre de la plantilla. Para cambiar el nombre de la plantilla, puede [crear una copia de la plantilla](message-templates-managing-copy.md), guardar la copia con el nombre que desee y, a continuación, eliminar la plantilla original, si lo desea. 1. Cuando termine de realizar cambios, haga lo siguiente: + Para guardar los cambios como una versión nueva de la plantilla, elija **Save as new version (Guardar como versión nueva)**. Para asegurarse de que los cambios no afecten a ningún mensaje existente, le recomendamos que elija esta opción. + Para guardar los cambios como una actualización de la versión más reciente de la plantilla, elija **Update version (Actualizar versión)**. Esta opción solo está disponible si ha elegido la versión más reciente de la plantilla en el paso 5. Si elige esta opción, los cambios pueden afectar a los mensajes existentes que utilizan la plantilla. # Copiar una plantilla de mensaje Para crear rápidamente una nueva plantilla de mensaje similar a una plantilla existente, puede crear una copia de la plantilla. A continuación, puede editar la copia de la plantilla sin cambiar la plantilla original. **Para copiar una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** seleccione la casilla de verificación situada junto a la plantilla que desea copiar. 1. En el menú **Actions (Acciones)**, elija **Duplicate (Duplicar)**. 1. En **Template name (Nombre de plantilla)**, escriba un nombre para la copia de la plantilla. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (\$1) o guiones (-). 1. Cuando termine de escribir el nombre, elija **Duplicate template (Duplicar plantilla)**. Se abre la página de la plantilla con todo el contenido y la configuración de la versión activa copiada. 1. (Opcional) Para cambiar la copia de la plantilla, elija **Edit (Editar)**, realice los cambios que desee y, a continuación, elija **Save as new version (Guardar como versión nueva)**. # Eliminar una plantilla de mensaje Si desea eliminar una plantilla de mensaje de Amazon Pinpoint por completo, puede eliminarla. Si elimina una plantilla, ello no afectará a los mensajes existentes que la utilicen, como mensajes de campaña programados para enviarse más adelante. **aviso** Si elimina una plantilla, Amazon Pinpoint elimina todas las versiones, el contenido y la configuración de la plantilla. Además, la plantilla dejará de estar disponible para todos los mensajes futuros. No se puede recuperar una plantilla una vez eliminada. **Eliminación de una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** active la casilla de verificación situada junto a cada plantilla que desee eliminar. 1. En el menú **Acciones**, elija **Eliminar**. # Agregar una etiqueta a una plantilla Una etiqueta es una etiqueta que puede definir y asociar a AWS los recursos, incluidos determinados tipos de recursos de Amazon Pinpoint. Agregar una etiqueta a una plantilla puede ayudarle a clasificar y administrar plantillas de distintas formas, como, por finalidad, propietario, entorno u otros criterios. Puede usar etiquetas para encontrar rápidamente las plantillas existentes o para controlar qué usuarios pueden acceder a plantillas específicas. Puede agregar como máximo 50 pares de clave-valor, siendo cada clave única. **Cómo agregar una etiqueta** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Plantillas de mensaje**, elija la plantilla a la que desea agregar una etiqueta. 1. En **Etiquetas**, elija **Administrar etiquetas**. 1. Elija **Añadir nueva etiqueta**. 1. Escriba el par de clave y valor de etiqueta que desea agregar. 1. (Opcional) Para agregar etiquetas adicionales, elija **Agregar nueva etiqueta**. 1. Cuando termine, elija **Guardar etiquetas**. # Eliminación de una etiqueta de una plantilla Si ya no necesita una etiqueta para aplicarla a una plantilla, puede eliminarla a través de la consola. **Eliminación de una etiqueta** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Plantillas de mensaje**, elija la plantilla a la que desea eliminar una etiqueta. 1. En **Etiquetas**, elija **Administrar etiquetas**. 1. Junto a la etiqueta que desea eliminar, elija **Eliminar**. 1. Elija **Guardar etiquetas**. Para obtener más información sobre cómo utilizar las etiquetas en las políticas de IAM, consulte [Administración de etiquetas](https://docs.aws.amazon.com/pinpoint/latest/developerguide/tagging-resources.html). # Administración de versiones de plantillas de mensajes Para ayudarle a administrar el desarrollo y el uso de plantillas de mensajes individuales, Amazon Pinpoint 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. Cada vez que modifique una plantilla, puede especificar si desea guardar los cambios como una nueva versión de la plantilla o como una actualización de la versión 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. Puede: + **Realizar un seguimiento del historial de una plantilla**: para cada plantilla, Amazon Pinpoint proporciona una lista de las versiones de la plantilla. La lista muestra el nombre de cada versión e indica cuándo se modifico por última vez 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 Pinpoint 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 abrir y editar 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. **nota** Si necesita editar una plantilla que se esté utilizando activamente, le recomendamos que cree una nueva versión de la plantilla. **Topics** + [Cómo funciona el control de versiones](#message-templates-versioning-overview) + [Visualización de las versiones de una plantilla de mensaje](#message-templates-versioning-view-versions) + [Visualización de la versión activa de una plantilla de mensaje](#message-templates-versioning-view-active) + [Designación de la versión activa de una plantilla de mensaje](#message-templates-versioning-set-active) + [Edición de la versión activa de una plantilla de mensaje](#message-templates-versioning-edit-active) ## Cómo funciona el control de versiones En un flujo de trabajo de desarrollo normal, una plantilla de mensaje tiene muchas versiones. Estas versiones abarcan desde el inicio del diseño y el desarrollo hasta las pruebas, revisiones y, en última instancia, aprobación para su uso en mensajes. En algunos casos, puede crear y aprobar versiones adicionales después de la aprobación inicial, a medida que refina y actualiza una plantilla. Por ejemplo, puede agregar vínculos o cambiar el diseño de una plantilla en respuesta a los datos de análisis de una campaña que utiliza la plantilla. ### Numeración de versiones Al crear una plantilla, solo hay una versión de la plantilla: la *versión 1*. Cada vez que modifique una plantilla más adelante, puede especificar si desea guardar los cambios como una nueva versión de la plantilla o como una actualización de la versión más reciente de la plantilla. Si guarda los cambios como una versión nueva, Amazon Pinpoint incrementa automáticamente el número de versión en 1 y asigna ese número de versión a la versión: *versión 1* para la primera versión, *versión 2* para la segunda versión, *versión 3* para la tercera versión, etc. Los números de versión nunca se reutilizan. Puede guardar hasta 5000 versiones de una plantilla. Si guarda los cambios como una actualización de la versión más reciente, Amazon Pinpoint sobrescribe la versión más reciente para incluir los cambios. Para asegurarse de tener una vista precisa del historial de una plantilla, solo se puede sobrescribir la versión más reciente de una plantilla mediante la consola de Amazon Pinpoint. No es posible sobrescribir ninguna versión anterior de una plantilla mediante la consola. ### Versiones más recientes y activas Para apoyar el desarrollo continuo y a largo plazo de plantillas, dos versiones de una plantilla pueden estar actualizadas al mismo tiempo. Son: la versión *más reciente*, que es la versión que se ha modificado más recientemente; y la versión *activa*, que es la versión que se puede usar en los mensajes. Según el flujo de trabajo de su organización, la versión activa suele ser la versión revisada y aprobada más recientemente para su uso en mensajes. No es necesariamente la última versión de una plantilla. Además, cualquier versión que no sea la versión activa se considera una versión provisional o archivada de una plantilla. Esto significa que solo puede utilizar la versión activa de una plantilla en los mensajes que cree mediante la consola de Amazon Pinpoint. Por ejemplo, puede crear varias versiones de una plantilla mientras diseña y desarrolla la plantilla. Cuando se haya completado la versión más reciente de la plantilla y se haya aprobado para su uso en mensajes, puede designar esa versión como la versión activa de la plantilla. A continuación, puede utilizar esa versión activa de la plantilla en los mensajes. Si posteriormente decide modificar la plantilla, puede crear versiones adicionales para esos cambios, sin que ello afecte a la versión activa de la plantilla ni a los mensajes existentes que la utilizan. De todas las versiones de una plantilla, se debe designar una versión como la versión activa de la plantilla. 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. ### Configuración de la versión para mensajes Para utilizar una versión específica de una plantilla en un mensaje, la versión debe ser la versión activa de la plantilla cuando se crea el mensaje o cuando Amazon Pinpoint envía el mensaje. Esto depende de cómo configura el mensaje para que use una plantilla. Cuando crea un mensaje y elige una plantilla para él, tiene dos opciones: + **Utilizar la versión que esté activa actualmente**: si elige esta opción, Amazon Pinpoint siempre envía el mismo contenido y la misma configuración del mensaje, tal y como se especifica en la versión de la plantilla que está activa al crear el mensaje. Esto significa que el mensaje sigue siendo el mismo, independientemente de los cambios que realice en la plantilla más adelante. + **Usar la versión que esté activa cuando se envíe el mensaje**: si elige esta opción, Amazon Pinpoint actualizará automáticamente el contenido y la configuración del mensaje para que coincidan con la versión de la plantilla que esté activa cuando envíe el mensaje. Esto significa que el mensaje cambia si designa una versión diferente como versión activa después de crear el mensaje. Por ejemplo, si hace lo siguiente: 1. Crear la *Versión 1* de una plantilla. 1. Designar la *Versión 1* como versión activa de la plantilla. 1. Crear un mensaje que utilice la plantilla y programar el mensaje para que se envíe más adelante. 1. Modificar la plantilla varias veces. 1. Designar una nueva versión (*Versión 5*) como versión activa de la plantilla. Amazon Pinpoint hace lo siguiente para cada opción cuando envía el mensaje: + **Usar la versión que esté activa actualmente**: si elige esta opción para el mensaje, Amazon Pinpoint utiliza el contenido y la configuración especificados en la *versión 1* de la plantilla. Esto es así porque la *Versión 1* era la versión activa de la plantilla cuando se creó el mensaje. + **Usar la versión que esté activa cuando se envíe el mensaje**: si eligió esta opción para el mensaje, Amazon Pinpoint actualiza automáticamente el mensaje para usar el contenido y la configuración especificados por la *versión 5* de la plantilla. Esto es así porque la *Versión 5* es la versión activa de la plantilla cuando se envía el mensaje. Si desea asegurarse de que los cambios realizados en una plantilla no afectan a ningún mensaje existente que aún no haya enviado, le recomendamos que configure los mensajes para que utilicen la versión de la plantilla que está activa cuando se crean los mensajes, no cuando se envían. Como alternativa, si desea continuar desarrollando una plantilla después de empezar a usarla en mensajes, puede [crear una copia de la plantilla](message-templates-managing-copy.md) y, a continuación, editar y utilizar la copia de la plantilla en mensajes nuevos. ## Visualización de las versiones de una plantilla de mensaje Mediante la página **Message templates (Plantillas de mensajes)** puede buscar y abrir rápidamente una plantilla de mensaje determinada. A continuación, puede ver una lista de las versiones existentes de esa plantilla. En la lista, puede elegir una versión específica para ver el contenido y la configuración de esa versión de la plantilla. **Para ver las versiones de una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** elija la plantilla cuyas versiones desea ver. Se abre la página de la plantilla con información sobre la misma. También muestra el contenido y la configuración de la versión activa de la plantilla. 1. En **Template details (Detalles de la plantilla)**, abra el selector de versiones para mostrar una lista de versiones de la plantilla. 1. Para ver el contenido y la configuración de una versión concreta, utilice el selector de versiones para elegir la versión. Después de elegir una versión, Amazon Pinpoint muestra el contenido y la configuración de esa versión de la plantilla. ## Visualización de la versión activa de una plantilla de mensaje Puede ver la versión activa de una plantilla de mensaje de dos maneras: mientras crea un mensaje que utiliza la plantilla y mediante la página **Message templates (Plantillas de mensaje)**. Para ver la versión activa de una plantilla mientras crea un mensaje, elija la plantilla para el mensaje. Amazon Pinpoint muestra automáticamente una vista previa de la versión activa de la plantilla. Para ver la versión activa de una plantilla mediante la página **Message templates (Plantillas de mensajes)** siga los pasos de este tema. **Para ver la versión activa de una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** elija la plantilla cuya versión activa desea ver. Se abre la página de la plantilla con información sobre la misma. También muestra el contenido y la configuración de la versión activa de la plantilla. En **Template details (Detalles de la plantilla)**, observe si aparece **ACTIVE VERSION (VERSIÓN ACTIVA)** (en verde) junto al nombre de la versión y el selector de versiones. 1. Para ver una versión diferente de la plantilla, utilice el selector de versiones en **Template details (Detalles de plantilla)** para elegir la versión que desee. Para volver a ver la versión activa, utilice el selector de versiones para elegir la versión que muestra **VERSION ACTIVE (VERSIÓN ACTIVA)** (en verde) junto al nombre de la versión. ## Designación de la versión activa de una plantilla de mensaje Al crear una plantilla de mensaje, Amazon Pinpoint designa automáticamente la primera versión de la plantilla como la versión activa de la plantilla. A medida que crea y desarrolla versiones posteriores de una plantilla, puede designar una versión diferente como la versión activa de la plantilla, Puede cambiar esa designación en múltiples ocasiones. Antes de designar una versión como la versión activa de una plantilla, es conveniente verificar que todo el contenido y la configuración de la versión activa propuesta estén completos y listos para su uso. También es una buena idea verificar que las diferencias entre la versión activa actual y la propuesta no afecten a los mensajes existentes de formas inesperadas o no deseadas. Si designa una versión diferente como versión activa, Amazon Pinpoint podría aplicar el cambio a los mensajes existentes que utilizan la plantilla y que aún no se han enviado. Esto depende de cómo haya configurado los mensajes que utilizan la plantilla. Para obtener más información, consulte [Configuración de la versión para mensajes](#message-templates-versioning-overview-versions-messages). Si la plantilla se está utilizando en mensajes que aún no se han enviado, compare la versión que está activa actualmente con la versión que desea activar. Además, revise las campañas y actividades de recorrido que utilizan la plantilla. A continuación, edite la plantilla según sea necesario para solucionar cualquier problema que encuentre antes de designar una versión diferente como la versión activa. Si le preocupan los efectos que podría tener designar una versión diferente como versión activa, puede [crear una copia de la plantilla](message-templates-managing-copy.md) en su lugar. A continuación, puede editar y utilizar la copia de la plantilla en mensajes nuevos. **Para designar la versión activa de una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** elija la plantilla para la que desea designar la versión activa. Se abre la página de la plantilla con información sobre la misma. También muestra el contenido y la configuración de la versión que está actualmente activa de la plantilla. 1. En **Template details (Detalles de plantilla)**, utilice el selector de versiones para elegir la versión que desea designar como versión activa. Después de elegir una versión, Amazon Pinpoint muestra el contenido y la configuración de esa versión de la plantilla. 1. Elija **Make active version (Activar versión)**. La nueva versión activa de la plantilla ya está disponible para su uso en mensajes nuevos. Además, se utiliza en los mensajes existentes que aún no se han enviado y están configurados para usar la versión de la plantilla que está activa cuando se envía el mensaje. ## Edición de la versión activa de una plantilla de mensaje Antes de editar la versión activa de una plantilla, es importante recordar que solo puede utilizar la versión activa de una plantilla en los mensajes que cree mediante la consola de Amazon Pinpoint. Por este motivo, es una buena idea comprobar primero que los cambios están completos y listos para su uso. También es buena idea para verificar que los cambios no afecten a los mensajes existentes de formas inesperadas o no deseadas. Es posible que Amazon Pinpoint aplique los cambios a los mensajes existentes que utilizan la plantilla y que aún no se han enviado. Esto depende de cómo haya configurado los mensajes que utilizan la plantilla. Para obtener más información, consulte [Configuración de la versión para mensajes](#message-templates-versioning-overview-versions-messages). Para determinar cómo pueden afectar los cambios a los mensajes existentes, revise el contenido y la configuración de la versión de la plantilla que está activa actualmente. Además, revise las campañas y actividades de recorrido que utilizan la plantilla. A continuación, considere los cambios que planea realizar y asegúrese de que los cambios concuerdan con los objetivos de los mensajes existentes que utilizan la plantilla. Por último, si le preocupan los efectos que podría tener editar la versión activa de la plantilla, puede [crear una copia de la plantilla](message-templates-managing-copy.md) en su lugar. A continuación, puede editar y utilizar la copia de la plantilla en los mensajes que cree posteriormente. **Para editar la versión activa de una plantilla de mensaje** 1. Abra la consola Amazon Pinpoint en. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 1. En el panel de navegación, elija **Message templates (Plantillas de mensaje)**. 1. En la página **Message templates (Plantillas de mensaje)** elija la plantilla cuya versión activa desea editar. Se abre la página de la plantilla con información sobre la misma. También muestra el contenido y la configuración de la versión que está designada actualmente como versión activa de la plantilla. 1. Elija **Edit (Edición de)**. 1. En **Detalles de plantilla**, utilice el selector de versiones para asegurarse de que está editando la versión activa de la plantilla. Aparece **ACTIVE VERSION (VERSIÓN ACTIVA)** (en verde) junto al nombre de la versión activa. 1. Realice los cambios que desee y, a continuación, elija **Save as new version (Guardar como nueva versión)**. 1. En **Template details (Detalles de plantilla)**, utilice el selector de versiones para elegir la versión de la plantilla que creó en el paso anterior. 1. Elija **Make active version (Activar versión)**. La nueva versión activa de la plantilla ya está disponible para su uso en mensajes nuevos. Además, se utiliza en los mensajes existentes que aún no se han enviado y están configurados para usar la versión de la plantilla que está activa cuando se envía el mensaje.