**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. # Asociar usuarios con puntos de conexión de Amazon Pinpoint Un punto de enlace puede incluir atributos que definen un *usuario*, que representa una persona de su público. Por ejemplo, un usuario puede representar a alguien que ha instalado su aplicación móvil o alguien que tenga una cuenta en su sitio web. Puede definir un usuario especificando un ID de usuario único y, opcionalmente, atributos de usuario personalizados. Si alguien utiliza la aplicación en varios dispositivos o si se pueden enviar mensajes a esa persona en varias direcciones, puede asignar el mismo ID de usuario a varios puntos de enlace. En este caso, Amazon Pinpoint sincroniza los atributos de usuario entre los puntos de conexión. Por lo tanto, si agrega un atributo de usuario a un punto de conexión, Amazon Pinpoint agrega dicho atributo a cada punto de conexión que incluye el mismo ID de usuario. Puede añadir atributos de usuario para realizar un seguimiento de los datos que se aplican a una persona y no varía en función del dispositivo que la persona está utilizando. Por ejemplo, puede añadir atributos para el nombre de una persona, la edad o el estado de la cuenta. **sugerencia** Si la aplicación utiliza grupos de usuarios de Amazon Cognito para gestionar la autenticación del usuario, Amazon Cognito puede agregar los ID de usuario y atributos a los puntos de conexión de forma automática. Para el valor de ID de usuario de punto de conexión, Amazon Cognito asigna el valor `sub` que se ha asignado al usuario en el grupo de usuarios. Para obtener información sobre cómo agregar usuarios con Amazon Cognito, consulte [Uso del análisis de Amazon Pinpoint con grupos de usuarios de Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-pinpoint-integration.html) en la *Guía para desarrolladores de Amazon Cognito*. Después de añadir definiciones de usuario a los puntos de enlace, tiene más opciones acerca de cómo segmentar su público. Puede definir un segmento en función de atributos de usuario o puede definir un segmento importando una lista de ID de usuario. Cuando envía un mensaje a un segmento que se basa en usuarios, los destinos posibles incluyen todos los puntos de enlace asociados con cada usuario en el segmento. También tiene más opciones acerca de cómo enviar mensajes a su público. Puede utilizar una campaña para enviar mensajes a un segmento de usuarios o puede enviar un mensaje directamente a una lista de ID de usuario. Para personalizar su mensaje, puede incluir variables de mensajes que se sustituyen por valores de atributos de usuario. ## Ejemplos Los siguientes ejemplos muestran cómo añadir una definición de usuario a un punto de enlace. ------ #### [ AWS CLI ] Puede utilizar Amazon Pinpoint ejecutando comandos con la AWS CLI. **Example Comando Update Endpoint** Para añadir un usuario a un punto de enlace, utilice el comando [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/update-endpoint.html). Para el parámetro `--endpoint-request`, puede definir un nuevo punto de enlace, que puede incluir un usuario. O bien, para actualizar un punto de enlace existente, puede proporcionar solo los atributos que desee cambiar. En el siguiente ejemplo se añade un usuario a un punto de enlace existente proporcionando solo los atributos de usuario: ``` $ aws pinpoint update-endpoint \ > --application-id application-id \ > --endpoint-id endpoint-id \ > --endpoint-request file://endpoint-request-file.json ``` Donde: + *application-id* es el ID del proyecto de Amazon Pinpoint en el que agrega o actualiza un punto de conexión. + *endpoint-id* es el ID que asigna a un nuevo punto de enlace o el ID de un punto de enlace existente que está actualizando. + *endpoint-request-file.json* es la ruta de archivo a un archivo JSON local que contiene la entrada para el parámetro `--endpoint-request`. **Example Archivo de solicitud de punto de enlace** El comando `update-endpoint` de ejemplo utiliza un archivo JSON como argumento para el parámetro `--endpoint-request`. Este archivo contiene una definición de usuario similar a la siguiente: ``` { "User":{ "UserId":"example_user", "UserAttributes":{ "FirstName":["Wang"], "LastName":["Xiulan"], "Gender":["Female"], "Age":["39"] } } } ``` Para los atributos que puede utilizar para definir un usuario, consulte el objeto `User` en el esquema de [EndpointRequest](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#apps-application-id-endpoints-endpoint-id-schemas) en la *Referencia de la API de Amazon Pinpoint*. ------ #### [ AWS SDK para Java ] Puede usar la API de Amazon Pinpoint en las aplicaciones Java mediante el cliente que proporciona AWS SDK para Java. **Example Código** Para agregar un usuario a un punto de conexión, inicialice un objeto EndpointRequest y transfiéralo al método `updateEndpoint` del cliente de `AmazonPinpoint`. Puede utilizar este objeto para definir un nuevo punto de enlace, que puede incluir un usuario. O bien, para actualizar un punto de enlace existente, puede actualizar solo las propiedades que desee cambiar. En el siguiente ejemplo se añade un usuario a un punto de enlace existente añadiendo un objeto EndpointUser al objeto EndpointRequest: ``` import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.pinpoint.PinpointClient; import software.amazon.awssdk.services.pinpoint.model.EndpointRequest; import software.amazon.awssdk.services.pinpoint.model.EndpointUser; import software.amazon.awssdk.services.pinpoint.model.ChannelType; import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointRequest; import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointResponse; import software.amazon.awssdk.services.pinpoint.model.PinpointException; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; ``` ``` public static void updatePinpointEndpoint(PinpointClient pinpoint, String applicationId, String endPointId) { try { List wangXiList = new ArrayList<>(); wangXiList.add("cooking"); wangXiList.add("running"); wangXiList.add("swimming"); Map myMapWang = new HashMap<>(); myMapWang.put("interests", wangXiList); List myNameWang = new ArrayList<>(); myNameWang.add("Wang "); myNameWang.add("Xiulan"); Map wangName = new HashMap<>(); wangName.put("name", myNameWang); EndpointUser wangMajor = EndpointUser.builder() .userId("example_user_10") .userAttributes(wangName) .build(); // Create an EndpointBatchItem object for Mary Major. EndpointRequest wangXiulanEndpoint = EndpointRequest.builder() .channelType(ChannelType.EMAIL) .address("wang_xiulan@example.com") .attributes(myMapWang) .user(wangMajor) .build(); // Adds multiple endpoint definitions to a single request object. UpdateEndpointRequest endpointList = UpdateEndpointRequest.builder() .applicationId(applicationId) .endpointRequest(wangXiulanEndpoint) .endpointId(endPointId) .build(); UpdateEndpointResponse result = pinpoint.updateEndpoint(endpointList); System.out.format("Update endpoint result: %s\n", result.messageBody().message()); } catch (PinpointException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } } ``` Para ver el ejemplo completo de SDK, consulte [AddExampleUser.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javav2/example_code/pinpoint/src/main/java/com/example/pinpoint/AddExampleUser.java) en [GitHub](https://github.com/). ------ #### [ HTTP ] Puede utilizar Amazon Pinpoint realizando solicitudes HTTP directamente a la API de REST. **Example Solicitud PUT al punto de enlace con definición de usuario** Para añadir un usuario a un punto de enlace, emita una solicitud `PUT` al recurso [Endpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html) en el URI siguiente: `/v1/apps/application-id/endpoints/endpoint-id` Donde: + *application-id* es el ID del proyecto de Amazon Pinpoint en el que agrega o actualiza un punto de conexión. + *endpoint-id* es el ID que asigna a un nuevo punto de enlace o el ID de un punto de enlace existente que está actualizando. En su solicitud, incluya los encabezados necesarios y proporcione el JSON [EndpointRequest](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#apps-application-id-endpoints-endpoint-id-schemas) como cuerpo. El cuerpo de la solicitud puede definir un nuevo punto de enlace, que puede incluir un usuario. O bien, para actualizar un punto de enlace existente, puede proporcionar solo los atributos que desee cambiar. En el siguiente ejemplo se añade un usuario a un punto de enlace existente proporcionando solo los atributos de usuario: ``` PUT /v1/apps/application_id/endpoints/example_endpoint HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com X-Amz-Date: 20180415T182538Z Content-Type: application/json Accept: application/json Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20180501/us-east-1/mobiletargeting/aws4_request, SignedHeaders=accept;content-length;content-type;host;x-amz-date, Signature=c25cbd6bf61bd3b3667c571ae764b9bf2d8af61b875cacced95d1e68d91b4170 Cache-Control: no-cache { "User":{ "UserId":"example_user", "UserAttributes":{ "FirstName":"Wang", "LastName":"Xiulan", "Gender":"Female", "Age":"39" } } } ``` Si la solicitud se realiza correctamente, recibirá una respuesta similar a la siguiente: ``` { "RequestID": "67e572ed-41d5-11e8-9dc5-db288f3cbb72", "Message": "Accepted" } ``` ------ ## Información relacionada Para obtener más información acerca del recurso de punto de conexión en la API de Amazon Pinpoint, incluidos los métodos HTTP compatibles y los parámetros de solicitud, consulte [Punto de conexión](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html) en la *Referencia de la API de Amazon Pinpoint.* Para obtener más información sobre la personalización de mensajes con variables, consulte [Variables del mensaje](https://docs.aws.amazon.com/pinpoint/latest/userguide/campaigns-message.html#campaigns-message-variables.html) en la *Guía del usuario de Amazon Pinpoint*. Para obtener información sobre cómo definir un segmento mediante la importación de una lista de ID de usuario, consulte [Importación de segmentos](https://docs.aws.amazon.com/pinpoint/latest/userguide/segments-importing.html) en la *Guía del usuario de Amazon Pinpoint*. Para obtener información sobre cómo enviar un mensaje directo a un máximo de 100 ID de usuario, consulte [Mensajes de usuarios](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-users-messages.html) en la *Referencia de la API de Amazon Pinpoint*. Para obtener información sobre las cuotas que se aplican a los puntos de enlace, incluido el número de atributos de usuario que puede asignar, consulte [Cuotas de punto de enlace](quotas.md#quotas-endpoint).