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.
En la siguiente sección se ofrecen ejemplos de cómo crear, rellenar y enviar un registro mediante el 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. UU
Introducción
Algunos países requieren que registres la identidad de tu empresa para poder comprar una identidad de origen y revisar los mensajes que envías a los destinatarios de su país.
-
La información de registro que proporciones puede ser revisada por 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 que realice la revisión.
-
El tiempo que tarda la empresa externa en revisar tu registro varía según el tipo de registro.
Requisitos previos
Antes de empezar, debe:
-
Instale y configure el AWS CLI, consulte Configurar la AWS CLI en la Guía del AWS Command Line Interface usuario.
-
Y Cuenta de AWS con permisos para usar la mensajería SMS para el usuario AWS final en la región de destino.
-
Un registro AssociationBehaviorespecifica el orden en el que un registro puede asociarse a una identidad de origen y disociarse de una identidad de origen, consulte. SupportedAssociation
ASSOCIATE_BEFORE_SUBMITLa identidad de origen debe proporcionarse al enviar un registro.ASSOCIATE_ON_APPROVALEsto se aplica a todos los registros de ID de remitente. El ID del remitente se proporcionará automáticamente una vez que se apruebe el registro.ASSOCIATE_AFTER_COMPLETEEsto se aplica a los registros de números de teléfono cuando primero debes completar un registro y luego asociar uno o más números de teléfono.
importante
Una vez que compre una identidad de origen, la cambiará independientemente del estado del registro (consulte los precios de la mensajería para el usuario AWS final
). Una vez que envíe 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.
Los siguientes son recursos adicionales para las inscripciones.
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.
nota
Para añadir un nombre descriptivo a su registro, debe añadir una etiqueta con la clave puesta en Name y el valor en el nombre descriptivo que vaya a utilizar.
También puede añadir etiquetas a los recursos con fines de facturación; consulte Etiquetar los recursos para la facturación.
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_REGISTRATIONEl 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. Consulte 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 PDF, JPEG y PNG.
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/FileNameSi 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 la AWS CLI.
A continuación, debe agregar valores para todos los campos obligatorios devueltos por el paso Obtener las definiciones de los campos, lo que incluye todos los archivos adjuntos que haya creado. Te recomendamos que también rellenes todos 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.
En los ejemplos siguientes 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-idRegID--field-pathcompanyInfo.companyName--text-valueAnyCompanyEn el comando anterior, sustituya lo siguiente:
-
RegIDSustitúyalo por el identificador de registro devuelto por el paso Crear un registro. -
AnyCompanySustitú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-idRegID--field-pathmessagingUseCase.monthlyMessageVolume--text-choicesSelectValueEn el comando anterior, sustituya lo siguiente:
-
RegIDSustitúyalo por el identificador de registro devuelto por el paso Crear un registro. -
SelectValueSustitúyalo por uno de los valores de opción del campo.Use el describe-registration-field-definitionscomando para obtener las opciones de un solo campo:
aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type US_TOLL_FREE_REGISTRATION --field-pathsmessagingUseCase.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" }
-
-
Los siguientes ejemplos muestran cómo añadir un archivo adjunto.
$aws pinpoint-sms-voice-v2 put-registration-field-value --registration-idRegID--field-pathmessagingUseCase.optInImage--registration-attachment-idRegistrationAttachmentIDEn el comando anterior, sustituya el siguiente:
-
RegIDSustitúyalo por el identificador de registro devuelto por el paso Crear un registro. -
RegistrationAttachmentIDSustitúyalo por el identificador del archivo adjunto de registro devuelto en el paso Crear archivos adjuntos.
-
nota
Una vez que compre una identidad de origen, se le cobrará por ella independientemente del estado de registro (consulte los precios de mensajería para el usuario AWS final
ASSOCIATE_AFTER_COMPLETESi AssociationBehaviores el registro, no necesita comprar ni asociar la identidad de origen hasta que se haya enviado y aprobado el registro.
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_FREEAl 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.
nota
ASSOCIATE_AFTER_COMPLETESi AssociationBehaviores 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 AWS CLI comando.
$ aws pinpoint-sms-voice-v2 create-registration-association --registration-id RegID --resource-id PhoneNumberIDEn el comando anterior, sustituya lo siguiente:
-
RegIDSustitúyalo por el identificador de registro devuelto por el paso Crear un registro. -
PhoneNumberIDSustitú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 de 10 DLC con el registro de una marca de 10 DLC.
Una vez que envíe su registro, no podrá realizar ningún cambio en él. Revise su registro para asegurarse de que todos sus datos son correctos antes de enviarlos.
importante
Una vez que haya enviado su registro, no podrá realizar ningún cambio en el registro ni desvincular 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-versioncomando.
$ aws pinpoint-sms-voice-v2 submit-registration-version --registration-id RegIDEn el comando anterior, sustituya lo siguiente:
-
RegIDSustitúyalo por el identificador de registro devuelto por el paso Crear un registro.
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é configurado como COMPLETADO.
Si el estado de su registro cambia a REQUIRES_UPDATES, podrá buscar y editar los campos marcados y volver a enviar el registro. Para ver una lista de los motivos por los que se ha rechazado el registro, consulte. Ayuda con los rechazos de registro Si necesita ayuda para rechazar su registro, puede abrir un ticket. Soporte
