> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Compra de números de teléfono

> Busca, compra y gestiona números desde el mercado de la plataforma

La plataforma incluye un **mercado de números**: busca números disponibles por país y tipo, cómpralos con un clic y se enrutan automáticamente a la telefonía de tu cuenta, sin necesidad de una cuenta de operador.

## Cómo funciona la compra

<Steps>
  <Step title="Buscar">
    Ve a **Números de teléfono → Comprar número**, elige un país y un tipo de número (local, móvil, gratuito; la disponibilidad varía según el país).
  </Step>

  <Step title="Completa los requisitos normativos (si los hay)">
    Muchos países exigen por ley una verificación de identidad o dirección antes de poder activar un número — más abajo te explicamos cómo.
  </Step>

  <Step title="Comprar">
    El precio mensual y cualquier tarifa de configuración se muestran por adelantado. Completa el pago seguro. El número queda pendiente y no puede recibir ni realizar llamadas hasta que se confirme el pago.
  </Step>

  <Step title="Activación tras confirmar el pago">
    Un evento de pago verificado aprovisiona el enrutamiento y activa el número. Las compras fallidas, caducadas o impagas liberan automáticamente el número reservado y no conceden acceso a llamadas.
  </Step>

  <Step title="Asigna un asistente">
    Asigna el número a un asistente: a partir de ese momento, las llamadas entrantes se responden automáticamente. El mismo número puede usarse como identificador de llamada saliente.
  </Step>
</Steps>

## Disponibilidad y precios por país

El operador de la plataforma configura en qué países puedes comprar y el **precio mensual por número**. Los precios varían según el país y el tipo de número, y se facturan mensualmente a tu cuenta.

## Paquetes regulatorios

En muchas jurisdicciones, los números requieren un **paquete regulatorio** —identidad verificada y, a menudo, una dirección local— antes de poder comprar el número. Los requisitos del paquete son **específicos de cada país y tipo de número** (por ejemplo, los números locales de Alemania suelen necesitar un paquete, mientras que los móviles pueden no necesitarlo). La plataforma lo detecta automáticamente por país y tipo de número.

**La verificación regulatoria se gestiona a través del proveedor de telefonía de la plataforma.** Tras la aprobación, los números quedan disponibles para comprar y se vinculan para el enrutamiento de llamadas / troncal SIP.

### Cómo verificar

1. Abre **Configuración → Verificación** (o **Comprar un número → Número personalizado / Enviar verificación**).
2. La lista de países incluye **todos los países que requieren un paquete regulatorio**, también aquellos donde la compra en el marketplace no está habilitada actualmente (`GET /api/telephony/verification/catalog` o la ruta pública `GET /api/v1/phone-numbers/verifications/catalog`).
3. Elige el país, el tipo de número y el tipo de usuario final (empresa o particular). Los campos del formulario y los documentos aceptados se cargan desde el catálogo de regulación en vivo para esa combinación.
4. Envía el caso. Las actualizaciones de estado aparecen en la página de Verificación (`pending review` → `approved` / `rejected`). Si se rechaza, envía un caso **nuevo** con los datos corregidos.
5. Tras la aprobación, la búsqueda y compra en el mercado para ese país y tipo queda desbloqueada para el espacio de trabajo.

También puedes:

* Listar el catálogo o los casos a través de la API pública (`/api/v1/phone-numbers/verifications`, `/api/v1/phone-numbers/verifications/catalog`)
* Usar las herramientas MCP `list_verification_catalog`, `list_number_verifications`, `submit_number_verification`, `get_number_verification`

Los administradores de la plataforma pueden actualizar los indicadores de paquete por tipo en **Admin → Telefonía**.

<Note>
  Planifica con antelación para los países regulados: la revisión suele tardar varios días hábiles (varía según el país y la calidad de los documentos).
</Note>

## Números de cortesía (incluidos en el plan)

Algunos planes de la plataforma incluyen una cantidad limitada de números gratuitos del mercado para países seleccionados. Esos números se activan sin pasar por el pago de Stripe. Si el plan del espacio de trabajo se **cancela** o el pago falla (`past_due` / cuenta suspendida), los números de cortesía se **liberan** automáticamente. Los números de pago del mercado con su propia suscripción no se ven afectados.

La liberación manual de un número de cortesía es **inmediata** (vuelve al proveedor; no se puede restaurar).

## Liberar un número de pago del marketplace

Los números de pago tienen su propia suscripción de Stripe. Al liberarlos:

1. Stripe se configura con **cancel at period end** (sin más renovaciones).
2. El número **sigue siendo plenamente usable** (entrada/salida) hasta el fin del período.
3. Al final del período, Twilio libera el número y el estado pasa a `released`.

Los números de cortesía / impagos / compras fallidas siguen liberándose de inmediato.

## Límites de números

La cantidad de números de teléfono en tu cuenta es un límite del plan (`max_own_numbers`).

## Costos del operador en las llamadas

Además de la tarifa mensual del número, cada minuto de llamada tiene un **costo de operador que depende del país de destino**, y se descuenta de tu saldo de minutos por encima de los minutos del plan. Consulta [Cómo se facturan los minutos](/billing/minutes).

## Trae tus propios números

Si ya tienes números en un proveedor SIP, conéctalos mediante una [troncal SIP propia (BYO)](/telephony/sip-trunks): no hace falta portabilidad.