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, MMS o voz, un número bidireccional y una estimación de los mensajes mensuales.
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)
Abra la consola de Amazon Pinpoint SMS en https://console.aws.amazon.com/sms-voice/.
-
En el panel de navegación, en Configuraciones, elija Números de teléfono y, a continuación, Solicitar originador.
-
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.
-
En la sección Caso de uso de mensajería, introduzca lo siguiente:
-
En Capacidades numéricas, selecciona cualquier combinación de capacidades disponibles:
Las capacidades de SMS, MMS y voz no se pueden cambiar después de comprar el número de teléfono.
-
Mensajes de texto (SMS) Seleccione esta opción si necesita funciones de SMS.
-
Mensajes de texto y multimedia (SMS, MMS): elija esta opción si necesita capacidades de SMS o MMS.
-
Mensajes de texto a audio (voz): elija esta opción si necesita funciones de voz.
-
En Volumen estimado de mensajes mensuales (opcional), elige la cantidad estimada de mensajes SMS que enviarás cada mes.
-
Para la sede de la empresa (opcional), elige 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.
-
Para la mensajería bidireccional, selecciona Sí si necesitas la mensajería bidireccional.
-
Elija Siguiente.
-
En Seleccione el tipo de remitente, 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.
Elija Siguiente.
-
En Revisar y solicitar, puede verificar y editar la solicitud antes de enviarla. Seleccione Request (Solicitar).
-
En función del tipo de número de teléfono que hayas solicitado, puede aparecer una ventana en la que es necesario registrarse. 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.
-
Para Nombre del formulario de registro, introduzca un nombre descriptivo.
-
Seleccione Comenzar registro para finalizar el registro del número de teléfono o Registrarse después.
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.
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.
Las capacidades de MMS solo están disponibles en algunos países. Para obtener más información sobre los países en los que se admiten SMS y MMS, consulte Países y regiones compatibles con la mensajería SMS y. Países y regiones compatibles con la mensajería MMS
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. Puede solicitar un número de teléfono con funciones de SMS, MMS y mensajes de voz especificándolo. SMS MMS
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.
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
}
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 compatibles con la mensajería 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 SMS, MMS, mensajes de voz o todos).
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, MMS y VOICE.
-
number-type— El tipo de número de teléfono, comoLONG_CODE,SHORT_CODE, oTOLL_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.
Estado y capacidades del número de teléfono
En esta sección se explica cómo comprobar el estado y las capacidades de tu número de teléfono.
Estado del número de teléfono
Abra la consola de Amazon Pinpoint SMS en https://console.aws.amazon.com/sms-voice/.
-
En el panel de navegación, en Configuraciones, elija Números de teléfono.
-
La siguiente imagen muestra las partes del estado del número de teléfono.
-
Número de origen: el número numérico que los clientes ven en sus teléfonos.
-
Tipo de origen: el tipo de número de origen. Puede ser un código largo, un código corto o un número gratuito.
-
País: el país o la región desde donde se suministra el número de origen.
-
Estado del número: el estado del número de origen. Puede serPending, Active o. Action required
-
Capacidades: las capacidades del número de origen. Puede ser una combinación deSMS,MMS, oVoice.
-
Grupo: el grupo, si lo hay, al que está asociado el número de origen.
-
Fecha de creación: la hora en que se solicitó el número de origen.
Cuando compra 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, su estado 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.
