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

# Introducción

> Llamadas de voz vía API: confirmación telefónica, IVR, marcador y webhooks en tiempo real.

<Tip>
  La voz es **telefonía en su sistema**: llame desde un número de espacio de trabajo, diga texto (TTS), reproduzca audio, recopile dígitos (DTMF) y cuelgue o transfiera, sin crear una infraestructura de operador y troncal SIP desde cero.
</Tip>

## ¿Qué es Voice on Notifique?

Es el canal para **generar y controlar llamadas telefónicas** utilizando números contratados en el espacio de trabajo. Excelente para **confirmación de pedido**, **IVR simple** (presione 1, 2...), **marcadores** y **manejo entrante** con eventos en su URL.

Puede:

* **Origen** llamadas salientes con TTS, audio o recopilación DTMF
* **Controlar** la sesión activa en tiempo real (`speak`, `gather`, `transfer`, `hangup`, etc.)
* **Grabar** segmentos de llamadas y descargar el archivo más tarde
* **Recibir** llamadas entrantes con reenvío, TTS o control de webhook
* **Seguimiento** de cada paso mediante API o [webhooks](/es/voice-api/como-funciona/eventos-do-webhooks)

Piense en un sistema telefónico eficiente: marca, habla, escucha las teclas y notifica a su backend en cada paso.

<Note>
  A diferencia de WhatsApp, la voz **no utiliza una instancia de canal**. Necesita un número de espacio de trabajo **ACTIVO**, saldo o créditos (facturación **por minuto**) y una clave API con los alcances correctos.
</Note>

## ¿Cuándo usarlo?

Funciona muy bien para **confirmación de llamadas**, **menús DTMF IVR** y **grabación de llamadas para auditoría**. Si solo necesita mensajes de texto en el móvil, prefiera [SMS](/es/sms-api/como-funciona/introducao) o [WhatsApp](/es/whatsapp-api/como-funciona/introducao). Sin un número **ACTIVO** contratado, el canal no puede marcar.

## Cómo funciona en la práctica

1. **Contratar y activar un número**, ver [Números de teléfono](/es/phone-numbers-api/como-funciona/quick-start)
2. **Origen** con `from` (su número), `to` (destino E.164 con `+`) y el mensaje inicial (`speak`, `playAudioUrl`, `gather`, etc.)
3. La plataforma **marca, conecta y actualiza el estado**; webhooks notifican cada paso
4. **Controlar** la sesión activa con acciones API, alcance `voice:control`
5. **Entrante:** configurar `inboundVoiceAction` en el número (`FORWARD`, `TTS_HANGUP`, `WEBHOOK_CONTROL`)

<Info>
  Cada **Clave API** pertenece a **un** espacio de trabajo. En v1 **no enviar** `x-workspace-id`. Utilice `clientState` para correlacionarlo con su CRM o cola.
</Info>

## Ciclo de vida de la llamada

Después de originarse, la llamada pasa por `QUEUED`, `INITIATED`, `RINGING`, `ANSWERED`, `COMPLETED` o `FAILED`. Los webhooks como `voice.call.answered` y `voice.call.completed` mantienen el backend sincronizado sin realizar sondeos.

## Qué puedes hacer

* **Origen** de 1 a 100 destinos por llamada (`to` como matriz)
* Historial de **listas y consultas** (`voice:read`)
* **Ejecutar acciones** en llamadas activas (`voice:control`)
* **Descargar grabaciones** cuando llegue `voice.call.recording.ready`
* **Detectar correo de voz** con `machineDetection`
* **Reaccionar al ciclo de vida del número** (`phone_number.activated`, `phone_number.suspended`, etc.)

Detalles de campo y error: **Referencia de API** en la pestaña Voz. Facturación: [Facturación](/es/guides/introducao/cobranca-e-pague-pelo-uso).

## Después de tu primera llamada

* **Seguimiento** vía [webhooks](/es/voice-api/como-funciona/eventos-do-webhooks) (`voice.call.*` y `phone_number.*`)
* **Construir IVR** con `gather` + `voice.call.dtmf` / `voice.call.gather.ended`
* **Prueba entrante** con `WEBHOOK_CONTROL` en el número

## Próximos pasos

* [Inicio Rápido](/es/voice-api/como-funciona/quick-start): originar, consultar y controlar
* [Ámbitos de clave API](/es/voice-api/como-funciona/escopos-da-api-key): permisos
* [Eventos de webhook](/es/voice-api/como-funciona/eventos-do-webhooks): cargas útiles `voice.call.*` y `phone_number.*`
* [Números de Teléfono](/es/phone-numbers-api/como-funciona/quick-start): contratar y configurar línea