Solicita un número de teléfono - SMS de Amazon Pinpoint
Estado del número de teléfono

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.

Solicita un número de teléfono

Con la consola SMS de Amazon Pinpoint, le recomendaremos una de las siguientes identidades de origen en función de su caso de uso. Las recomendaciones se basan en sus criterios de entrada, que incluyen si necesita capacidades de SMS o voz, un número bidireccional y una estimación de los mensajes mensuales.

nota

Los siguientes tipos de números de teléfono deben solicitarse en la consola del Support Center.

Puede utilizar la consola SMS de Amazon Pinpoint o AWS CLI solicitar un número de teléfono nuevo.

Request a phone number (Console)

Para solicitar un número de teléfono mediante la consola de Amazon Pinpoint SMS, siga estos pasos:

Solicite un número de teléfono (consola)

  1. Abra la consola de Amazon Pinpoint SMS en https://console.aws.amazon.com/sms-voice/.

  2. En el panel de navegación, en Configuraciones, elija Números de teléfono y, a continuación, Solicitar originador.

  3. En la página Seleccionar país, debe elegir el País de destino del mensaje en el menú desplegable al que se enviarán los mensajes. Elija Siguiente.

  4. En la sección Caso de uso de mensajería, introduzca lo siguiente:

    • En Capacidades numéricas, seleccione SMS, Voz o ambos, según sus necesidades.

      importante

      Las funciones de SMS y voz no se pueden cambiar una vez adquirido el número de teléfono.

      • SMS: elija si necesita capacidades de SMS.

      • Voz (texto a audio): elija si necesita capacidades de voz.

    • En Volumen mensual estimado de mensajes SMS por mes - Opcional, elija el número estimado de mensajes SMS que enviará cada mes.

    • En Sede de la empresa - Opcional, elija una de las siguientes opciones:

      • Local: elija esta opción si la sede de su empresa se encuentra en el mismo país que sus clientes, quienes reactivarán los mensajes SMS. Por ejemplo, debería elegir esta opción si su sede se encuentra en los Estados Unidos y los usuarios que recibirán los mensajes también se encuentran en los Estados Unidos.

      • Internacional: elija esta opción si la sede de su empresa no está en el mismo país que sus clientes, quienes reactivarán los mensajes SMS.

    • En Mensajería bidireccional, elija Sí si necesita la mensajería bidireccional.

  5. Elija Siguiente.

  6. En Seleccione el tipo de originador, elija el tipo de número de teléfono recomendado o uno de los tipos de números disponibles. Las opciones disponibles se basan en la información del caso de uso que ha indicado en los pasos anteriores.

    Si eliges 10 DLC y ya tienes una campaña registrada, puedes elegir la campaña entre Asociar o registrar para añadir el número de teléfono de 10 DLC a la campaña de 10 DLC.

    Si el tipo de número que deseas no está disponible, puedes elegir Anterior para volver atrás y modificar tu caso de uso. Compruebe también la casilla Países y regiones admitidos (canal de SMS) para asegurarse de que el tipo de originador que desea es compatible en el país de destino.

    Si quieres solicitar un código corto o largo, debes abrir una caja con AWS Supportél. Para obtener más información, consulte Solicitud de códigos cortos para mensajes SMS con Amazon Pinpoint SMS y Solicitud de códigos largos dedicados para la mensajería SMS con Amazon Pinpoint SMS.

  7. Elija Siguiente.

  8. En Revisar y solicitar, puede verificar y editar la solicitud antes de enviarla. Seleccione Request (Solicitar).

  9. En función del tipo de número de teléfono que haya solicitado, puede aparecer una ventana Registro necesario. Su número de teléfono o el ID de emisor está asociado a este registro y no puede enviar mensajes hasta que se apruebe el registro. Para obtener más información sobre los requisitos de registro, consulteInscripciones.

    1. Para Nombre del formulario de registro, introduzca un nombre descriptivo.

    2. Seleccione Comenzar registro para finalizar el registro del número de teléfono o Registrarse después.

      importante

      Su número de teléfono o ID de remitente no pueden enviar mensajes hasta que se apruebe el registro.

      Se le seguirá facturando la cuota de arrendamiento periódica mensual del número de teléfono, independientemente del estado de registro. Para obtener más información sobre los requisitos de registro, consulte. Inscripciones

Request a phone number (AWS CLI)

Puede usar el request-phone-numbercomando para agregar nuevos números de teléfono a su cuenta. La disponibilidad del número de teléfono y las características compatibles varían según el país.

importante

Es posible que tengas que registrar el número de teléfono o el identificador del remitente después de completar la solicitud. Se le seguirá facturando la cuota de arrendamiento periódica mensual del número de teléfono, independientemente del estado de registro. Para obtener más información sobre los requisitos de registro, consulteInscripciones.

