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

# Inicio rápido

> Administre los números de teléfono del espacio de trabajo a través de API, realice consultas, busque disponibles y configure la voz entrante.

## En resumen

* **Comprar** un número está en el **panel**; la API enumera, consulta disponible y configura **voz entrante**.
* Alcances: `phone_numbers:read` (consultar) y `phone_numbers:update` (configurar). Detalles en **[Alcances de clave API](/es/phone-numbers-api/como-funciona/escopos-da-api-key)**.
* Utilice `id` o `phoneE164` como origen en las llamadas, consulte **[Inicio rápido de Voice API](/es/voice-api/como-funciona/quick-start)**.

Para quienes **integran** la gestión de números (CRM, telefonía). La compra y el pago permanecen en el tablero.

***

## Antes de empezar

* **Número activo** comprado en **Configuración → Números de teléfono**.
* **Clave API** con alcances requeridos. Consulte [Alcances](/es/phone-numbers-api/como-funciona/escopos-da-api-key).
* Autenticación: `Authorization: Bearer sk_live_...` o `x-api-key`.
* **URL base** (por ejemplo, `https://api.notifique.dev`).

***

## El camino en tres pasos

1. **Compra** en el tablero (búsqueda, reserva, pago).
2. **Enumere** los números y copie **`id`** o **`phoneE164`**.
3. **Configurar** lo que sucede cuando alguien **llama** (reenvío, TTS, webhook…).

***

## 1. Compra un número (panel de control)

**Configuración → Números de teléfono:**

1. Busque por país, código de área o patrón.
2. Selecciona y paga (tarifa mensual recurrente).
3. Activación → webhook **`phone_number.activated`** (si está configurado).

La API busca números **disponibles**; **la compra** se realiza a través del panel de control.

***

## 2. Buscar números disponibles

Enumera las opciones antes de enviar al usuario al proceso de pago del panel.

**Pedido**

Optional parameters:

| Parameter         | Description                    |
| ----------------- | ------------------------------ |
| `countryCode`     | ISO (default `US`)             |
| `phoneNumberType` | e.g. `local`, `mobile`         |
| `areaCode`        | Area code                      |
| `contains`        | Digits the number must contain |

**Response (200), example**

***

## 3. Enumere los números del espacio de trabajo

**Pedido**

Returns **non-released** numbers (`RELEASED` does not appear).

**Response (200), example**

***

## 4. Consigue un número

**Pedido**

***

## 5. Configure inbound voice

Defines what happens when someone **calls**, like choosing whether the call goes to reception, voicemail, or your system.

**Request**

### `inboundVoiceAction` values

| Value             | Behavior                                           |
| ----------------- | -------------------------------------------------- |
| `WEBHOOK_CONTROL` | Your app controls via Voice API webhooks (default) |
| `FORWARD`         | Forwards to `forwardToE164`                        |
| `TTS_HANGUP`      | Speaks `inboundTtsText` and hangs up               |
| `REJECT`          | Rejects                                            |
| `VOICEMAIL`       | Records message                                    |

TTS: `inboundTtsText` + optional `inboundTtsVoice` (`female-natural`, `male-natural`, etc.).

***

## 6. Lifecycle webhooks

Events: **`phone_number.activated`**, **`phone_number.past_due`**, **`phone_number.suspended`**, **`phone_number.released`**.

Details: [**Webhook events**](/es/voice-api/como-funciona/eventos-do-webhooks).

***

## Quick summary

| Goal              | Path                                          |
| ----------------- | --------------------------------------------- |
| Search available  | `GET /v1/phone-numbers/available`             |
| List purchased    | `GET /v1/phone-numbers`                       |
| Detail            | `GET /v1/phone-numbers/:id`                   |
| Configure inbound | `PATCH /v1/phone-numbers/:id`                 |
| Call origin       | `id` or `phoneE164` in `POST /v1/voice/calls` |

***

## Próximos pasos

* **[API Key scopes](/es/phone-numbers-api/como-funciona/escopos-da-api-key)**
* **[Voice API, Quick Start](/es/voice-api/como-funciona/quick-start)**
* **[Webhook events](/es/voice-api/como-funciona/eventos-do-webhooks)**
* **[API Keys](/es/guides/api-key/index)**