View a markdown version of this page

Usa el servicio de búsqueda de transportistas - AWS SMS de mensajería para el usuario final
Casos de uso de búsqueda de transportistasFormatos de números de teléfono compatiblesMediante el servicio de búsqueda de operadores en el AWS CLI

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.

Usa el servicio de búsqueda de transportistas

AWS La mensajería SMS para el usuario final incluye un servicio de búsqueda de operadores que puede utilizar para obtener información sobre un número de teléfono, incluso si el número de teléfono es válido. El servicio de búsqueda de operadores devuelve la siguiente información de un número de teléfono:

  • El número de teléfono en formato E164 (depurado de la entrada original).

  • El tipo de número de teléfono (por ejemplo, no válido, fijo, móvil u otro).

  • El nombre del país o la región del número de teléfono.

  • El código de marcación numérico del país o la región del número de teléfono.

  • El código de país o región de dos caracteres, en formato ISO 3166-1 alfa-2, del número de teléfono.

  • En el caso de los números de teléfono móvil, el código de país del móvil (MCC).

  • En el caso de los números de teléfono móvil, el código de red móvil (MNC).

  • El operador o el proveedor de servicios con el que está registrado actualmente el número de teléfono. En algunos países y regiones, este valor puede ser el operador o el proveedor de servicios con el que se registró originalmente el número de teléfono.

El uso del servicio de búsqueda de operadores conlleva un cargo adicional. Para obtener más información, consulta los precios de los SMS de mensajería para usuarios AWS finales.

Casos de uso de búsqueda de transportistas

Puedes usar el servicio de búsqueda de transportistas para habilitar varios casos de uso, incluidos los siguientes:

  • Busque 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 sus clientes, puede buscar los números de teléfono que proporcionan los clientes antes de enviar el formulario. Usa el backend de tu sitio web para buscar y validar el número mediante la API de SMS de mensajería para el usuario AWS final. La respuesta de la API indica si el número es válido, por ejemplo, si el número de teléfono tiene el formato correcto. Si determinas que el número de teléfono proporcionado por el cliente no es válido, tu formulario web puede pedirle al cliente que proporcione un número válido.

  • Limpiar tu base de datos de contactos existente: si tienes una base de datos de números de teléfono de clientes, puedes buscar cada número de teléfono y actualizar la base de datos utilizando los resultados de la búsqueda del operador. Por ejemplo, si encuentra puntos de enlace con números de teléfono que no pueden recibir mensajes SMS, puede cambiar la propiedad ChannelType del punto de enlace SMS a VOICE.

  • 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.

Formatos de números de teléfono compatibles

Los números de teléfono deben estar en formato E164 y empezar por un signo más (+) seguido del código de marcado del país y del número de teléfono (por ejemplo, +12065551234). El servicio de búsqueda de operadores acepta varios formatos de caracteres y los elimina automáticamente durante el procesamiento. Puedes incluir los siguientes caracteres de formato en la entrada de tu número de teléfono:

  • Paréntesis: +1 (555) 123-4567

  • Soportes: +1 [555] 123-4567

  • Espacios: +1 555 123 4567

  • Guiones: +1-555-123-4567

  • Períodos: +1.555.123.4567

  • Comas: +1,555,123,4567

  • Formato mixto: +1 (555)-123.4567

Todos los caracteres de formato se eliminan automáticamente durante el procesamiento y el servicio devuelve el número de teléfono en formato E164 estándar (por ejemplo+15551234567) en el E164PhoneNumber campo de la respuesta.

Mediante el servicio de búsqueda de operadores en el AWS CLI

El siguiente ejemplo muestra cómo utilizar el servicio de búsqueda de transportistas en AWS CLI. El servicio acepta números de teléfono con varios caracteres de formato (paréntesis, corchetes, espacios, guiones, puntos, comas) y los convierte automáticamente al formato E164 para su procesamiento. Para obtener más información, consulte la referencia de la API de SMS de mensajería para el usuario AWS final o la búsqueda de operadores CarrierLookupen la Referencia de comandos. AWS CLI

Para usar el servicio de búsqueda de transportistas (CLI)

  • En la línea de comandos, escriba el comando siguiente: Puede usar varios formatos de números de teléfono: el servicio acepta caracteres especiales como paréntesis, corchetes, espacios, guiones, puntos y comas:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number "+1 (555) 555-5333"

    O con el formato E164:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number +15555555333

Respuestas de búsqueda de transportistas

La información que proporciona el servicio de búsqueda de operadores varía ligeramente en función de los datos disponibles para el número de teléfono que proporciones. Esta sección contiene ejemplos de las respuestas que devuelve el servicio de búsqueda de operadores.

nota

Los datos que proporciona el servicio de búsqueda de operadores se basan en la información proporcionada por los proveedores 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 emites una solicitud para validar un número de teléfono móvil y el número que proporcionaste se transfirió de un operador de telefonía móvil a otro, la respuesta del servicio de búsqueda de operadores podría incluir el nombre del operador original, en lugar del actual.

Números de teléfono móvil válidos

La siguiente respuesta es un ejemplo de las CarrierLookup devoluciones de información de un número de teléfono móvil válido:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "US",
    "Country": "United States",
    "MCC": "310",
    "MNC": "260",
    "Carrier": "ExampleCorp Mobile",
    "PhoneNumberType": "MOBILE"
}
Números de teléfono fijo válidos

La siguiente respuesta es un ejemplo de las CarrierLookup devoluciones de información de un número de teléfono fijo válido:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "CA",
    "Country": "Canada",
    "Carrier": "ExampleCorp Landline",
    "PhoneNumberType": "LANDLINE"
}
Números de teléfono no válidos

Si la solicitud contiene un número de teléfono no válido, el servicio de búsqueda de operadores devuelve información similar a la del siguiente ejemplo:

{
    "E164PhoneNumber": "+15555555333444666",
    "PhoneNumberType": "INVALID"
}}

Tenga en cuenta que la propiedad PhoneNumberType 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 PhoneNumberType sea INVALID, ya que es muy poco probable que estos números pertenezcan a destinatarios reales.

Otros números de teléfono

Los números de teléfono que no están clasificados como móviles, fijos o no válidos se devuelven con un PhoneNumberType valor deOTHER.