# Límites y horarios de llamada

Con qué frecuencia Voice Logica llama a la misma persona y en qué horario. Estas reglas protegen a las personas a las que llama (y la reputación de su número ante los operadores). Se aplican solo a las llamadas **salientes**. Quien le llama a usted nunca tiene límites.

## Horario de llamadas

- Las llamadas salientes solo se realizan entre las **09:00 y las 21:00**, en la hora del **país de su empresa**.
- Las llamadas individuales (API, workflows, llamadas programadas) tampoco se realizan en **sábado ni domingo**.
- Una llamada solicitada fuera de este horario no se pierde. Se **programa** para la siguiente hora permitida, y la API responde `"scheduled": true` con `scheduleTime`.
- Las [campañas](https://docs.voicelogica.ai/es/outbound-calls/campaigns/) llaman solo dentro de sus propios **días y horas de horario**, y nunca fuera de 09:00–21:00.
- Las transferencias y las llamadas que una persona realiza desde las aplicaciones o un teléfono de escritorio no tienen límites.

Las solicitudes de API pueden saltarse el horario con `overrideTimeRestriction: true` y la regla del fin de semana con `overrideDayRestriction: true`. Llamar por la noche o en fin de semana puede infringir la normativa de protección al consumidor de su país. Úselo solo para personas que pidieron ser llamadas en ese momento.

## Llamadas individuales: como máximo 3 al día por número

Toda llamada realizada de una en una (la [API](https://docs.voicelogica.ai/es/outbound-calls/api/), un workflow, una llamada programada) está protegida **por defecto**. Para cada número de teléfono, por día:

| Regla | Límite | Si lo supera |
|---|---|---|
| Llamadas que se conectaron | **3** | `daily_call_limit_reached` |
| Intentos fallidos (sin ruta, rechazados) | **3** | `failed_call_limit_reached` |
| Tiempo entre llamadas que se conectaron | **1 hora** | `cooldown_period_active` |
| Llamadas simultáneas al mismo número | **1** | `call_already_in_progress` |

- Las llamadas que la persona le hace a usted no cuentan.
- Una devolución de llamada que pidió la persona («llámeme a las 7») se realiza siempre: no está sujeta a estos límites ni al máximo de reintentos de la campaña. El horario de llamadas sigue aplicándose.
- Las solicitudes rechazadas tampoco cuentan.
- El día se reinicia a **medianoche UTC**.
- Una solicitud rechazada responde HTTP 429 (409 si ya hay una llamada en curso), con `details.retryAfterSeconds`, `details.nextAllowedAt` y una cabecera `Retry-After`. Espere hasta entonces. No la reenvíe en bucle.
- Una solicitud de API puede desactivar estos límites con `useAntiHarassmentProtection: false`. Hágalo solo para números propios o personas que esperan las llamadas.

## Campañas: cuántas veces se llama a una persona

Las campañas no siguen la regla de 3 al día. Usted decide con qué frecuencia se llama a cada persona de la lista (cada lead), en la pestaña **Etapas** de la campaña.

<Aside type="tip" title="En resumen">
- **Nadie contesta:** volvemos a llamar, hasta el número de **reintentos** que haya fijado, con la espera que haya fijado entre llamadas. 3 reintentos significan hasta 4 llamadas.
- **Alguien contesta, pero aún no hay un sí o un no:** la etapa **Intentar más tarde** vuelve a llamar más adelante (hasta 4 veces más, cada 5 días, salvo que lo cambie).
- **Un límite por persona:** los dos ajustes lo comparten. Lo máximo que recibe una persona es la primera llamada más el mayor de los dos números, no la suma de ambos.
- **«Llámeme mañana a las 6»** se realiza siempre, aunque se hayan agotado las llamadas.
- Solo se llama en los días y horas de la campaña.
</Aside>

### Cuando nadie contesta

Abra **Etapas** → **Cuando nadie contesta** y fije cuántas veces volver a llamar y cuánto esperar entre llamadas.

- «Nadie contestó» significa línea ocupada, buzón de voz, sin respuesta o una llamada que no llegó a conectar. Un número que no existe no se vuelve a llamar.
- Los **reintentos** (de 0 a 10, por defecto **3**) son las llamadas *después* de la primera. 3 reintentos = hasta 4 llamadas en total. 0 = una sola llamada.
- **Espera entre llamadas:** de 1 hora a 4 semanas, por defecto **4 horas**.

### Cuando alguien contesta

Tras cada llamada contestada, la IA elige la etapa que corresponde a cómo fue, por ejemplo *Conseguido*, *Fallido* o *Intentar más tarde*. Una etapa con **Intentar de nuevo** vuelve a llamar a la persona más adelante. Usted fija **Llamadas en esta etapa** (de 1 a 10) y la espera (de 30 minutos a 1 semana). **Llamadas en esta etapa** incluye la llamada que llevó a la persona a la etapa. Ejemplo: *Intentar más tarde* en 5 = hasta 4 llamadas más, cada 5 días. Quien rechaza se cierra como **Cancelado** y no se le vuelve a llamar.

### Los dos ajustes comparten un límite

Nadie recibe más llamadas que **la primera llamada + el mayor de los dos números**: los reintentos de *Cuando nadie contesta* o el número más alto de **Intentar de nuevo**. Los dos números no se suman.

| Reintentos | Intentar más tarde | Máximo de llamadas por persona |
|---|---|---|
| 3 | 5 | **6** (1 + 5), no 9 |
| 3 | 2 | **4** (1 + 3) |
| 0 | 5 | **6** (1 + 5) |

Las llamadas sin respuesta y las de *Intentar más tarde* salen del mismo cupo. Quien no contestó tres veces tiene menos llamadas de *Intentar más tarde* disponibles. Con una etapa *Intentar más tarde*, incluso con 0 reintentos, alguien que nunca contesta puede recibir más de una llamada. Para llamar menos, reduzca los dos números.

### Números adicionales y «llámeme a las 6»

- **Más de un número:** si el primer número no contesta, probamos el siguiente aproximadamente un minuto después. Eso no consume un reintento; la espera empieza cuando se han probado todos los números.
- **La persona indica una hora** («llámeme mañana a las 6»): esa llamada se realiza siempre, aunque se hayan agotado las llamadas, dentro del horario de llamadas y de los días y horas de la campaña. Aun así cuenta como una de sus llamadas, así que después puede que no quede ninguna. Si pidió que la llamaran sin indicar hora, volvemos a llamar tras la espera fijada (2 días en las campañas de citas).
- La herramienta **Schedule Callback** es otra cosa: crea una tarea de devolución de llamada para su equipo y no realiza la llamada de la campaña. Su **Max callbacks per caller** (de 1 a 3) limita esas tareas, no las llamadas de la campaña. Consulte [Tools & Workflows](https://docs.voicelogica.ai/es/agent-configuration/built-in-tools/).

### Las llamadas esperan al horario de la campaña

Cada reintento y cada devolución de llamada se realiza solo en los días y horas del **Horario** de la campaña. Si alguno cae fuera, no se pierde: se realiza cuando vuelve a abrirse el horario. Ejemplo: horario 09:00–20:00, espera de 4 horas, llamada sin respuesta a las 18:00. La siguiente llamada sale a las 09:00 del siguiente día de llamadas.

### Cambiar los ajustes con la campaña en marcha

Puede cambiar los reintentos, la espera y las etapas en cualquier momento. El cambio se aplica en pocos segundos:

- Las personas que ya esperan una llamada a una hora fija conservan esa hora. La nueva espera se aplica después de esa llamada.
- Menos reintentos: las personas que ya recibieron ese número de llamadas no se vuelven a llamar.
- Más reintentos: las personas ya marcadas como **Intentos agotados** siguen cerradas. Para volver a llamarlas, añádalas de nuevo a la campaña.

### Cuántas veces se llamó a cada persona

En la tabla de leads de la campaña, **Intentos de llamada** muestra las llamadas hechas a cada persona hasta ahora. El estado muestra **Reintento programado** mientras espera la siguiente llamada e **Intentos agotados** cuando no quedan llamadas. Abra un lead para ver cada llamada y su etapa.

### Un mensaje cuando se agotan las llamadas

En **Cuando se agotan las llamadas**, elija un **SMS**, un **correo electrónico** o ambos, y para el SMS el remitente (**De**: *Automático* usa el remitente de SMS de su agente o el remitente verificado propio de su empresa). Se envía **una vez** por persona, cuando llega a **Intentos agotados**: las rellamadas o el límite de llamadas de una etapa se agotaron sin resultado, también si la persona contestó y colgó. Se envía dentro del horario de llamadas de la campaña (si las llamadas se agotan por la noche, se envía cuando abre la siguiente franja), nunca a un número que pidió no ser llamado, y no si se reservó una cita en alguna de sus llamadas.

<Aside type="caution">
10 reintentos con 1 hora de diferencia pueden significar **11 llamadas a la misma persona en un día**. Para personas que no pidieron ser llamadas, mantenga 2–3 reintentos y un retraso de 4 horas o 1 día.
</Aside>

Los números de **Allowed test numbers** de la campaña se saltan todos los límites. Úselo solo para sus propios teléfonos mientras hace pruebas.

## La baja es permanente

Cuando alguien pide que no le vuelvan a llamar, su número se marca como dado de baja (opted out):

- Ningún agente ni campaña de su empresa vuelve a llamarlo (`callee_opted_out`).
- Sus leads de campaña quedan aparcados.
- No vuelva a añadirlo como contacto nuevo ni en una campaña nueva.

## Contactos bloqueados

Bloquee un contacto en **Contactos** cuando esa persona solo deba hablar con su equipo, nunca con un AI agent. Sus llamadas a un número que atiende un agente se rechazan antes de que el agente conteste (SIP 603 Decline), para que su operador o su centralita las envíe a su equipo. Ningún agente ni campaña lo llama (`callee_opted_out`, motivo `contact_blocked`). Las llamadas dirigidas a un usuario o grupo de usuarios, y las que hace su equipo, no se ven afectadas. Para deshacerlo, desbloquee el contacto.

## Preguntas frecuentes

**¿Puede el agente llamar 10 veces en un día a la misma persona?**
No con llamadas individuales: el límite es de 3 llamadas al día al mismo número, con 1 hora de diferencia. Una campaña con 10 reintentos y 1 hora de retraso sí puede. Ajuste el retraso para repartir las llamadas en varios días.

**¿Por qué mi llamada saliente de la API se programó en lugar de realizarse?**
Estaba fuera de 09:00–21:00 o era fin de semana en el país de su empresa. La llamada se realiza automáticamente a la `scheduleTime` de la respuesta.

**Estoy probando llamadas salientes en mi propio teléfono y alcancé el límite. ¿Qué hago?**
Añada su número a **Allowed test numbers** de una campaña, o envíe `useAntiHarassmentProtection: false` en sus solicitudes de API de prueba.

**Configuré 3 reintentos y Intentar más tarde en 5. ¿Por qué un lead recibió 6 llamadas?**
Una campaña con etapas tiene un límite por lead: la primera llamada más el mayor de los dos valores, aquí 1 + 5 = 6. Cuentan tanto las llamadas sin respuesta como las rellamadas de Intentar más tarde. Para llamar menos veces, reduzca también el número de **Intentar de nuevo** de la etapa.

**El lead no tenía más reintentos pero se le volvió a llamar. ¿Por qué?**
La persona pidió que la llamaran a una hora concreta. Una devolución de llamada que pide la persona se realiza siempre, dentro del horario de llamadas y del horario de la campaña. Aun así, cuenta como una de las llamadas del lead.
