Cree un registro mediante la mensajería para AWS CLI el usuario AWS final SMS

Utilice el comando create-registration para crear un registro nuevo en blanco. El RegistrationTypepará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-definitionscomando para recuperar una lista de todos los tipos de registro.

Los siguientes ejemplos muestran cómo crear un formulario de registro de números gratuito.

$ aws pinpoint-sms-voice-v2 create-registration --registration-type US_TOLL_FREE_REGISTRATION --tags "Key=Name,Value=MyTFNRegistration"

Al completarlo correctamente, guarde el valor de RegistrationId, ya que será necesario para otros comandos.

El siguiente ejemplo es un resultado parcial del describe-registration-type-definitions comando. Como AssociationBehaviorestá establecido en ASSOCIATE_BEFORE_SUBMIT el número gratuito, se debe comprar y asociar al registro antes de que el registro pueda enviarse para su aprobación. Para obtener más información sobre AssociationBehaviory DisassociationBehavior, consulte. SupportedAssociation

{
    "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"
            }
        },
...

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 se divide en secciones y cada sección tiene uno o más campos. Utilice el describe-registration-field-definitionscomando para recuperar todas las definiciones de secciones y campos de un registro. Necesitará el FieldPathvalor de cada campo más adelante para poder establecer su valor. También FieldRequirementse usa para determinar si un campo será obligatorio u opcional.

Los siguientes ejemplos muestran cómo recuperar las definiciones de los campos para el formulario de registro gratuito.

$ aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type  US_TOLL_FREE_REGISTRATION

El siguiente es un resultado 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"
            }
        },
...

Según el 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 para obtener más información y descargar cualquier formulario.

Utilice el create-registration-attachmentcomando 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 una de las dos AttachmentBodyopciones AttachmentUrlo, si se especifican ambas, se devolverá una excepción. El tamaño máximo del archivo es de 500 KB y las extensiones de archivo válidas son PDFJPEG, yPNG.

En el siguiente ejemplo, se muestra cómo crear el archivo adjunto de registro y cómo utilizar el AttachmentUrlparámetro.

$ aws pinpoint-sms-voice-v2 create-registration-attachment --attachment-url s3://BucketName/FileName

Si 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 Utilizar comandos de alto nivel (s3) con. AWS CLI

A continuación, debe agregar valores para todos los campos obligatorios devueltos por el paso Obtener las definiciones de los campos, incluidos los archivos adjuntos que haya creado. Te recomendamos que también rellenes los campos opcionales que correspondan a tu caso de uso. Un campo es obligatorio u opcional en función del FieldRequirementvalor. Utilice el put-registration-field-valuecomando para establecer los valores de los campos.

Ahora necesita solicitar una identidad de origen que luego se asociará al registro. En este ejemplo se muestra cómo utilizar el request-phone-numbercomando para solicitar un número de teléfono gratuito a través del. AWS CLI Use el request-sender-idpara 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 del número de teléfono que se necesita para asociar el número de teléfono con el registro.

Para asociar una identidad de origen al registro, utilice el create-registration-association AWS CLI comando.

$ aws pinpoint-sms-voice-v2 create-registration-association --registration-id RegID --resource-id PhoneNumberID

En el comando anterior, sustituya lo siguiente:

Una vez que envíe su registro, no podrá modificarlo. Revise su registro para asegurarse de que todos sus datos son correctos antes de enviarlos.

Para enviar un registro con el, AWS CLI utilice el submit-registration-versioncomando.

$ aws pinpoint-sms-voice-v2 submit-registration-version --registration-id RegID

En el comando anterior, sustituya lo siguiente:

Una vez que se haya enviado su registro, puede comprobar su estado mediante el comando o la consola describe-registrations.

Si AssociationBehaviores el registro, ASSOCIATE_AFTER_COMPLETE puede comprar una identidad de origen y asociarla al registro, una vez que el estado del registro esté establecido en. COMPLETE

Si el estado de su registro cambia a REQUIRES_ UPDATES, puede buscar y editar los campos marcados y volver a enviar el registro. Para ver una lista de los motivos por los que se rechaza el registro, consulte. Ayuda con los rechazos de registro Si necesita ayuda para rechazar su registro, puede abrir un ticket. Soporte