**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. # Tutorial: Uso de Postman con la API de Amazon Pinpoint Postman es una herramienta popular para realizar pruebas APIs en un entorno easy-to-use gráfico. Puede utilizar Postman para enviar solicitudes de la API a cualquier API de REST, y para recibir respuestas a sus solicitudes. El uso de Postman es una forma cómoda de probar las llamadas que se realizan a la API de Amazon Pinpoint y solucionar sus problemas. Este tutorial incluye procedimientos para la configuración y el uso de Postman con Amazon Pinpoint. **nota** Postman se ha desarrollado por un tercero. No se ha desarrollado ni es compatible con Amazon Web Services (AWS). Para obtener más información sobre Postman, o para obtener ayuda en relación con problemas relacionados con Postman, consulte el [Centro de soporte](https://support.postman.com/hc/en-us) en el sitio web de Postman. ## Acerca de este tutorial Esta sección contiene información general sobre este tutorial. **Destinatarios previstos** Este tutorial está dirigido a los desarrolladores e implementadores de sistemas. No tiene que estar familiarizado con Amazon Pinpoint o Postman para completar los pasos de este tutorial. Debe estar familiarizado con la administración de políticas de IAM y la modificación de ejemplos de código JSON. Los procedimientos de este tutorial se han diseñado para evitar que los nuevos usuarios utilicen operaciones de la API que eliminen de forma permanente los recursos de Amazon Pinpoint. Los usuarios avanzados pueden eliminar esta restricción modificando la política asociada a los usuarios de . **Características utilizadas** Este tutorial incluye ejemplos de uso para la siguiente característica de Amazon Pinpoint: + Interacción con la API de Amazon Pinpoint mediante Postman **Tiempo necesario** Debe tardar aproximadamente 15 minutos en completar este tutorial. **Restricciones regionales** No hay restricciones regionales asociadas al uso de esta solución. **Costos de uso de recursos** La creación de una AWS cuenta es gratuita. Sin embargo, al implementar esta solución, es posible que incurra en costos de AWS uso si utiliza Postman para realizar alguna de las siguientes acciones: + Enviar mensajes de voz, de inserción de móvil, SMS o correo electrónico + Crear y enviar campañas + Utilizar la característica de validación de número de teléfono Para obtener más información sobre los gastos asociados con el uso de Amazon Pinpoint, consulte [Precios de Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/). # Requisitos previos para utilizar Postman con Amazon Pinpoint Antes de comenzar este tutorial, complete los siguientes requisitos previos: + Debe tener una cuenta de AWS. Para crear una cuenta de AWS, vaya a [https://console.aws.amazon.com/](https://console.aws.amazon.com/) y elija **Crear una cuenta nueva de AWS**. + Asegúrese de que la cuenta que utiliza para iniciar sesión en la Consola de administración de AWS puede crear nuevas políticas y roles de IAM. + Asegúrate de haber creado al menos un proyecto de ejemplo que tenga el correo electrónico activado y una identidad de correo electrónico verificada. Consulte [Creación de un proyecto de Amazon Pinpoint con compatibilidad con correo electrónico](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) en la *Guía del usuario de Amazon Pinpoint*. + Asegúrese de tener un ID de cuenta de AWS. El ID de cuenta de AWS se puede encontrar en la esquina superior derecha de la consola o puede utilizar la interfaz de la línea de comandos (CLI). Consulte [Buscar el ID de cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). + Debe descargar e instalar Postman en el equipo. Puede descargar Postman desde el [sitio web de Postman](https://www.getpostman.com). + Después de instalar Postman en el equipo, cree una cuenta de Postman. La primera vez que inicie la aplicación Postman, se le solicitará que inicie sesión o cree una cuenta nueva. Siga las instrucciones de Postman para iniciar sesión en la cuenta o para crear una si todavía no tiene una. **Siguiente**: [Crear políticas y roles de IAM](tutorials-using-postman-iam-user.md) # Crear políticas y roles de IAM para utilizarlos con Amazon Pinpoint Cuando usa Postman para probar la API de Amazon Pinpoint, el primer paso es crear un usuario. En esta sección, se crea una política que permite a los usuarios interactuar con todos los recursos de Amazon Pinpoint. A continuación, se crea un usuario y se asocia la política directamente al usuario. ## Creación de una política de IAM Obtenga información sobre cómo crear una política de IAM. Los usuarios y roles que utilizan esta política pueden interactuar con todos los recursos de la API de Amazon Pinpoint. También proporciona acceso a los recursos asociados a la API de correo electrónico de Amazon Pinpoint, así como a la API de SMS y voz de Amazon Pinpoint. **Para crear la política de** 1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. En el panel de navegación, seleccione **Políticas** y, a continuación, **Crear política**. 1. En **Editor de políticas**, seleccione **JSON**. Elimine cualquier JSON que esté en ese momento en **Editor de políticas** para dejarlo vacío. Copie y pegue el siguiente JSON en el **editor de políticas** y, a continuación, en el **editor de políticas**, sustituya todas las instancias de *123456789012* por su Cuenta de AWS ID. Puedes encontrar tu Cuenta de AWS ID en la esquina superior derecha de la consola, o puedes usar la CLI (consulta [Cómo encontrar el ID de tu AWS cuenta)](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). **nota** Para proteger los datos de la cuenta de Amazon Pinpoint, esta política solo incluye permisos que le permiten leer, crear y modificar recursos. No se incluyen permisos que permitan eliminar recursos. Puede modificar esta política mediante el editor visual en la consola de IAM. Para obtener información, consulte [Administrar políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) en la Guía del usuario de IAM. También puedes usar la [CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)operación de la API de IAM para actualizar esta política. Además, esta política incluye los permisos que le permiten interactuar con los servicios de `ses` y `sms-voice`, además del servicio de `mobiletargeting`. Los permisos `ses` y `sms-voice` le permiten interactuar con la API de correo electrónico de Amazon Pinpoint y la API de SMS y voz de Amazon Pinpoint, respectivamente. Los permisos de `mobiletargeting` le permiten interactuar con la API de Amazon Pinpoint. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "mobiletargeting:Update*", "mobiletargeting:Get*", "mobiletargeting:Send*", "mobiletargeting:Put*", "mobiletargeting:Create*" ], "Resource": [ "arn:aws:mobiletargeting:*:123456789012:apps/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "mobiletargeting:TagResource", "mobiletargeting:PhoneNumberValidate", "mobiletargeting:ListTagsForResource", "mobiletargeting:CreateApp" ], "Resource": "arn:aws:mobiletargeting:*:123456789012:*" }, { "Sid": "VisualEditor2", "Effect": "Allow", "Action": [ "ses:TagResource", "ses:Send*", "ses:Create*", "ses:Get*", "ses:List*", "ses:Put*", "ses:Update*", "sms-voice:SendVoiceMessage", "sms-voice:List*", "sms-voice:Create*", "sms-voice:Get*", "sms-voice:Update*" ], "Resource": "*" } ] } ``` ------ Elija **Siguiente**. 1. En **Nombre de la política**, especifique un nombre para la política; por ejemplo **PostmanAccessPolicy**. Elija **Crear política**. 1. (Opcional) Puede agregar etiquetas a la política al seleccionar **Agregar etiqueta**. 1. Elija **Siguiente: Revisar**. ## Creación de un usuario de IAM **aviso** Los usuarios de IAM tienen credenciales de larga duración, lo que supone un riesgo de seguridad. Para ayudar a mitigar este riesgo, le recomendamos que brinde a estos usuarios únicamente los permisos que necesitan para realizar la tarea y que los elimine cuando ya no los necesiten. Después de crear la política, puede crear un usuario y asociar la política a él. Al crear el usuario, IAM proporciona un conjunto de credenciales que puede usar para permitir que Postman lleve a cabo operaciones de la API de Amazon Pinpoint. **Para crear el usuario** 1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. En la consola de IAM, seleccione **Usuarios** en el panel de navegación y, a continuación, elija **Crear usuarios**. 1. En **Detalles de usuario**, para **Nombre de usuario**, escriba un nombre que identifique al usuario, como **PostmanUser**. A continuación, elija **Siguiente**. 1. En **Establecer permisos**, para **Opciones de permisos**, elija **Adjuntar políticas directamente**. 1. En **Políticas de permisos**, elija la política (**PostmanAccessPolicy**) que creó en [Crear una política de IAM](#tutorials-using-postman-iam-user-create-policy). A continuación, elija **Siguiente**. 1. En la página **Revisar y crear**, agregue opcionalmente etiquetas que le ayuden a identificar al usuario. Para obtener más información sobre el uso de etiquetas en IAM, consulte [Etiquetado de recursos de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) en la *Guía del usuario de IAM*. 1. Cuando esté listo para crear el usuario, elija **Create user** (Crear usuario). ## Crear claves de acceso **aviso** En este escenario, se requieren usuarios de IAM con acceso programático y credenciales de larga duración, lo que supone un riesgo de seguridad. Para ayudar a mitigar este riesgo, le recomendamos que brinde a estos usuarios únicamente los permisos que necesitan para realizar la tarea y que los elimine cuando ya no los necesiten. Las claves de acceso se pueden actualizar si es necesario. Para más información consulte [Actualización de las claves de acceso](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html) en la *Guía de usuario de IAM*. IAM proporciona un conjunto de credenciales que puede usar para permitir que Postman lleve a cabo operaciones de la API de Amazon Pinpoint. **Para crear el usuario** 1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. En la consola de IAM, en el panel de navegación, elija **Usuarios**. Seleccione el usuario (**PostmanUser**) que creó en [Crear un usuario de IAM](#tutorials-using-postman-iam-user-create-user) y, a continuación, seleccione la pestaña **Credenciales de seguridad**. 1. En la sección **Claves de acceso**, haga clic en **Crear clave de acceso**. 1. En la página **Prácticas recomendadas y alternativas para la clave de acceso**, seleccione **Aplicación ejecutada fuera de AWS**. A continuación, elija **Siguiente**. 1. (Opcional) Puede agregar una etiqueta descriptiva a la política. 1. Elija **Create access key (Crear clave de acceso)**. 1. En la página **Recuperar claves de acceso**, copie las credenciales que se muestran en las columnas de **Clave de acceso** y **clave de acceso secreta**. **nota** Debe proporcionar el ID de clave de acceso y la clave de acceso secreta posteriormente en este tutorial. Esta es la única vez que puede ver la clave de acceso secreta. Le recomendamos que la copie y la guarde en un lugar seguro. 1. Una vez guardadas ambas claves, elija **Listo**. **Siguiente**: [Configurar Postman](tutorials-using-postman-configuration.md) # Configurar Postman para su uso con Amazon Pinpoint Ahora que ha creado un usuario que puede acceder a la API de Amazon Pinpoint, puede configurar Postman. En esta sección, cree uno o más entornos en Postman. A continuación, importe una colección que contenga una plantilla de solicitud para cada una de las operaciones en la API de Amazon Pinpoint. ## Crear un espacio de trabajo de Postman En Postman, un *espacio de trabajo* es un contenedor organizativo para proyectos y entornos. En esta sección, debe crear al menos un espacio de trabajo para usarlo con Amazon Pinpoint. **Creación de un espacio de trabajo** En Postman, elija entre más acciones, elija **Archivo** y, a continuación, elija **Nuevo**. 1. En la ventana **Crear nuevo**, elija **Espacio de trabajo**. 1. Ingrese un nombre, un resumen y establezca la visibilidad como personal. A continuación, elija **Crear espacio de trabajo**. ## Crear entornos de Postman En Postman, un *entorno* es un conjunto de variables que se almacenan como pares clave-valor. Puede utilizar entornos para cambiar la configuración de las solicitudes que realice a través de Postman sin tener que cambiar las propias solicitudes de la API. En esta sección, debe crear al menos un entorno que utilizar con Amazon Pinpoint. Cada entorno que cree contendrá un conjunto de variables específicas de la cuenta de una única Región de AWS. Si utiliza los procedimientos de esta sección para crear más de un entorno, puede cambiar entre regiones eligiendo un entorno distinto al menú **Entorno** en Postman. **Para crear un entorno** 1. En Postman, elija en el menú de más acciones, elija **Archivo** y, a continuación, elija **Nuevo**. 1. En la ventana **Create New** (Crear nuevo), elija **Environment** (Entorno). 1. En la ventana **MANAGE ENVIRONMENTS** (GESTIONAR ENTORNOS) para **Environment Name** (Nombre de entorno), especifique **Amazon Pinpoint - *Region Name***. *Region Name*Sustitúyalo por uno de los siguientes valores: + Este de EE. UU. (Norte de Virginia) + Oeste de EE. UU. (Oregón) + Asia-Pacífico (Mumbai) + Asia-Pacífico (Sídney) + Europa (Fráncfort) + Europa (Irlanda) **nota** Como mínimo, solo necesita crear un entorno para cada uno y Región de AWS debe contener un proyecto. Región de AWS Si no ha creado un proyecto en uno de los listados anteriormente Regiones de AWS, consulte [Creación de un proyecto de Amazon Pinpoint con soporte por correo electrónico](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) en la Guía del usuario de *Amazon Pinpoint*. 1. Cree seis nuevas variables: `endpoint`, `region`, `serviceName`, `accountId`, `accessKey` y `secretAccessKey`. Utilice la siguiente tabla para determinar qué valor ingresar en las columnas **Valor inicial** y **Valor actual** para cada variable. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/tutorials-using-postman-configuration.html) Después de crear estas variables, la ventana **MANAGE ENVIRONMENTS** (GESTIONAR ENTORNOS) será similar al ejemplo que se muestra en la siguiente imagen. ![\[\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png) Cuando termine, elija **Guardar**. **importante** Las claves de acceso que se muestran en la imagen anterior son ficticias. No comparta las claves de acceso de IAM con otras personas. Postman incluye características que le permiten compartir y exportar los entornos. Si utiliza estas características, asegúrese de no compartir el ID de clave de acceso y la clave de acceso secreta con cualquier persona que no debería tener acceso a estas credenciales. Para obtener más información, consulte [Prácticas recomendadas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) en la *Guía del usuario de IAM*. 1. (Opcional) Repita los pasos 1 a 4 para cada entorno adicional que desea crear. **sugerencia** En Postman, puede crear todos los entornos que necesite. Puede utilizar entornos de las siguientes maneras: Cree un entorno independiente para cada región en la que deba probar la API de Amazon Pinpoint. Cree entornos asociados a diferentes Cuentas de AWS. Cree entornos que utilicen credenciales asociadas a otro usuario. 1. Cuando termine de crear entornos, vaya a la siguiente sección. ## Crear una colección de Amazon Pinpoint en Postman En Postman, una *recopilación* es un grupo de solicitudes de la API. Las solicitudes de una colección suelen estar unidas por un objetivo común. En esta sección, debe crear una nueva colección que contenga una plantilla de solicitud para cada operación en la API de Amazon Pinpoint. **Para crear la colección de Amazon Pinpoint** 1. En Postman, elija en el menú de más acciones, elija **Archivo** y, a continuación, elija **Importar**. 1. En la ventana **Importar, selecciona Importar** **desde un enlace** y, a continuación, introduce la siguiente URL: [https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json) %20PinPoint.postman\$1Collection.json. Seleccione **Importar**. Postman importa la colección de Amazon Pinpoint, que contiene 120 solicitudes de ejemplo. ## Probar la configuración de Postman Después de importar la colección de Amazon Pinpoint, recomendamos realizar una prueba rápida para verificar que todos los componentes se han configurado correctamente. Puede probar la configuración mediante el envío de una solicitud de `GetApps`. Esta solicitud devuelve una lista de todos los proyectos existentes en la cuenta de Amazon Pinpoint en la región de Región de AWS actual. Esta solicitud no requiere ninguna configuración adicional, por lo que es una buena forma de probar la configuración. **Para probar la configuración de la colección de Amazon Pinpoint** 1. En el panel de navegación izquierdo, seleccione **Colecciones**, amplíe la colección de **Amazon Pinpoint** y, a continuación, amplíe la carpeta **Aplicaciones**. 1. En la lista **GetApps**de solicitudes, selecciona. 1. Utilice el selector de **Entorno** para elegir el entorno que creó en [Crear entornos de Postman](#tutorials-using-postman-configuration-create-environments). 1. Seleccione **Enviar**. Si la solicitud se envía correctamente, el panel de respuesta muestra un estado de `200 OK`. Verá una respuesta con un aspecto similar al del ejemplo en la siguiente imagen. ![\[\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png) **nota** Si no ha creado ningún proyecto en las devoluciones Región de AWS de Amazon Pinpoint. `{ "Item": [] }` Esta respuesta muestra una lista de todos los proyectos de Amazon Pinpoint que existen en la cuenta en la región que eligió en el paso 3. ### Resolución de problemas Cuando envíe la solicitud, es posible que vea un error. Consulte la siguiente lista para ver los distintos errores comunes que podría detectar y los pasos que podría seguir para resolverlos. | Mensaje de error | Problema | Resolución | | --- | --- | --- | | Could not get any response Se ha producido un error al conectarse a https://%7B%7Bendpoint%7D%7D/v1/apps. | No se aplica ningún valor actual para la variable `{{endpoint}}`, que se establece cuando elige un entorno. | Utilice el selector de entorno para elegir un entorno. | | El token de seguridad incluido en la solicitud no es válido. | Postman no ha podido encontrar el valor actual de su ID de clave de acceso o la clave de acceso secreta. | Elija el icono del engranaje cerca del selector de entorno y, a continuación, seleccione el entorno actual. Verifique que los valores `accessKey` y `secretAccessKey` aparezcan en las columnas **VALOR INICIAL** y **VALOR ACTUAL** y de que ha especificado las credenciales correctamente. | | «Mensaje»: «El usuario: arn:aws:iam: :123456789012:user/ no PinpointPostmanUser está autorizado a realizar: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012: \$1» GetApps | La política de IAM asociada al usuario no incluye los permisos pertinentes. | Verifique que el usuario tenga los permisos que se describen en [Crear una política de IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy) y que ha proporcionado las credenciales correctas al crear el entorno en el [Crear espacio de trabajo de Postman](#tutorials-using-postman-configuration-create-environments). | **Siguiente**: [Enviar solicitudes adicionales](tutorials-using-postman-sample-requests.md) # Enviar solicitudes a la API de Amazon Pinpoint Cuando termine de configurar y probar Postman, podrá empezar a enviar solicitudes adicionales a la API de Amazon Pinpoint. En esta sección se incluye información que debe conocer antes de empezar a enviar solicitudes. También incluye dos solicitudes de ejemplo que describen cómo utilizar la colección de Amazon Pinpoint. **importante** Cuando haya completado los procedimientos de esta sección, enviará solicitudes a la API de Amazon Pinpoint. Estas solicitudes crean nuevos recursos en la cuenta de Amazon Pinpoint, modifique los recursos existentes, envían mensajes, cambian la configuración de los proyectos de Amazon Pinpoint y usan otras características de Amazon Pinpoint. Actúe con precaución al llevar a cabo estas solicitudes. ## Ejemplos de la colección de Postman de Amazon Pinpoint Debe configurar la mayoría de las operaciones en la colección de Postman de Amazon Pinpoint antes de poder usarlas. Para las operaciones `GET` y `DELETE`, normalmente solo debe modificar las variables que se establecen en la pestaña **Pre-request Script (Script previo a la solicitud)**. **nota** Al usar la política de IAM que se muestra en [Crear una política de IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy), no puede llevar a cabo ninguna de las solicitudes `DELETE` que se incluyen en esta colección. Por ejemplo, la operación `GetCampaign` requiere que especifique un `projectId` y un `campaignId`. En la pestaña **Pre-request Script (Script previo a la solicitud)**, ambas variables están presentes y se rellenan con valores de ejemplo. Elimine los valores de ejemplo y sustitúyalos por los valores adecuados para la campaña y el proyecto de Amazon Pinpoint. De estas variables, la más utilizada es la variable `projectId`. El valor de esta variable debe ser el identificador único del proyecto al que se aplica su solicitud. Para obtener una lista de estos identificadores para los proyectos, haga referencia a la respuesta a la solicitud `GetApps` que ha enviado en el paso anterior de este tutorial. En esa respuesta, el campo de `Id` proporciona el identificador único para un proyecto. Para obtener más información sobre la operación `GetApps` y el significado de cada campo en la respuesta, consulte [Aplicaciones](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) en la *Referencia de la API de Amazon Pinpoint*. **nota** En Amazon Pinpoint, un “proyecto” es lo mismo que una “aplicación”. Para las operaciones `POST` y `PUT`, también debe modificar el cuerpo de la solicitud para incluir los valores que desea enviar a la API. Por ejemplo, al enviar una solicitud `CreateApp`, que es una solicitud `POST`, debe especificar un nombre para el proyecto que cree. Puede modificar la solicitud en la pestaña **Body (Cuerpo)**. En este ejemplo, reemplace el valor situado junto a `"Name"` por el nombre del proyecto. Si desea añadir etiquetas al proyecto, puede especificarlas en el objeto `tags`. O bien, si no desea añadir etiquetas, puede eliminar todo el objeto `tags`. **nota** La operación `UntagResource` también requiere que especifique los parámetros de la URL. Puede especificar estos parámetros en la pestaña **Params (Parámetros)**. Reemplace los valores de la columna **VALUE (VALOR)** por las etiquetas que desea quitar para el recurso especificado. ## Ejemplo de solicitud: Crear un proyecto mediante la operación `CreateApp` Antes de crear segmentos y campañas en Amazon Pinpoint, primero debe crear un proyecto. En Amazon Pinpoint, un *proyecto* consta de segmentos, campañas, configuraciones y datos unidos por un objetivo común. Por ejemplo, podría usar un proyecto para incluir todo el contenido relacionado con una aplicación concreta o con una iniciativa de marketing o una marca específica. Al agregar información del cliente a Amazon Pinpoint, dicha información se asocia a un proyecto. **Para crear un proyecto mediante el envío de una solicitud CreateApp de API** 1. En el menú **Entornos**, selecciona el lugar en el Región de AWS que deseas crear el proyecto. ![\[\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) En este ejemplo, Postman se ha configurado para que el menú **Environments** (Entornos) muestre las siguientes cuatro opciones: + Este de EE. UU. (Norte de Virginia) + Oeste de EE. UU. (Oregón) + Europa (Fráncfort) + Europa (Irlanda) 1. En la carpeta **Aplicaciones**, elija la **CreateApp**operación>. ![\[\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) La carpeta **Aplicaciones** de la colección de Postman de Amazon Pinpoint está ampliada y muestra las siguientes solicitudes: + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. En la pestaña **Body (Cuerpo)**, situada junto a `"Name"`, reemplace el valor de marcador de posición (`"string"`) por un nombre para la campaña, como **"MySampleProject"**. 1. Elimine la coma después del nombre de la campaña y, a continuación, elimine todo el objeto `tags` entre las líneas 3 y 5. Cuando haya terminado, la solicitud debe tener un aspecto similar al del ejemplo que se muestra en el siguiente fragmento de código. ``` { "Name": "MySampleProject" } ``` Postman está configurado para enviar la solicitud como una carga JSON sin procesar. 1. Seleccione **Enviar**. Si la campaña se crea correctamente, el panel de respuesta muestra un estado `201 Created`. ``` { "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} } ``` ## Ejemplo: Enviar un correo electrónico mediante la operación `SendMessages` Es muy habitual usar la API de Amazon Pinpoint de `SendMessages` para enviar mensajes transaccionales. Una ventaja de enviar mensajes mediante la API `SendMessages`, en oposición a la creación de campañas, es que puede enviar mensajes a cualquier dirección, como una dirección de correo electrónico, un número de teléfono o un token de dispositivo. La dirección a la que envía mensajes no debe existir en la cuenta de Amazon Pinpoint. Vamos a comparar este método con el envío de mensajes mediante la creación de campañas. Antes de enviar una campaña en Amazon Pinpoint, debe agregar puntos de conexión a la cuenta de Amazon Pinpoint, crear segmentos, crear la campaña y llevar a cabo la campaña. En el ejemplo de esta sección se le muestra cómo enviar un mensaje de correo electrónico de transacciones directamente a una dirección de correo electrónico específica. Puede modificar esta solicitud para enviar mensajes a través de otros canales, como SMS, inserción en móvil o voz. **Para enviar un mensaje de correo electrónico mediante el envío de una SendMessages solicitud** 1. Compruebe que el canal de correo electrónico esté habilitado para el proyecto y que la dirección de correo electrónico o el dominio que desee utilizar para enviar y recibir el mensaje estén configurados. Para obtener más información, consulte [Habilitación y desactivación del canal de correo electrónico](pinpoint/latest/userguide/channels-email-setup.html) y [Verificación de las identidades de correo electrónico](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) en la *Guía del usuario de Amazon Pinpoint*. **nota** Para completar el procedimiento de esta sección, debe verificar una dirección de correo electrónico 1. En el menú **Entornos**, selecciona el lugar desde el Región de AWS que deseas enviar el mensaje. En este ejemplo, Postman se ha configurado para que el menú **Environments** (Entornos) muestre las siguientes cuatro opciones: + Este de EE. UU. (Norte de Virginia) + Oeste de EE. UU. (Oregón) + Europa (Fráncfort) + Europa (Irlanda) 1. En la carpeta **Mensajes**, elija la **SendMessages**operación. ![\[\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. En la pestaña **Pre-request Script (Script previo a la solicitud)**, reemplace el valor de la variable `projectId` por el ID de un proyecto que ya exista en la región que seleccionó en el paso 2 de esta sección. 1. En la pestaña **Body (Cuerpo)**, elimine la solicitud de ejemplo que se muestra en el editor de solicitudes. Pegue el siguiente código: ``` { "MessageConfiguration":{ "EmailMessage":{ "FromAddress":"sender@example.com", "SimpleEmail":{ "Subject":{ "Data":"Sample Amazon Pinpoint message" }, "HtmlPart":{ "Data":"

Test message

This is a sample message sent from Amazon Pinpoint using the SendMessages API.

" }, "TextPart":{ "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API." } } } }, "Addresses":{ "recipient@example.com": { "ChannelType": "EMAIL" } } } ``` 1. En el código anterior, *sender@example.com* sustitúyalo por tu dirección de correo electrónico verificada. *recipient@example.com*Sustitúyala por la dirección de correo electrónico verificada a la que deseas enviar el mensaje. **nota** Si la cuenta sigue en el entorno aislado de correo electrónico de Amazon Pinpoint, solo podrá enviar correos electrónicos a direcciones o dominios que se verifiquen en la cuenta de Amazon Pinpoint. Para obtener más información acerca de cómo quitar la cuenta del entorno aislado, consulte [Solicitud de acceso de producción para el correo electrónico](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) en la *Guía del usuario de Amazon Pinpoint*. 1. Seleccione **Enviar**. Si el mensaje se envía correctamente, el panel de respuesta mostrará un estado `200 OK`. ``` { "ApplicationId": "12345678901234567890123456789012", "RequestId": "", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "", "MessageId": "" } } } ```