View a markdown version of this page

Elegir un número de teléfono de 10 DLC por código de área - AWS Mensajería SMS para el usuario final
Requisitos previosTipos de patrones de búsquedaConsideraciones importantesBusca y solicita un número de teléfono del 10DLC

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.

Elegir un número de teléfono de 10 DLC por código de área

Cuando solicitas un número de teléfono con código largo de 10 dígitos (10DLC), puedes buscar y elegir un número específico en lugar de recibir una asignación aleatoria. Puedes buscar por código de área o por un patrón dentro del número de teléfono. También puedes solicitar un número de teléfono exacto. Esta función solo está disponible para los números de teléfono 10DLC de los Estados Unidos.

La selección del número de teléfono se realiza en dos pasos:

  1. Búsqueda: usa la ListAvailablePhoneNumbers API o la consola para buscar los números de 10 DLC disponibles, filtrados por código de área o patrón.

  2. Solicitud: usa la RequestPhoneNumber API con el NumberPreference parámetro opcional o selecciona un número en la consola para solicitar un número de teléfono específico.

Requisitos previos

Para poder buscar y elegir un número de teléfono del 10DLC, debes tener lo siguiente:

La búsqueda de números de teléfono muestra los números que están disponibles en el agregador asociado al registro de tu campaña de 10 DLC. No es necesario que especifiques un agregador.

Tipos de patrones de búsqueda

Puede buscar los números de teléfono disponibles mediante los siguientes tipos de patrones:

Tipo de patrón Description (Descripción) Ejemplo
StartsWith Devuelve los números que comienzan por los dígitos especificados. Utilícela para buscar por código de área. El filtro +1510 devuelve números del código de área 510, como+15103921111.
EndsWith Devuelve los números que terminan con los dígitos especificados. El filtro 1234 devuelve números que terminan en 1234, como+12025551234.
Contains Devuelve los números que contienen los dígitos especificados en cualquier parte del número. El filtro 555 devuelve números que contienen 555, como+15105559876.
ExactMatch Solicita un número de teléfono específico. Este tipo solo es válido con la RequestPhoneNumber API, no conListAvailablePhoneNumbers. El filtro +15103921234 solicita ese número exacto.

Consideraciones importantes

  • La disponibilidad del número de teléfono no está garantizada. Otro cliente puede comprar un número que aparece en los resultados de búsqueda antes de que lo solicites. Si esto ocurre, solicita un número diferente o vuelve a buscar.

  • Los resultados de la búsqueda no son una reserva. Los números no se guardan entre el paso de búsqueda y el paso de solicitud.

  • Los resultados de la búsqueda muestran un máximo de 10 números por página. Para recuperar páginas adicionales de resultados, utilice el NextToken parámetro.

  • Si no especificas una NumberPreference al llamarRequestPhoneNumber, el comportamiento actual no cambiará y la mensajería para el usuario AWS final (SMS) asigna un número de teléfono automáticamente.

  • Esta función solo está disponible para los números de teléfono 10DLC (TEN_DLC) de los Estados Unidos.

Busca y solicita un número de teléfono del 10DLC

Puedes buscar y solicitar un número de teléfono específico del 10DLC mediante la consola de mensajería por SMS para el usuario AWS final o la. AWS CLI

Console

Puedes buscar y elegir un número de teléfono específico del 10DLC durante el proceso de solicitud del número de teléfono en la consola de mensajería por SMS para el usuario AWS final.

