> ## 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.
# Marcador, reintentos y cumplimiento
> Marcación paralela, lógica de reintento, ventanas de llamadas, listas DNC y manejo de correo de voz
El marcador se ejecuta **del lado del servidor**: no es necesario que ninguna pestaña del navegador permanezca abierta. Funciona continuamente, conciliando llamadas terminadas y enviando otras nuevas dentro de sus reglas.
## Marcación paralela (concurrencia)
* Establezca una **concurrencia** por campaña: cuántas llamadas se realizan simultáneamente.
* El límite efectivo es el *inferior* de la configuración de la campaña y el`max_parallel_calls`de su plan.
* Las llamadas obsoletas (atascadas mientras suenan) se detectan y liberan automáticamente, por lo que los espacios nunca se pierden.
## Lógica de reintento
Los clientes potenciales sin respuesta se reintentan automáticamente:
* **Intentos máximos** (`retry_max`) por cliente potencial (por ejemplo, 3).
* **Retraso entre intentos** (por ejemplo, 120 minutos): el reintento se produce en una *hora diferente del día*, lo que mejora considerablemente el alcance.
* Un cliente potencial que responde deja de ser reintentado; Los resultados`busy`,`no answer`y`failed`programan el siguiente intento hasta que se agote el presupuesto.
* El historial completo de intentos es visible por cliente potencial.
`retry_max`es el límite máximo para **cada** política de reintento a continuación. Las opciones de correo de voz y objetivo no crean bucles ilimitados: una vez que se agotan los intentos adicionales, el cliente potencial finaliza con un estado de terminal (`failed`/`no_answer`).
### Vuelva a intentarlo hasta que un humano responda
Habilite **`retry_on_voicemail`** (desactivado predeterminado) para *continuar llamando hasta que un humano responda (omitir mensajes de voz)*. Cuando está activada, una llamada cuyo [resultado AMD](#amd--voicemail) es una categoría de máquina (`machine-vm`,`machine-ivr`,`machine-unavailable`) **no** cuenta como alcanzada: la oportunidad se reprograma para otro intento en lugar de marcarse como finalizada, hasta`retry_max`. Sólo un resultado`human`(o un presupuesto de reintento agotado) finaliza el liderazgo.
Esta es una *política* de reintento. Lo que realmente hace el asistente cuando llega a una máquina (colgar en silencio o dejar un mensaje) se configura en el **asistente** (Configuración → Conversación → Correo de voz), no en la campaña.
### Vuelva a intentarlo hasta lograr el objetivo.
Dos configuraciones funcionan juntas para seguir marcando un cliente potencial hasta que se alcance un resultado definido:
* **`retry_until_goal`** (booleano, predeterminado desactivado): *Continuar llamando hasta alcanzar el objetivo.* Un cliente potencial se marca como`completed`solo cuando su variable de objetivo se evalúa como`true`en la llamada finalizada; de lo contrario, el marcador programa otro reintento (limitado por`retry_max`).
* **`goal_variable`** (texto) — *Variable que debe ser verdadera para marcar un cliente potencial como completado.* El nombre de un campo booleano de evaluación posterior a la llamada. Las opciones provienen de los campos de análisis posteriores a la llamada del asistente de campaña (los campos`boolean`en su configuración de análisis), además del indicador integrado **`success`**. El marcador lee el valor de los datos de análisis de la llamada finalizada (o el indicador`success`de la llamada cuando la variable es`success`).
Si`retry_until_goal`está activado pero la variable de objetivo nunca se convierte en`true`, se reintenta el cliente potencial hasta que se alcanza`retry_max`y luego finaliza con un estado terminal; la política de objetivo nunca anula el límite de reintentos.
## Llamando a ventanas
Defina **cuándo puede marcar la campaña**, por día laborable, en la **zona horaria** de la campaña; p. De lunes a viernes de 09:30 a 18:00. Fuera de la ventana, el marcador se detiene y se reanuda automáticamente.
En Alemania, las llamadas no solicitadas fuera de horarios razonables violan la UWG. Las ventanas de llamadas no son sólo una característica de cortesía: configúrelas para cada campaña que llame a los consumidores.
## No llamar (DNC)
Una **lista DNC central por espacio de trabajo** bloquea los números de todas las campañas:
* Los números de la lista **nunca se marcan**, incluso si están presentes en una importación de clientes potenciales (se eliminan en el momento del envío y se informan como bloqueados).
* Agregue entradas manualmente, mediante importación, o permita que **el asistente agregue personas que llaman durante una conversación** ("por favor, nunca vuelvas a llamarme" → el agente coloca el número en la lista DNC).
* Cada entrada registra su fuente y motivo, para la auditabilidad.
Administre la lista en **Configuración → Supresión**, o mediante programación:
* `GET /v1/suppression-list`: lista de entradas (filtros`?search=`por teléfono o motivo)
* `POST /v1/suppression-list`: agrega un número (`{ "phone": "+4930123456", "reason": "..." }`)
* `DELETE /v1/suppression-list/{id}`: eliminar mediante ID de entrada o número E.164 codificado en URL
Las mismas operaciones están disponibles como herramientas MCP:`list_suppression_entries`,`add_suppression_entry`,`remove_suppression_entry`.
## AMD y correo de voz
**Detección de contestador automático** clasifica quién contestó en una de cinco categorías:
| Resultado AMD | Significado |
| --------------------- | ------------------------------------------------------------------------------ |
| `human` | Una persona respondió: la conversación transcurre con normalidad |
| `uncertain` | No se pudo clasificar: se trata como a un ser humano, continúa la conversación |
| `machine-vm` | Correo de voz/contestador automático |
| `machine-ivr` | Un sistema de menú IVR/teléfono |
| `machine-unavailable` | Número no disponible/mensaje del operador |
Lo que el asistente *hace* en una máquina (colgar en silencio o dejar un mensaje después del pitido) se configura en el **asistente** (Configuración → Conversación → Correo de voz), no en la campaña.
El resultado de AMD se almacena en la llamada y proporciona el estado del cliente potencial, por lo que la lógica de reintento puede distinguir "buzón" de "nunca contestado". Active [`retry_on_voicemail`](#reintentar-hasta-que-un-humano-responda) para seguir marcando hasta que responda un humano (en lugar de una categoría`machine-*`).
Mensaje de correo de voz + reintento a una hora diferente es la combinación de mayor retorno de la inversión para la comunicación en frío: el mensaje del buzón prepara al cliente potencial, el reintento lo captura en vivo. Empareje el mensaje de correo de voz del asistente con el conmutador`retry_on_voicemail`de la campaña.