> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Campañas y leads
> Contacta listas de leads con campañas salientes multicanal — llamada, WhatsApp o SMS
Una campaña contacta a una lista de **leads** a través de exactamente un canal principal: llamada telefónica con IA, plantilla de WhatsApp aprobada, WhatsApp Call (Beta) o SMS. Las campañas de voz pueden enviar un seguimiento opcional por WhatsApp, SMS o **correo electrónico** después de que fallen todos los reintentos de llamada. El seguimiento por correo se envía desde la dirección verificada asignada al asistente de la campaña (Settings → Channels → Email) y no está disponible como canal principal.
Una campaña usa el canal que selecciones durante la configuración. Los clientes de la API pública pueden seleccionar el canal explícitamente al crear una campaña.
## Leads y audiencias
Los leads son los [contactos de Audience](/es/audience/contacts) que una campaña está trabajando activamente — todo lead de campaña es un contacto, pero un contacto solo se convierte en "lead" cuando se asigna a la cola de una campaña.
* **Impórtalos** mediante CSV o añádelos desde la interfaz, la API o MCP. Las altas por API y MCP admiten un correo opcional, lo validan y normalizan, y rechazan una identidad de teléfono o correo existente en lugar de fusionar contactos silenciosamente.
* Cada lead tiene un **número de teléfono** (E.164), nombre y correo opcionales, etiquetas y campos personalizados como Empresa, Importe pendiente o Fecha de cita.
* Los mapeos de campaña pueden usar campos de contacto, campos personalizados, variables de asistente, valores horarios propios de la campaña, valores de sistema o de canal de solo lectura, y los campos de análisis de la llamada anterior.
* En el detalle del lead dentro de la campaña, los campos de contacto y las variables gestionadas por el usuario son editables. Las identidades de tiempo de ejecución y de canal se muestran por separado como variables de sistema de solo lectura.
* Toda acción principal o de seguimiento queda registrada como un intento de entrega.
## Configurar una campaña
Crear una campaña recorre un asistente de tres pasos —**Campaign**, **Settings**, **Launch**— y después completas su cola y la inicias desde la propia página de la campaña.
Ponle nombre a la campaña y elige su canal: Call, WhatsApp, WhatsApp Call (Beta) o SMS. El asistente solo muestra recursos con nombre que pertenezcan al espacio de trabajo actual.
Selecciona el asistente o remitente, la plantilla aprobada y sus mapeos, las llamadas en paralelo, los reintentos y el manejo del contestador automático. Consulta [Marcador, reintentos y cumplimiento](/es/campaigns/dialer-and-compliance).
Define la ventana de contacto y la zona horaria, elige el seguimiento opcional, y termina o activa **Schedule automatic start** para una fecha y hora local futuras.
En la página de la nueva campaña, [importa un CSV](/es/audience/importing-contacts) o usa **Assign leads** para extraer contactos de un segmento de Audience guardado o elegirlos a mano — asignar un contacto que ya está en otra campaña también lo copia a esta. Los números en tu [lista de no llamar](/es/campaigns/dialer-and-compliance#lista-de-no-llamar-dnc) se marcan automáticamente.
Selecciona **Start** en cuanto la campaña tenga un asistente y al menos un lead. **Stop** la devuelve a Paused: no se reclaman nuevas entregas, mientras que las llamadas activas y los envíos ya aceptados terminan con normalidad.
Un segmento es un filtro guardado, resuelto en el momento en que lo asignas — no una suscripción en vivo. Los contactos que empiezan a coincidir más tarde no se añaden por sí solos; vuelve a asignar el segmento para incorporarlos.
## Estado de la campaña
Una campaña pasa por seis estados:
| Estado | Significado |
| --------- | ------------------------------------------------------------------------ |
| Draft | En configuración — no está marcando |
| Scheduled | Programada para iniciar en una fecha y hora futuras |
| Running | Trabajando activamente su cola |
| Paused | Dejó de tomar leads nuevos; las llamadas activas terminan con normalidad |
| Completed | La cola está vacía (o se alcanzó el objetivo) y la marcación se detuvo |
| Archived | Retirada — excluida del recuento de campañas de tu plan |
Una campaña archivada no puede iniciarse hasta que se restaure.
## Monitorear una campaña en ejecución
La vista de la campaña muestra el estado principal y de seguimiento, la última y la próxima actividad, los totales entregados/fallidos, y la duración de voz cuando corresponda. Los leads de WhatsApp Call pueden quedar en **Awaiting permission** hasta que el cliente conceda permiso explícito para recibir llamadas salientes.
Cambia entre **List** (una tabla paginada con búsqueda) y **Board** — una vista de arrastrar y soltar con los leads de esta campaña agrupados por [estado](/es/audience/contacts#estado-del-contacto): Ready, Processing, Scheduled, Failed / Max retries, Completed y Suppressed. Arrastra una tarjeta a **Ready** para ponerla de nuevo en cola para otra llamada, o a **Suppressed** para impedir que la campaña vuelva a contactarla. Un lead al que se está llamando en ese momento no se puede mover, y ninguna otra columna acepta que se suelte ahí.
De forma predeterminada, la campaña se completa automáticamente cuando no quedan leads y todas las llamadas han terminado. Desactiva **Auto-complete when no leads remain** para mantenerla lista para leads importados de forma continua.
## API y MCP
Usa `GET/PATCH /api/v1/campaigns/{id}/leads/{leadId}` o MCP `get_lead` / `update_lead` para un lead concreto. `GET /api/v1/variables/catalog` y MCP `list_variable_sources` listan las fuentes de mapeo válidas. Usa `GET /api/v1/campaigns/{id}/deliveries` o MCP `list_campaign_deliveries` para el historial de entregas.
Consulta también [Manual de llamadas salientes](/es/campaigns/outbound-playbook) para saber a quién llamar, cuándo y qué decir.