**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. # 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": "" } } } ```