**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.
# Genere contraseñas de un solo uso (OTPs) con Amazon Pinpoint
Amazon Pinpoint incluye una característica de administración de contraseñas de un solo uso (OTP) que puede utilizar para generar contraseñas nuevas de un solo uso y enviarlas a los destinatarios como mensajes SMS.
**importante**
Para utilizar esta característica, la cuenta debe tener acceso a producción y una identidad de origen activa. Para obtener más información, consulte [Acerca del entorno limitado de SMS/MMS and Voice y](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html) [Solicitud de un número de teléfono](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request.html) en la Guía del *usuario AWS final de mensajería por SMS*.
En algunos países y regiones, debe obtener un número de teléfono dedicado o un ID de origen antes de poder enviar mensajes SMS. Por ejemplo, cuando envía mensajes a destinatarios en Estados Unidos, debe tener un número gratuito dedicado, un número 10DLC o un código corto. Cuando envíe mensajes a destinatarios en India, debe tener un ID de remitente registrado, que incluya un ID de entidad principal (PEID) y un ID de plantilla. Se siguen aplicando estos requisitos cuando utiliza la característica de OTP.
Para utilizar esta característica, necesita permisos para enviar y verificar mensajes de OTP, consulte [Contraseñas únicas](permissions-actions.md#permissions-actions-apiactions-otp). Si necesita ayuda para determinar los permisos, consulte [Solución de problemas de la administración de identidades y accesos de Amazon Pinpoint](security_iam_troubleshoot.md).
Puede utilizar la operación `SendOtpMessages` en la API de Amazon Pinpoint para enviar un código de OTP a un usuario de la aplicación. Cuando utiliza esta API, Amazon Pinpoint genera un código aleatorio y se lo envía al usuario como mensaje SMS. La solicitud puede incluir los siguientes parámetros:
+ `Channel`: el canal de comunicación por el que se envía el código de OTP. Actualmente, solo se admiten los mensajes SMS, por lo que el único valor aceptable es el SMS.
+ `BrandName`: el nombre de la marca, empresa o producto asociado al código de OTP. Este nombre puede contener hasta 20 caracteres.
**nota**
Cuando Amazon Pinpoint envía el mensaje de OTP, el nombre de la marca se inserta automáticamente en la siguiente plantilla de mensaje:
```
This is your One Time Password: {{otp}} from {{brand}}
```
Por lo tanto, si especificas ExampleCorp el nombre de tu marca y Amazon Pinpoint genera una contraseña de un solo uso llamada 123456, enviará el siguiente mensaje a tu usuario:
```
This is your One Time Password: 123456 from ExampleCorp
```
+ `CodeLength`: el número de dígitos que habrá en el código de OTP que se envía al destinatario. Los códigos de OTP pueden contener entre 5 y 8 dígitos, ambos incluidos.
+ `ValidityPeriod`: la cantidad de tiempo, en minutos, durante el que el código de OTP será válido. El periodo de validez puede oscilar entre 5 y 60 minutos, ambos incluidos.
+ `AllowedAttempts`: el número de veces que el destinatario puede intentar verificar la OTP sin éxito. Si el número de intentos supera este valor, la OTP deja de ser válida automáticamente. El número máximo de intentos permitidos es 5.
+ `Language`: el idioma, en formato IETF BCP-47, que se utilizará al enviar el mensaje. Los valores aceptables son:
+ `de-DE`: alemán
+ `en-GB`: inglés (Reino Unido)
+ `en-US`: inglés (EE. UU.)
+ `es-419`: español (Latinoamérica)
+ `es-ES`: español
+ `fr-CA`: francés (Canadá)
+ `fr-FR`: francés
+ `it-IT`: italiano
+ `ja-JP`: japonés
+ `ko-KR`: coreano
+ `pt-BR`: portugués (Brasil)
+ `zh-CN`: chino (simplificado)
+ `zh-TW`: chino (tradicional)
+ `OriginationIdentity`: la identidad de origen (como un código largo, un código corto o un ID del remitente) que se utiliza para enviar el código de OTP. Si utiliza un código largo o un número gratuito para enviar la OTP, el número de teléfono debe tener el formato E.164.
+ `DestinationIdentity`: el número de teléfono en formato E.164 al que se envió el código de OTP.
+ `ReferenceId`: un ID de referencia único para la solicitud. El ID de referencia coincide exactamente con el ID de referencia que proporciona al verificar la OTP. El ID de referencia puede contener entre 1 y 48 caracteres, ambos incluidos.
+ `EntityId`: un ID de entidad registrado con una agencia reguladora. Actualmente, este parámetro solo se usa cuando se envían mensajes a destinatarios en India. Si no envía a destinatarios en India, puede omitir este parámetro.
+ `TemplateId`: un ID de plantilla registrado con una agencia reguladora. Actualmente, este parámetro solo se usa cuando se envían mensajes a destinatarios en India. Si no envía a destinatarios en India, puede omitir este parámetro.
**nota**
Para obtener más información sobre cómo enviar mensajes SMS a destinatarios en la India, consulte [India sender ID registration process](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations-sms-senderid-india.html) en la *Guía del usuario de Amazon Pinpoint*.
Para asegurarse de que su cuenta de Amazon Pinpoint está configurada correctamente para enviar mensajes OTP, puede utilizarla AWS CLI para enviar un mensaje de prueba. Para obtener más información al respecto AWS CLI, consulte la Guía del [AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
Para enviar un mensaje OTP de prueba mediante el AWS CLI, ejecute el [send-otp-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-otp-message.html)comando en la terminal:
```
aws pinpoint send-otp-message --application-id 7353f53e6885409fa32d07cedexample --send-otp-message-request-parameters Channel=SMS,BrandName=ExampleCorp,CodeLength=5,ValidityPeriod=20,AllowedAttempts=5,OriginationIdentity=+18555550142,DestinationIdentity=+12065550007,ReferenceId=SampleReferenceId
```
En el comando anterior, haga lo siguiente.
+ *7353f53e6885409fa32d07cedexample*Sustitúyalo por el identificador de tu aplicación.
+ *ExampleCorp*Sustitúyalo por el nombre de su empresa.
+ *5*Sustitúyelo por el número de dígitos que habrá en el código OTP que se envía al destinatario. `CodeLegth`
+ *20*Sustitúyalo por el tiempo, en minutos, durante el que el código OTP será válido. `ValidityPeriod`
+ *5*Sustitúyalo por el número de veces que el destinatario puede intentar verificar la OTP sin éxito. `AllowedAttempts`
+ *\$118555550142*`OriginationIdentity`Sustitúyalo por la identidad de origen que se utiliza para enviar el código OTP.
+ *\$112065550007*`DestinationIdentity`Sustitúyalo por el número de teléfono al que se va a enviar el código OTP.
+ *SampleReferenceId*`ReferenceId`Sustitúyalo por un identificador de referencia único para la solicitud.
## Respuesta de `SendOtpMessage`
Cuando envía correctamente un mensaje de OTP, recibe una respuesta similar al siguiente ejemplo:
```
{
"MessageResponse": {
"ApplicationId": "7353f53e6885409fa32d07cedexample",
"RequestId": "255d15ea-75fe-4040-b919-096f2example",
"Result": {
"+12065550007": {
"DeliveryStatus": "SUCCESSFUL",
"MessageId": "nvrmgq9kq4en96qgp0tlqli3og1at6aexample",
"StatusCode": 200,
"StatusMessage": "MessageId: nvrmgq9kq4en96qgp0tlqli3og1at6aexample"
}
}
}
}
```