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.
# Cree un registro mediante el SMS AWS CLI de mensajería para el usuario AWS final
En la siguiente sección se ofrecen ejemplos de cómo crear, rellenar y enviar un registro mediante la AWS CLI. Para ver ejemplos de cómo crear y enviar un registro de número de teléfono gratuito mediante python o shell script, consulte [Automatizar los registros de números gratuitos de los usuarios AWS finales en EE](https://aws.amazon.com/blogs/messaging-and-targeting/automate-us-tfn-registrations/). UU. Los registros varían de un país a otro, algunos son formularios de una sola página, mientras que otros, como 10DLC, pueden requerir el envío de varios formularios en un orden específico. Compruebe el [registro individual](registrations.md) para obtener más información sobre un pedido y si debe cargar alguna documentación complementaria, como una carta de autorización (LOA).
## Introducción
Algunos países requieren que registre la identidad de su empresa para poder comprar una identidad de origen y revisar los mensajes que envía a los destinatarios de sus países.
+ La información de registro que proporcione puede revisarla un tercero. El tercero varía de un país a otro, pero podría ser una agencia reguladora gubernamental o un operador de telefonía móvil el que realice la revisión.
+ El tiempo que tarda la empresa externa en revisar su registro varía según el tipo de registro.
## Requisitos previos
Antes de comenzar, necesitará:
+ Instale y configure el AWS CLI, consulte [Configurar la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) en la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
+ Y Cuenta de AWS con [permisos](security-iam.md) para usar la mensajería SMS para el usuario AWS final en la región de destino.
+ Un registro **AssociationBehavior**especifica el orden en el que un registro puede asociarse a una identidad de origen y disociarse de una identidad de origen, consulte. [SupportedAssociation](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SupportedAssociation.html)
+ `ASSOCIATE_BEFORE_SUBMIT` la identidad de origen debe proporcionarse al enviar un registro.
+ `ASSOCIATE_ON_APPROVAL` se aplica a todos los registros de ID de remitente. El ID de remitente se proporcionará automáticamente una vez que se apruebe el registro.
+ `ASSOCIATE_AFTER_COMPLETE` se aplica a los registros de números de teléfono cuando primero debe completar un registro y luego asociar uno o más números de teléfono más adelante.
**importante**
Una vez que adquiera una identidad de origen, se le cambiará por ella independientemente del estado de los registros. Consulte [Precios de Mensajes SMS para usuarios finales de AWS](https://aws.amazon.com/end-user-messaging/pricing/).
Una vez que envíe su registro, no podrá realizar ningún cambio en el registro ni anular la asociación de ningún recurso del registro hasta que un tercero lo haya revisado y se lo haya devuelto.
A continuación se enumeran recursos adicionales de registro.
+ [Cómo crear un proceso de suscripción de SMS compatible](https://aws.amazon.com/blogs/messaging-and-targeting/how-to-build-a-compliant-sms-opt-in-process-with-amazon-pinpoint/)
+ [10. Mejores prácticas de registro de contenido descargable para enviar SMS con mensajes de usuario final AWS](https://aws.amazon.com/blogs/messaging-and-targeting/10dlc-registration-best-practices-to-send-sms-with-amazon-pinpoint/)
# Cree un registro (comando AWS CLI create-registration)
Utilice el comando [create-registration](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration.html) para crear un registro nuevo en blanco. El **RegistrationType**parámetro determina el tipo de registro que se va a crear. Si no conoce el valor del tipo de registro que desea crear, utilice el [describe-registration-type-definitions](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registration-type-definitions.html)comando para recuperar una lista de todos los tipos de registro.
Los siguientes ejemplos muestran cómo crear un formulario de registro de número gratuito.
```
$ aws pinpoint-sms-voice-v2 create-registration --registration-type US_TOLL_FREE_REGISTRATION --tags "Key=Name,Value=MyTFNRegistration"
```
Al finalizar correctamente, guarde el valor de, **RegistrationId**ya que será necesario para otros comandos.
**nota**
Para añadir un nombre descriptivo a su registro, debe agregar una etiqueta con la **clave** configurada en **Name** y el **valor** configurado en el nombre descriptivo que va a utilizar.
También puede agregar etiquetas a los recursos con fines de facturación. Consulte [Etiquetado de recursos para facturación](sms-billing-tag.md).
El siguiente ejemplo es el resultado parcial del comando `describe-registration-type-definitions`. Como **AssociationBehavior**está configurado, `ASSOCIATE_BEFORE_SUBMIT` el número gratuito debe comprarse y asociarse al registro antes de poder enviar el registro para su aprobación. Para obtener más información sobre **AssociationBehavior**y **DisassociationBehavior**, consulte. [SupportedAssociation](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SupportedAssociation.html)
```
{
"RegistrationTypeDefinitions": [
{
"RegistrationType": "US_TOLL_FREE_REGISTRATION",
"SupportedAssociations": [
{
"ResourceType": "TOLL_FREE",
"IsoCountryCode": "US",
"AssociationBehavior": "ASSOCIATE_BEFORE_SUBMIT",
"DisassociationBehavior": "DISASSOCIATE_ALL_CLOSES_REGISTRATION"
}
],
"DisplayHints": {
"Title": "US toll-free number registration"
}
},
...
```
# Obtenga las definiciones de los campos (describe-registration-field-definitions AWS CLI comando)
A continuación, debe obtener las definiciones de cada campo para saber cuáles son los requisitos, como el número máximo de caracteres del campo.
Cada registro está dividido en secciones y cada sección tiene uno o varios campos. Utilice el [describe-registration-field-definitions](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registration-field-definitions.html)comando para recuperar todas las definiciones de secciones y campos para un registro. Necesitará el **FieldPath**valor de cada campo más adelante para poder establecer su valor. También **FieldRequirement**se usa para determinar si un campo será obligatorio u opcional.
En los siguientes ejemplos se muestra cómo recuperar definiciones de campo del formulario de registro de número gratuito.
```
$ aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type US_TOLL_FREE_REGISTRATION
```
A continuación, se muestra un ejemplo de salida parcial del comando:
```
{
"RegistrationFieldDefinitions": [
{
"SectionPath": "companyInfo",
"FieldPath": "companyInfo.companyName",
"FieldType": "TEXT",
"FieldRequirement": "REQUIRED",
"TextValidation": {
"MinLength": 1,
"MaxLength": 100,
"Pattern": "^(?=\\s*\\S)[\\s\\S]+$"
},
"DisplayHints": {
"Title": "Company name",
"ShortDescription": "Legal name which your company is registered under.",
"ExampleTextValue": "Example Corp"
}
},
...
```
# Crear archivos adjuntos (create-registration-attachment AWS CLI comando)
Dependiendo del registro, es posible que deba completar y adjuntar una carta de autorización (LOA), un flujo de trabajo opcional u otro tipo de documento obligatorio. Compruebe el [registro individual](registrations.md) para obtener más información y descargar cualquier formulario.
Utilice el [create-registration-attachment](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration-attachment.html)comando para crear el archivo adjunto de registro. Puede cargar el archivo en un bucket de Amazon S3 y utilizar la URL o adjuntar el documento como parte del comando. Utilice uno **AttachmentUrl**o **AttachmentBody**, si se especifican ambos, se devolverá una excepción. El tamaño máximo del archivo es de 500 KB y las extensiones de archivo admitidas son PDF, JPEG y PNG.
En el siguiente ejemplo, se muestra cómo crear el archivo adjunto de registro y cómo utilizar el **AttachmentUrl**parámetro.
```
$ aws pinpoint-sms-voice-v2 create-registration-attachment --attachment-url s3://BucketName/FileName
```
Cuando se completa correctamente, el comando devuelve un **RegistrationAttachmentidentificador** que es necesario para los demás comandos.
Para obtener más información sobre los comandos de Amazon S3, como la creación de un bucket o la carga de un archivo, consulte [Uso de comandos de alto nivel (s3) en la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html).
# Establezca los valores de definición del campo (put-registration-field-value AWS CLI comando)
A continuación, debe agregar valores para todos los campos obligatorios devueltos en el paso *Obtención de las definiciones de campo*, incluidos los archivos adjuntos que haya creado. Le recomendamos que también complete todos los campos opcionales aplicables a su caso de uso. Un campo es obligatorio u opcional en función del **FieldRequirement**valor. Utilice el [put-registration-field-value](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-registration-field-value.html)comando para establecer los valores de los campos.
+ En los siguientes ejemplos se muestra cómo añadir un valor al nombre de la empresa o al valor de texto.
```
$ aws pinpoint-sms-voice-v2 put-registration-field-value --registration-id RegID --field-path companyInfo.companyName --text-value AnyCompany
```
En el comando anterior, sustituya lo siguiente:
+ *RegID*Sustitúyalo por el identificador de registro devuelto por el paso *Crear un registro*.
+ *AnyCompany*Sustitúyalo por el nombre de tu empresa.
+ En los siguientes ejemplos se muestra cómo añadir un valor a un campo seleccionado.
```
$ aws pinpoint-sms-voice-v2 put-registration-field-value --registration-id RegID --field-path messagingUseCase.monthlyMessageVolume --text-choices SelectValue
```
En el comando anterior, sustituya lo siguiente:
+ *RegID*Sustitúyalo por el número de registro devuelto en el paso *Crear un registro*.
+ *SelectValue*Sustitúyalo por uno de los valores de opción del campo.
Use el [describe-registration-field-definitions](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registration-field-definitions.html)comando para obtener las opciones de un solo campo:
```
aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type US_TOLL_FREE_REGISTRATION --field-paths messagingUseCase.monthlyMessageVolume
```
```
{
"RegistrationFieldDefinitions": [
{
"SectionPath": "messagingUseCase",
"FieldPath": "messagingUseCase.monthlyMessageVolume",
"FieldType": "SELECT",
"FieldRequirement": "REQUIRED",
"SelectValidation": {
"MinChoices": 1,
"MaxChoices": 1,
"Options": [
"10",
"100",
"1,000",
"10,000",
"100,000",
"250,000",
"500,000",
"750,000",
"1,000,000",
"5,000,000",
"10,000,000+"
]
},
"DisplayHints": {
"Title": "Monthly SMS volume",
"ShortDescription": "Estimated number of SMS messages which will be sent from this toll-free number each month."
}
}
],
"RegistrationType": "US_TOLL_FREE_REGISTRATION"
}
```
+ En los siguientes ejemplos de código se muestra cómo añadir un archivo adjunto.
```
$ aws pinpoint-sms-voice-v2 put-registration-field-value --registration-id RegID --field-path messagingUseCase.optInImage --registration-attachment-id RegistrationAttachmentID
```
En el comando anterior, sustituya lo siguiente:
+ *RegID*Sustitúyalo por el identificador de registro devuelto por el paso *Crear un registro*.
+ *RegistrationAttachmentID*Sustitúyalo por el identificador del archivo adjunto de registro devuelto en el paso *Crear archivos adjuntos*.
# Solicite una identidad de origen (request-phone-number AWS CLI comando)
**nota**
Una vez que compre una identidad de origen, se le cobrará por ella independientemente del estado de registro. Consulte [Precios de Mensajes SMS para usuarios finales de AWS](https://aws.amazon.com/end-user-messaging/pricing/).
`ASSOCIATE_AFTER_COMPLETE`Si **AssociationBehavior**es el registro, no necesita comprar ni asociar la identidad de origen hasta que se haya presentado y aprobado el registro.
Ahora tiene que solicitar una identidad de origen que luego se asociará al registro. En este ejemplo se muestra cómo utilizar el [request-phone-number](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/request-phone-number.html)comando para solicitar un número de teléfono gratuito a través del. AWS CLI Use el [request-sender-id](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/request-sender-id.html)para solicitar un ID de remitente.
```
$ aws pinpoint-sms-voice-v2 request-phone-number --iso-country-code US --message-type TRANSACTIONAL --number-capabilities SMS --number-type TOLL_FREE
```
Al completarlo correctamente, el comando devuelve el identificador único de número de teléfono necesario para asociar el número de teléfono al registro.
# Asocie un recurso a un registro (create-registration-association AWS CLI comando)
**nota**
`ASSOCIATE_AFTER_COMPLETE`Si **AssociationBehavior**es el registro, no necesita comprar ni asociar la identidad de origen hasta que se haya presentado y aprobado el registro.
Para asociar una identidad de origen al registro, utilice el [create-registration-association](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration-association.html) AWS CLI comando.
```
$ aws pinpoint-sms-voice-v2 create-registration-association --registration-id RegID --resource-id PhoneNumberID
```
En el comando anterior, sustituya lo siguiente:
+ *RegID*Sustitúyalo por el identificador de registro devuelto por el paso *Crear un registro*.
+ *PhoneNumberID*Sustitúyalo por el número de teléfono devuelto en el paso de *solicitud de una identidad de origen*.
**nota**
Este comando se utiliza para asociar cualquier recurso aplicable al registro. Por ejemplo, se puede utilizar para asociar el registro de una campaña 10DLC con el registro de una marca 10DLC.
# Envíe su registro (submit-registration-version AWS CLI comando)
Una vez que envíe el registro, no podrá modificarlo. Revíselo para asegurarse de que todos sus datos son correctos antes de enviarlo.
**importante**
Una vez que haya enviado su registro, no podrá realizar ningún cambio en el registro ni desasociar ningún recurso del registro hasta que un tercero lo haya revisado y se lo haya devuelto.
Para enviar un registro con el, AWS CLI utilice el [submit-registration-version](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration-association.html)comando.
```
$ aws pinpoint-sms-voice-v2 submit-registration-version --registration-id RegID
```
En el comando anterior, sustituya lo siguiente:
+ *RegID*Sustitúyalo por el identificador de registro devuelto por el paso *Crear un registro*.
## Compruebe el estado de sus registros (comando AWS CLI describe-registrations)
Una vez que se haya enviado el registro, podrá comprobar su estado mediante el comando [describe-registrations](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registrations.html) o la [consola](registrations-status.md).
**Si **AssociationBehavior**es el registro, `ASSOCIATE_AFTER_COMPLETE` puede comprar una identidad de origen y asociarla al registro, una vez que el estado del registro esté configurado como COMPLETO.**
Si el estado de su registro cambia a **REQUIRES\$1UPDATES**, podrá buscar y [editar los campos marcados](registrations-edit.md) y volver a enviar el registro. Para ver una lista de los motivos por los que se ha rechazado el registro, consulte [Comentarios de Gen-AI sobre los registros](registrations-genai-feedback.md). Si necesita ayuda para rechazar su registro, puede [abrir un ticket](registrations-request-support.md). Soporte