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.
Amazon Pinpoint incluye un servicio de validación de números de teléfono que puede utilizar para determinar si un número de teléfono es válido y para obtener información adicional sobre el propio número de teléfono. Por ejemplo, cuando se usa el servicio de validación de números de teléfono, este devuelve la siguiente información:
-
El número de teléfono en formato E.164.
-
El tipo de número de teléfono (por ejemplo, móvil, fijo o VoIP).
-
La ciudad y el país del número de teléfono.
-
El proveedor de servicios asociado al número de teléfono.
Se aplica un cargo adicional por el uso del servicio de validación de números de teléfono. Para obtener más información, consulte Precios de Amazon Pinpoint
importante
Para los números de teléfono originarios de Estados Unidos y Canadá, la API de validación de números de teléfono ya no devolverá los datos de City, County, Timezone y ZipCode.
Casos de uso de validación de números de teléfono de Amazon Pinpoint
Puede utilizar el servicio de validación de números de teléfono para varios casos de uso, entre los que se incluyen los siguientes:
-
Verificación de los números de teléfono proporcionados en un formulario web: si utiliza formularios basados en la web para recopilar la información de contacto de los clientes, valida los números de teléfono que proporcionan los clientes antes de enviar el formulario. Utilice el backend de su sitio web para validar el número mediante la API de Amazon Pinpoint. La respuesta de la API indica si el número no es válido, por ejemplo, si el número de teléfono está formateado incorrectamente. Si determina que el número de teléfono que el cliente ha proporcionado no es válido, el formulario web puede pedir al cliente que proporcione otro número.
-
Limpieza de la base de datos de contactos existentes: si tiene una base de datos de números de teléfono de clientes, puede validar cada número de teléfono y, a continuación, actualizar la base de datos en función de los resultados. Por ejemplo, si encuentra puntos de enlace con números de teléfono que no pueden recibir mensajes SMS, puede cambiar la propiedad
ChannelTypedel punto de enlaceSMSaVOICE. Puede validar primero el número de teléfono y, a continuación, actualizar la propiedadChannelTypepara los puntos de conexión nuevos o existentes siguiendo las instrucciones de Agregar puntos de conexión a Amazon Pinpoint para un único punto de conexión o Agregar un lote de puntos de conexión a Amazon Pinpoint para varios puntos de conexión. -
Elección del canal correcto antes de enviar un mensaje: si va a enviar un mensaje SMS pero determina que el número de destino no es válido, puede enviar un mensaje al destinatario a través de un canal diferente. Por ejemplo, si el punto de enlace no puede recibir mensajes SMS, puede enviar un mensaje de voz en su lugar.
Valide un número de teléfono mediante el AWS CLI
En el ejemplo siguiente, se muestra cómo validar un número de teléfono mediante la AWS CLI. Para obtener más información, consulte phone-number-validate en la Referencia de los comandos de AWS CLI . Para ver ejemplos de respuestas de validación, consulte Respuesta de validación de números de teléfono. Para obtener más información sobre la configuración del AWS CLI, consulte Configurar el AWS CLI en la Guía del AWS Command Line Interface usuario.
Para utilizar el servicio de validación de números de teléfono mediante el AWS CLI
-
En la línea de comandos, escriba el comando siguiente.
aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881,IsoCountryCode=GBEn el comando anterior,
+442079460881sustitúyalo por el número de teléfono que deseas validar yGBpor el código ISO de país o región de dos dígitos.nota
Cuando proporciona un número de teléfono en el servicio de validación de números de teléfono, debe incluir siempre el código de país. Si no incluye el código de país, el servicio podría devolver información de un número de teléfono de un país diferente. Puede incluir guiones en el número de teléfono, por ejemplo
+44-207-946-0881.
Respuesta de validación de números de teléfono
La información que el servicio de validación de números de teléfono proporciona varía ligeramente en función de los datos que estén disponibles para el número de teléfono proporcionado. En esta sección se incluyen ejemplos de las respuestas que devuelve el servicio de validación de números de teléfono.
nota
Los datos que proporciona el servicio de validación de números de teléfono depende de la información proporcionada por los proveedores del servicio de telecomunicaciones y otras entidades de todo el mundo. Los proveedores de algunos países podrían actualizar esta información con menos frecuencia que los de otros países. Por ejemplo, si emite una solicitud para validar un número de teléfono móvil y el número que proporciona se ha transferido de un operador móvil a otro, la respuesta del servicio de validación de números de teléfono podría incluir el nombre del operador original, en lugar del actual.
Números de teléfono móvil válidos
Cuando envía una solicitud al servicio de validación de números de teléfono y el número de teléfono es un número de teléfono móvil válido, el servicio devuelve información con un aspecto similar al del siguiente ejemplo:
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp Mobile",
"City": "Seattle",
"CleansedPhoneNumberE164": "+12065550142",
"CleansedPhoneNumberNational": "2065550142",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+12065550142",
"PhoneType": "MOBILE",
"PhoneTypeCode": 0,
"Timezone": "America/Los_Angeles",
"ZipCode": "98101"
}
}Números de teléfono fijo válidos
Si su solicitud contiene un número de teléfono fijo válido, el servicio de validación de números de teléfono devuelve información similar a la del siguiente ejemplo:
{
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"Country": "United States",
"City": "Santa Clara",
"ZipCode": "95037",
"Timezone": "America/Los_Angeles",
"CleansedPhoneNumberNational": "4085550101",
"CleansedPhoneNumberE164": "14085550101",
"Carrier": "AnyCompany",
"PhoneTypeCode": 1,
"PhoneType": "LANDLINE",
"OriginalPhoneNumber": "+14085550101"
}Números de teléfono VoIP válidos
Si su solicitud contiene un número de teléfono VoIP (protocolo de voz a través de Internet) válido, el servicio de validación de números de teléfono devuelve información con un aspecto similar al del siguiente ejemplo:
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+441514960001",
"CleansedPhoneNumberNational": "1514960001",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+441514960001",
"PhoneType": "VOIP",
"PhoneTypeCode": 2
}
}Números de teléfono no válidos
Si su solicitud contiene un número de teléfono no válido, el servicio de validación de números de teléfono devuelve información similar a la del siguiente ejemplo:
{
"NumberValidateResponse": {
"CleansedPhoneNumberE164": "+44163296076",
"CleansedPhoneNumberNational": "163296076",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+440163296076",
"PhoneType": "INVALID",
"PhoneTypeCode": 3
}
}Tenga en cuenta que la propiedad PhoneType de esta respuesta indica que este número de teléfono es INVALID y que no incluye información sobre el operador o la ubicación asociada con el número de teléfono. Debe evitar el envío de mensajes SMS o de voz a números de teléfono en los que PhoneType sea INVALID, ya que es muy poco probable que estos números pertenezcan a destinatarios reales.
Otros números de teléfono
A veces, la respuesta del servicio de validación de números de teléfono incluye el valor PhoneType OTHER. El servicio puede devolver este tipo de respuesta en las siguientes situaciones:
-
El número de teléfono es un número de teléfono gratuito.
-
El número de teléfono está reservado para su uso en series de televisión y películas, como los números de teléfono de los Estados Unidos que comienzan por 555.
-
El número de teléfono incluye un código de área que actualmente no se encuentra en uso, como el código de área 999 en Norteamérica.
-
El número de teléfono está reservado para cualquier otro fin.
En el siguiente ejemplo se muestra la respuesta que el servicio de validación de números de teléfono proporciona cuando su solicitud incluye un número de teléfono de Norteamérica ficticio:
{
"NumberValidateResponse": {
"Carrier": "Multiple OCN Listing",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "OTHER",
"PhoneTypeCode": 4,
"Timezone": "America/Los_Angeles"
}
}Números de teléfono de prepago
Si la solicitud contiene un número de teléfono prepagado válido, el servicio de validación de números de teléfono devuelve información similar a la del siguiente ejemplo:
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "PREPAID",
"PhoneTypeCode": 5
}
}Para obtener más información acerca de la información incluida en estas respuestas, consulte Validación de números de teléfono en la Referencia de la API de Amazon Pinpoint.