Solicitud de un número de teléfono

  • En la línea de comandos, escriba el comando siguiente.

    $ aws pinpoint-sms-voice-v2 request-phone-number \
> --iso-country-code XX \
> --message-type TRANSACTIONAL \
> --number-capabilities VOICE \
> --number-type LONG_CODE \
> --pool-id poolId \
> --deletion-protection-enabled \
> --opt-out-list-name optOutListName \
> --registration-id CO123EX

    En el comando anterior, realice los siguientes cambios:

    • Sustituya XX por el código ISO-3166 alpha-2 de dos letras para el país del número de teléfono (por ejemplo, CA para Canadá).

    • Si desea usar el número de teléfono para enviar contenido promocional o relacionado con el marketing, sustituya TRANSACTIONAL por PROMOTIONAL. De lo contrario, utilice TRANSACTIONAL.

    • Si desea solicitar un número de teléfono para enviar mensajes SMS, sustituya VOICE por SMS. También puede solicitar un número de teléfono que se pueda usar para enviar mensajes SMS y de voz especificando SMS VOICE.

    • Sustituya LONG_CODE por el tipo de número de teléfono que desea solicitar. Los valores admitidos son LONG_CODE, TOLL_FREE y TEN_DLC.

    • Sustituya poolId por el ID o nombre de recurso de Amazon (ARN) del grupo al que desea agregar el número de teléfono. Este parámetro es opcional. Si no desea agregar el número de teléfono a un grupo, omita este parámetro.

    • Si desea activar la protección contra la eliminación de este número de teléfono, añada el --deletion-protection-enabled parámetro. La protección contra eliminación está desactivada de forma predeterminada. Si la protección contra la eliminación está habilitada, no podrás eliminar el número de teléfono mediante la ReleasePhoneNumberAPI, a menos que actualices la configuración del número de teléfono para deshabilitar esta función.

    • Sustituya optOutList el nombre por el nombre o el ARN de la lista de exclusión que desee asociar al número de teléfono. Este parámetro es opcional. Si no desea asociar el número de teléfono a una lista de exclusión, omita este parámetro.

    • Si solicita un número de teléfono para usarlo en una campaña de 10DLC, sustituya CO123EX por el ID de la campaña de 10DLC que desea usar.

      nota

      Si planea usar un número de teléfono 10DLC, primero debe registrar la empresa y la campaña. Actualmente, la única forma de completar estos procesos de registro es utilizar la consola SMS de Amazon Pinpoint. Para obtener más información sobre el registro de 10DLC, consulte. Proceso de registro de 10DLC

Si el número se agregó correctamente a la cuenta, verá un resultado similar al siguiente:

{
    "PhoneNumberArn": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-615790209ea34aea8da9b729fexample",
    "PhoneNumberId": "phone-615790209ea34aea8da9b729fexample",
    "PhoneNumber": "+12045550123",
    "Status": "PENDING",
    "IsoCountryCode": "CA",
    "MessageType": "TRANSACTIONAL",
    "NumberCapabilities": [
        "SMS"
    ],
    "NumberType": "LONG_CODE",
    "MonthlyLeasingPrice": "1.00",
    "TwoWayEnabled": false,
    "SelfManagedOptOutsEnabled": false,
    "OptOutListName": "Default",
    "DeletionProtectionEnabled": false,
    "CreatedTimestamp": 1645568542.0
}
nota

Cuando compra un número de teléfono por primera vez, el valor del atributo de Status es PENDING. Cuando el número de teléfono esté listo para usarse, el valor de Status cambia a ACTIVE.

Si un número de teléfono que cumple los parámetros especificados no está disponible, la solicitud produce un error.

Modify phone number capabilities (AWS CLI)

Después de solicitar un número de teléfono, puede usar la update-phone-numberCLI para cambiar la configuración de ese número de teléfono o para habilitar funciones adicionales. Puede cambiar varios ajustes de número de teléfono, incluidos el grupo y la lista de exclusión que están asociados al número de teléfono, así como la configuración de protección contra la eliminación.

Un ejemplo de una característica adicional que puede habilitar actualizando un número de teléfono es la mensajería bidireccional. La compatibilidad para la mensajería bidireccional varía en función del país al que planee enviar mensajes. Para obtener una lista de los países compatibles, consultePaíses y regiones admitidos (canal de SMS).

$ aws pinpoint-sms-voice-v2 update-phone-number \
> --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example \
> --deletion-protection-enabled true \
> --opt-out-list-name optOutListName \ 
> --self-managed-opt-outs-enabled true \
> --two-way-enabled true \
> --two-way-channel-arn arn:aws:sns:us-east-1:111122223333:MyTopic

