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.
1. **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:
+ Una marca registrada de 10DLC aprobada. Para obtener más información, consulte [Formulario de registro de marca 10DLC](registrations-10dlc-company.md).
+ Una campaña aprobada y registrada con 10 DLC asociada a la marca. Para obtener más información, consulte [Formulario de registro de campaña de 10DLC](registrations-10dlc-register-campaign.md).
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 llamar`RequestPhoneNumber`, 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/ ](https://console.aws.amazon.com/sms-voice/)
1. En el panel de navegación, en **Configuraciones**, elija **Números de teléfono** y, a continuación, **Solicitar originador**.
1. 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**.
1. Completa la ** sección de casos prácticos de ** mensajería y selecciona ** Siguiente**.
1. En Tipo de ** creador**, elige el tipo de número de 10 DLC y asocia tu marca y campaña registradas.
1. (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**. **
1. 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.
1. Elija **Buscar**. En una tabla se muestran hasta 10 números de teléfono disponibles.
1. 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.
1. Configure el ** uso compartido de políticas de ** recursos si es necesario y, a continuación, seleccione ** Siguiente**.
1. 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 ](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/list-available-phone-numbers.html) 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-1234567890`Sustitúyelo por el identificador de tu campaña de 10 DLC aprobada.
+ `+1510`Sustitú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 ](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/request-phone-number.html) 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-1234567890`Sustitúyelo por el identificador de tu campaña de 10 DLC aprobada.
+ `TRANSACTIONAL`Sustitúyelo por `PROMOTIONAL` si vas a enviar mensajes promocionales.
+ `SMS`Sustitúyalo por las funciones que necesite. Puede especificar `SMS``MMS`, y`VOICE`.
+ 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 `PhoneNumberId``PhoneNumber`, y. Si el número exacto ya no está disponible, la solicitud devuelve un error. Vuelva a buscar para encontrar otro número disponible.
------