Elige un número de teléfono del 10DLC por código de área (consola)

  1. Abra la consola de mensajería por SMS para el usuario AWS final 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 Seleccione el país, elija Estados Unidos (EE. UU.) en el menú desplegable del país de destino del mensaje. Elija Siguiente.

  4. Completa la sección de casos prácticos de mensajería y selecciona Siguiente.

  5. En Tipo de creador, elige el tipo de número de 10 DLC y asocia tu marca y campaña registradas.

  6. (Opcional) En el paso de preferencia numérica, busca un número de teléfono específico:

    1. Selecciona un tipo de patrón de búsqueda: Empieza por, Termina por o Contiene.

    2. Introduzca un patrón. Por ejemplo, 510 introdúzcalo para buscar números en el código de área 510. La consola formatea automáticamente los datos introducidos con el prefijo del código de país.

    3. Elija Buscar. En una tabla se muestran hasta 10 números de teléfono disponibles.

    4. Selecciona el número de teléfono que quieras y, a continuación, selecciona Siguiente.

    Si omites este paso, la mensajería para el usuario AWS final (SMS) asigna un número de teléfono automáticamente.

  7. Configure el uso compartido de políticas de recursos si es necesario y, a continuación, seleccione Siguiente.

  8. En Revisar y solicitar, verifica la configuración y selecciona Solicitar.

AWS CLI

AWS CLI Utilízala para buscar los números de teléfono de 10 DLC disponibles y, a continuación, solicita un número específico.

Paso 1: Busca los números disponibles

Usa el comando list-available-phone-numbers para buscar los números de teléfono de 10 DLC disponibles. En el siguiente ejemplo, se buscan números en el código de área 510:

$ aws pinpoint-sms-voice-v2 list-available-phone-numbers \
    --iso-country-code US \
    --number-type TEN_DLC \
    --registration-id registration-1234567890 \
    --number-preference '[{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}]'

Si hay números disponibles que coinciden con los criterios de búsqueda, la respuesta incluye una lista de números de teléfono en E.164 formato:

{
    "AvailablePhoneNumbers": [
        "+15103921111",
        "+15103922222",
        "+15103923333",
        "+15103924444",
        "+15103925555"
    ],
    "NextToken": "AAMAJDUwNzE4ZTQwLWJkOTUtNDk4Ny..."
}

En el comando anterior, realice los siguientes cambios:

  • registration-1234567890Sustitúyelo por el identificador de tu campaña de 10 DLC aprobada.

  • +1510Sustitúyelo por el código de área o el patrón que quieras buscar.

  • Sustituir StartsWith por el tipo de patrón de búsqueda EndsWith o Contains para cambiarlo.

Si la respuesta incluye un NextToken valor, pásalo en una solicitud posterior para recuperar la siguiente página de resultados. Cuando NextToken es nulo, no hay más resultados.

Paso 2: Solicita un número específico

Cuando encuentres un número de teléfono en los resultados de la búsqueda, usa el comando request-phone-number con el --number-preference parámetro para solicitar ese número.

En el ejemplo siguiente, se solicita un número de teléfono exacto:

$ aws pinpoint-sms-voice-v2 request-phone-number \
    --iso-country-code US \
    --message-type TRANSACTIONAL \
    --number-type TEN_DLC \
    --number-capabilities SMS \
    --registration-id registration-1234567890 \
    --number-preference '{"PreferenceType": ["ExactMatch"], "Filter": ["+15103921111"]}'

También puedes solicitar un número de teléfono mediante un patrón. En el siguiente ejemplo, se solicita cualquier número disponible en el código de área 510:

$ aws pinpoint-sms-voice-v2 request-phone-number \
    --iso-country-code US \
    --message-type TRANSACTIONAL \
    --number-type TEN_DLC \
    --number-capabilities SMS \
    --registration-id registration-1234567890 \
    --number-preference '{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}'

En los comandos anteriores, realice los cambios siguientes:

  • registration-1234567890Sustitúyelo por el identificador de tu campaña de 10 DLC aprobada.

  • TRANSACTIONALSustitúyelo por PROMOTIONAL si vas a enviar mensajes promocionales.

  • SMSSustitúyalo por las funciones que necesite. Puede especificar SMSMMS, yVOICE.

  • Sustituya el número de teléfono o el Filter patrón por el valor que prefiera.

Si el número solicitado está disponible, la respuesta será la misma que la RequestPhoneNumber respuesta estándar, incluidos los Status campos PhoneNumberIdPhoneNumber, y. Si el número exacto ya no está disponible, la solicitud devuelve un error. Vuelva a buscar para encontrar otro número disponible.