En el comando anterior, haga lo siguiente.

  • Sustituya phone-d2b0f5dd4fd14ebdb2a3b9128example por el PhoneNumber ID o el nombre de recurso de Amazon (ARN) del número de teléfono que desee actualizar. Puede encontrar ambos valores mediante la DescribePhoneNumbers operación.

  • Sustituya optOutList el nombre por el nombre de la lista de exclusión que desee asociar a este número de teléfono.

  • Si desea desactivar la característica de protección contra la eliminación, cambie el valor del parámetro DeletionProtectionEnabled por false.

  • Si desea autogestionar la función de exclusión por SMS, cambie el valor del SelfManagedOptOutsEnabled parámetro a. false

  • Si desea deshabilitar la mensajería SMS bidireccional para este número de teléfono, cambie el valor del parámetro a. TwoWayEnabled false

  • Si habilita la característica de mensajería bidireccional para el número de teléfono, debe especificar el ARN de un tema de Amazon SNS. Sustituya arn:aws:sns:us-east- 1:111122223333: por el MyTopic ARN del tema de Amazon SNS que desee usar. Cuando reciba mensajes entrantes, se enviarán al tema que especifique.

El parámetro PhoneNumberId es el único parámetro requerido para este comando. Puede omitir cualquiera de los demás parámetros si no desea cambiar la configuración correspondiente.

List phone numbers (AWS CLI)

Puede utilizar el describe-phone-numberspara obtener más información sobre los números de teléfono de origen de su cuenta de Amazon Pinpoint.

Para obtener una lista de todos los números de teléfono de su cuenta mediante el AWS CLI

  • En la línea de comandos, escriba el comando siguiente.

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers

La respuesta de este comando incluye detalles acerca de todos los números de teléfono de la cuenta. También puede ver información acerca de números de teléfono específicos al incluir el parámetro PhoneNumberId.

Para ver información sobre un número de teléfono específico mediante el AWS CLI

  • En la línea de comandos, escriba el comando siguiente.

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \
>  --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example

En el ejemplo anterior, sustituya phone-d2b0f5dd4fd14ebdb2a3b9128example por el PhoneNumber ID o el nombre de recurso de Amazon (ARN) del número de teléfono sobre el que desea ver más información.

También puede usar el parámetro filter para filtrar la lista de números de teléfono en función de los criterios que defina. Por ejemplo, puede filtrar por el país del número de teléfono o por sus capacidades (es decir, si admite mensajes SMS o de voz o ambos).

Para ver una lista filtrada de números de teléfono mediante el AWS CLI

  • En la línea de comandos, escriba el comando siguiente.

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \
> --filters Name=number-capability,Values=SMS \
> --filters Name=iso-country-code,Values=CA

El Name de filtro puede ser cualquiera de los siguientes valores:

  • status: el estado actual del número de teléfono, por ejemplo ACTIVE.

  • iso-country-code: el código ISO-3166 alpha-2 de dos caracteres del país del número de teléfono.

  • message-type: el tipo de mensajes que se utiliza para enviar el número de teléfono. Los valores posibles son TRANSACTIONAL o PROMOTIONAL.

  • number-capability: los canales de mensajería que admite el número de teléfono. Los posibles valores son SMS y VOICE.

  • number-type: el tipo de número de teléfono, como LONG_CODE, SHORT_CODE o TOLL_FREE.

  • two-way-enabled: un valor booleano que indica si la mensajería SMS bidireccional está habilitada o no.

  • self-managed-opt-outs-enabled: un valor booleano que indica si las exclusiones de SMS autoadministradas están habilitadas o no.

  • opt-out-list-name: el nombre de la lista de exclusión asociada al número de teléfono.

  • deletion-protection-enabled: un valor booleano que indica si el número de teléfono se puede eliminar o no mediante la operación DeletePhoneNumber.

Temas

Estado del número de teléfono

Cuando compras un número de teléfono por primera vez, el estado del número de teléfono esPENDING. Cuando el número de teléfono esté listo para usarse, el estado del número de teléfono seráACTIVE. Si el número de teléfono requiere registro, debe completarlo antes de cambiar el estado de número del número de teléfono aACTIVE.

Estado del número de teléfono

  1. Abra la consola de Amazon Pinpoint SMS en https://console.aws.amazon.com/sms-voice/.

  2. En el panel de navegación, en Configuraciones, elija Números de teléfono.

  3. En los números de teléfono, el estado del número de teléfono aparece en la columna Estado del número.

    • PENDING— El número de teléfono no está listo para su uso. Es posible que necesite registrar el número de teléfono. Para obtener más información, consulte Inscripciones.

    • ACTIVE— El número de teléfono está listo para su uso.