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

# Secuencias y analítica

> Dirige los contactos de una campaña telefónica según el resultado de la llamada, añade pasos de SMS y RCS, WhatsApp y correo, llama en la hora local de cada contacto, rota los números de salida, edita una campaña en pausa, lanza con una confirmación de consentimiento y mide las conversiones

Una **secuencia** decide qué ocurre con cada contacto de una campaña telefónica: cuántas veces llamarlo, qué hacer con la respuesta, cuándo enviar un SMS o un mensaje RCS, un mensaje de WhatsApp o un correo, y cuándo volver a llamar o parar. La pestaña **Análisis** te muestra después a cuántos contactos has llamado, alcanzado y convertido, y cuántos mensajes han salido.

## Ver la guía en vídeo

La interfaz en inglés usa datos de demostración. Las ejecuciones, clientes y resultados son simulados; elige tu idioma en los subtítulos.

<video controls playsInline preload="none" poster="/videos/tutorials/campaigns-sequences-and-analytics/overview.png" aria-label="Crear, lanzar y medir una secuencia de campaña">
  <source src="https://docs.famulor.io/videos/tutorials/campaigns-sequences-and-analytics/overview.mp4" type="video/mp4" />
</video>

Ejemplo: un concesionario de coches en Múnich llama a 2.000 leads, entre ellos 300 en Austria y 40 en Nueva York. Con una secuencia, los leads de Nueva York reciben la llamada en horario laboral de Nueva York. Un lead al que nadie alcanza recibe un SMS al día siguiente. Si responde, la campaña lo cuenta como un éxito; si no, recibe una llamada más dos días después. La pestaña Analytics muestra cuántos leads se convirtieron en citas.

> [!NOTE]
>
> Las secuencias están disponibles para campañas de llamadas telefónicas con su propia lista de contactos. Las campañas de WhatsApp, SMS o con audiencia externa, y las campañas creadas sin secuencia, conservan los ajustes de reintento descritos en [Marcador, reintentos y cumplimiento](https://docs.famulor.io/es/campaigns/dialer-and-compliance.md#lógica-de-reintento). Las campañas telefónicas que creas en la aplicación web empiezan con una secuencia. Las campañas creadas mediante la API, MCP o la CLI sin el campo `sequence` siguen siendo clásicas.

## Qué es una secuencia

Una secuencia se compone de **pasos**: pasos de llamada y pasos de mensaje. Un **paso de llamada** tiene:

* **Un asistente.** Por defecto el asistente de la campaña; un paso puede usar otro.
* **Intentos.** Cada intento tiene una espera. El primero es inmediato; cada uno de los siguientes espera el número de minutos indicado después del inicio del anterior.
* **Buzón de voz por intento.** Un intento puede colgar ante un buzón de voz o dejar un mensaje. Sin ajuste, se aplican los ajustes de buzón de voz de la campaña.
* **Resultados.** Tras una llamada contestada, el resultado decide el siguiente destino: otro paso (tras una espera), otro intento del mismo paso o el final.

Un **paso de mensaje** envía un SMS o un mensaje RCS, una plantilla de WhatsApp o un correo. Consulta [Enviar mensajes en una secuencia](#enviar-mensajes-en-una-secuencia).

Una secuencia admite hasta 10 pasos, 10 intentos por paso de llamada y 10 resultados por paso de llamada. El primer paso puede ser una llamada o un mensaje.

### Cómo se decide un resultado

Cada resultado tiene una condición. Eliges uno de dos tipos:

* **Descrito por ti.** En **Cuando**, elige **La IA decide** y describe el resultado en una frase, por ejemplo «El contacto está abierto a la oferta, pero quiere pensárselo». Una IA lee la transcripción de la llamada y elige la descripción que mejor encaja.
* **Reglas predefinidas.** En **Cuando**, elige una regla. La plataforma comprueba los datos de la llamada sin IA: **El campo objetivo es verdadero** (el campo de objetivo del análisis de la llamada), **Devolución de llamada programada**, **Transferido a una persona** o **Marcado como exitoso**.

Tres resultados vienen integrados:

| Resultado | Cuándo se aplica |
| - | - |
| No response | Todos los intentos del paso quedaron sin respuesta o cayeron en un buzón de voz |
| Other | La llamada se contestó, pero ninguno de tus resultados coincidió |
| Do not call | El contacto pidió que no se le vuelva a llamar o está en la lista de exclusión del espacio de trabajo. No se vuelve a llamar al contacto |

Do not call se detecta automáticamente y tiene prioridad sobre tus propios resultados.

### Adónde lleva un resultado

| Destino | Efecto |
| - | - |
| Otro paso | El contacto pasa a ese paso tras la espera que indiques (al menos 5 minutos después de una llamada contestada) |
| Retry | El siguiente intento del mismo paso. Si no queda ninguno, se aplica No response |
| End | El contacto termina. Un **Final exitoso** cuenta al contacto como **Convertido** |

## Enviar mensajes en una secuencia

Un paso de mensaje envía un mensaje y después hace avanzar al contacto. Sustituye al seguimiento opcional de una campaña clásica: las campañas con secuencia no tienen un ajuste de seguimiento aparte, y la API rechaza un seguimiento junto con una secuencia con un error 400. El **Seguimiento** que eliges al crear una campaña telefónica se convierte en un paso de mensaje después de **Sin respuesta** en su secuencia.

| Tipo de paso | Qué envía | Qué necesita |
| - | - | - |
| SMS y RCS | Un texto de hasta 1.600 caracteres, desde un número de la plataforma (SMS) o con el nombre de tu empresa (RCS) | Un número del espacio de trabajo que pueda enviar SMS, o un nombre de empresa aprobado y listo para enviar (**Ajustes → Canales → SMS y RCS**). Un nombre de empresa requiere un plan que incluya RCS |
| WhatsApp | Una plantilla aprobada | Un remitente de WhatsApp activo y una plantilla de texto aprobada; cada marcador se asigna a un campo del contacto |
| Correo | Un asunto y un texto | Una dirección de correo verificada del asistente del paso (por defecto, el asistente de la campaña) |

El texto puede contener marcadores como `{{name}}`. Un paso que no cumple sus requisitos no se puede guardar ni lanzar, y el mensaje nombra el paso, por ejemplo `Step "SMS reminder": Select an SMS-capable workspace number with outbound SMS enabled.`

### Canales que puede usar un paso

Un paso solo puede usar un canal que pueda escribir primero a un contacto que conoces por su número de teléfono o su correo: la llamada telefónica, SMS y RCS, la plantilla de WhatsApp y el correo. Telegram, Messenger, Instagram, el chat web y los demás canales de mensajería solo pueden responder dentro de una conversación que haya iniciado el contacto, por eso no se ofrecen como pasos. WhatsApp Call tampoco es un paso, porque el contacto tiene que dar antes permiso para la llamada; usa para ello una campaña de WhatsApp Call.

### Enviar con el nombre de tu empresa (RCS)

SMS y RCS son un solo canal en Famulor. Las bajas, las horas de silencio y las respuestas funcionan igual para ambos, y el tipo de paso se llama **SMS y RCS**.

* **Elegir el remitente.** El campo **Remitente SMS** de un paso SMS y RCS tiene dos grupos: **Números** y **Nombres de empresa (RCS)**. Un paso usa exactamente un remitente. Un espacio de trabajo que solo tiene nombres de empresa también puede añadir el paso. Los nombres de empresa se configuran en **Ajustes → Canales → SMS y RCS**; consulta [Conversaciones SMS](https://docs.famulor.io/es/channels/sms.md).
* **Disponibilidad.** Al guardar, lanzar, iniciar o reanudar, el nombre de empresa debe pertenecer al espacio de trabajo, estar aprobado y listo para enviar, y el plan debe incluir RCS.
* **Un nombre de empresa deja de estar listo.** Si se pausa o pierde la aprobación mientras la campaña está en marcha, la campaña se pausa y conserva el error. No se omite a ningún contacto: corrige el remitente y reanuda la campaña.
* **RCS no llega a un contacto.** Si el nombre de empresa no puede enviar a un contacto (país o número no admitido), ese contacto sigue la ruta **No enviado** y no cuenta en **Mensajes enviados**.

La tarjeta del paso muestra **RCS** en lugar de **SMS** cuando el paso envía con un nombre de empresa. Una campaña de SMS y el seguimiento por SMS de una campaña telefónica clásica ofrecen los mismos dos grupos.

### Espera, respuestas y rutas

Cada paso de mensaje tiene el ajuste **Esperar**: cuánto tiempo permanece el contacto en el paso después de enviar el mensaje. Con 0, el contacto avanza de inmediato. Tres rutas deciden adónde va después:

| Ruta | Cuándo se aplica |
| - | - |
| Enviado (**Sin respuesta** mientras se vigilan las respuestas) | La espera terminó y el contacto no respondió. Lleva a otro paso o a un final |
| Respondido | El contacto respondió por el mismo canal durante la espera. Opcional: activa **Esperar una respuesta**, que exige una espera de al menos 1 minuto |
| No enviado | No se pudo enviar el mensaje: el contacto no tiene dirección de correo, se dio de baja del canal, el proveedor lo rechazó o RCS no llega al contacto |

Una respuesta cuenta cuando el contacto responde por el canal del paso: un SMS o un mensaje RCS, un mensaje de WhatsApp o un correo del contacto. Una respuesta por otro canal no cuenta.

Un mensaje cuenta como **enviado** en cuanto el proveedor lo ha aceptado. Si el proveedor no indica con claridad si el mensaje salió, el paso lo trata como enviado y nunca lo envía una segunda vez.

### Bajas, horario de llamadas y horas de silencio

* Los contactos que se dieron de baja de un canal nunca reciben mensajes por él. Un contacto que está en la lista de exclusión para llamadas o para todos los canales termina en cualquier paso como **No llamar**. Un contacto que solo se dio de baja del canal del paso no recibe el mensaje ahí y sigue la ruta **No enviado**.
* Un contacto que responde STOP a un SMS queda dado de baja y nunca cuenta como **Respondido**, aunque haya contestado.
* Los mensajes siguen el mismo horario de llamadas, el mismo ajuste de zona horaria y los mismos festivos que las llamadas. Un mensaje espera a la próxima apertura del horario de llamadas del contacto.
* Las horas de silencio del espacio de trabajo para el canal también se aplican. Un mensaje espera a que terminen.
* Mientras las [Comprobaciones DNC federales y estatales](https://docs.famulor.io/es/settings/consent-compliance.md) esperan su verificación, un paso de llamada no marca números de EE. UU. El contacto conserva sus intentos y se vuelve a revisar 15 minutos después. Estas comprobaciones afectan a las llamadas: los pasos de mensaje se siguen enviando.

### Plan

Una secuencia que empieza con un paso de mensaje requiere un plan que incluya **campañas multicanal**, como una campaña que envía SMS o WhatsApp como canal principal. Un paso de mensaje posterior no requiere nada más. Los mensajes de WhatsApp requieren además un plan con texto de WhatsApp. Un paso SMS y RCS que envía con un nombre de empresa requiere además un plan que incluya RCS.

## Crear la secuencia

La pestaña **Secuencia** es una lista de pasos que rellenas, junto a una imagen del flujo que se dibuja sola. La imagen es de solo lectura: solo editas en la lista.

A partir de 1.280 px de ancho de pantalla, los pasos están a la izquierda y la tarjeta **Flujo** a la derecha; se redibuja con cada cambio. En una pantalla más estrecha, selecciona **Flujo** encima de la lista para abrir la imagen. Selecciona un paso en la imagen para abrir su tarjeta en la lista.

La lista muestra los pasos en el orden en que los contactos llegan a ellos, empezando por el primer paso. El orden se deriva de las rutas; tú no lo defines. Una tarjeta cerrada muestra el número del paso, el canal, el nombre, una línea de resumen (incluye el asistente del paso: el nombre del asistente de la campaña cuando el paso no tiene uno propio, o **No assistant** cuando la campaña no tiene ninguno), de dónde viene el paso (**Primer paso**, si no, el paso y la ruta anteriores) y, cuando la campaña ya ha empezado, cuántos contactos esperan en él. Selecciona la cabecera de la tarjeta para abrirla. Solo hay una tarjeta abierta a la vez; contiene **Se ejecuta después de**, los ajustes del paso y **Eliminar paso**.

| Acción | Cómo |
| - | - |
| Añadir un paso | Selecciona **Añadir paso** debajo de la lista. Justo debajo del botón se abre una lista con los cuatro tipos de paso: elige **Llamada telefónica**, **SMS y RCS**, **WhatsApp** o **Correo electrónico**. El paso nuevo se abre, lleva el nombre de su canal (con un número si ese nombre ya existe) y se engancha a la continuación natural: el último paso de la lista que tiene una ruta que termina la secuencia sin éxito, primero **Sin respuesta** o la ruta principal. Muévelo con **Se ejecuta después de** |
| Añadir un paso desde una ruta | En un selector **Después**, elige **+ Nuevo paso de llamada**, **+ Nuevo paso de SMS y RCS**, **+ Nuevo paso de WhatsApp** o **+ Nuevo paso de correo electrónico**. El paso se crea y se conecta a esa ruta |
| Cambiar dónde se ejecuta un paso | Abre el paso y cambia **Se ejecuta después de**. Muestra cada ruta que termina la secuencia, más la actual, como «paso · ruta». La ruta anterior termina entonces el contacto sin éxito y la nueva lleva al paso. Si varias rutas llevan a un paso, se muestran como texto |
| Decidir qué ocurre después | En el selector **Después** de un resultado o una ruta, elige otro paso (nunca uno que vuelva atrás), un paso nuevo, **Final: exitoso** o **Fin** |
| Eliminar un paso | Abre el paso y selecciona **Eliminar paso**. El primer paso no se puede eliminar, y el botón está desactivado mientras haya contactos esperando en el paso |
| Empezar con una plantilla | Selecciona **Plantillas**. El botón solo existe antes de iniciar la campaña |
| Definir el horario de llamadas | Abre la tarjeta **Programación** debajo de los pasos. Está cerrada por defecto y resume los días y las horas en una línea. Contiene **Horario de llamadas** con el ajuste de zona horaria, **Festivos** y **Rellamada** |

En la lista de tipos de paso, un tipo que tu espacio de trabajo aún no puede usar aparece desactivado e indica el motivo. Un enlace de plan abre **Plan** en una pestaña nueva y un enlace de configuración abre los ajustes del canal, así que tu borrador sigue abierto. Selecciona **Guardar** para conservar tus cambios: los pasos se guardan con la campaña.

Un mensaje encima de la lista indica qué falta. El paso que nombra recibe un borde rojo, y al seleccionar el mensaje se abre ese paso. Un paso de mensaje que aún no has terminado de configurar aparece como aviso, no como error.

Mientras la secuencia está bloqueada, las tarjetas se abren en solo lectura y nada cambia; solo la tarjeta **Programación** sigue siendo editable. Consulta [Después del lanzamiento](#después-del-lanzamiento).

## Empezar con una plantilla

Elige una plantilla en **Plantillas**, en la pestaña **Secuencia**, y ajústala:

| Plantilla | Qué hace |
| - | - |
| Llamada única con reintentos | Un paso con hasta tres intentos: la primera llamada sale de inmediato, la segunda un día después de la primera y la tercera un día después de la segunda. Un objetivo alcanzado termina la secuencia como convertida, «no interesado» la termina y todo lo demás se reintenta |
| Llamada con seguimiento | Una primera llamada y una llamada de seguimiento, cada una con dos intentos. Los contactos que aún lo están valorando reciben la llamada de seguimiento un día después |

Una plantilla sustituye toda la secuencia, por eso primero confirmas. El botón **Plantillas** solo existe antes de iniciar la campaña: después hay contactos en los pasos, así que editas los pasos. Consulta [Después del lanzamiento](#después-del-lanzamiento).

## Definir el calendario de llamadas

La tarjeta **Programación** de la pestaña **Secuencia** controla cuándo y en qué días se llama a los contactos.

### Horario de llamadas en la hora local de cada contacto

El horario de llamadas puede aplicarse en la zona horaria de la campaña o en la hora local de cada contacto: en **Horario de llamadas**, elige **Zona horaria de la campaña** u **Hora local del contacto**. Con la hora local, la plataforma deduce la zona horaria del contacto a partir del número de teléfono. Un número de Nueva York recibe la llamada en horario laboral de Nueva York y un número de Viena, en horario laboral de Viena.

Algunos números no apuntan a una única zona horaria, por ejemplo los números gratuitos o los de un país con varias zonas horarias. A un contacto así solo se le llama cuando el horario de llamadas está abierto en todas las zonas horarias posibles de ese país.

Los festivos y las fechas bloqueadas solo aplazan las llamadas. Un contacto cuyas franjas de llamada no se abren nunca en el próximo año (por ejemplo, porque las franjas de todas sus posibles zonas horarias nunca coinciden) recibe la fase **Inscripción fallida** con el motivo «sin ventana de llamada» si nunca se le llamó; un contacto al que ya se llamó termina como **Falló**.

### Festivos y fechas bloqueadas

En **Festivos**, activa **Omitir los festivos** para omitir los festivos nacionales del país del contacto. Los festivos están disponibles para Austria, Bélgica, Canadá, Suiza, Alemania, España, Francia, el Reino Unido (Inglaterra y Gales), Irlanda, Italia, los Países Bajos y Estados Unidos. Los contactos de otros países no se ven afectados por este ajuste. Los festivos regionales no están incluidos.

Añade en **Días sin llamadas** los días en los que no se llama, como un cierre de la empresa. Cada fecha cuenta en la hora local del contacto.

### Double dial

Con **Doble marcación** (en **Rellamada**) activado, una llamada que termina sin respuesta o con tono de ocupado se vuelve a marcar una vez de inmediato. Viene desactivado por defecto. Las llamadas inmediatas repetidas pueden ser una molestia irrazonable según el derecho de la UE, así que actívalo solo después de comprobarlo para los países a los que llamas.

## Rotar los números de salida

Un grupo de números permite que la campaña llame desde varios números del espacio de trabajo en lugar del número saliente del asistente. En la pestaña **Números**, elige números activos que puedan realizar llamadas salientes y marca uno como predeterminado:

| Modo | Qué número se usa |
| - | - |
| Local presence | Un número que coincide con el prefijo regional del contacto (Estados Unidos y Canadá, Alemania, Austria, Suiza); si no, un número del país del contacto; si no, tu número predeterminado |
| Round robin | Los números se turnan |

Un contacto conserva en todos los intentos posteriores el identificador de llamada desde el que se le llamó por primera vez, de modo que una devolución de llamada llega a un número que el contacto reconoce. Si cambias el número de teléfono de un contacto, la siguiente llamada elige un identificador nuevo.

Calcula aproximadamente un número por cada 50 contactos. La pestaña **Números** muestra los contactos por región junto a los números del grupo, para que veas a qué región le falta un número.

## Lanzar la campaña

Una campaña con secuencia se lanza con el botón **Lanzamiento** de la cabecera de la campaña. Abre el cuadro de diálogo **Lanzar la campaña**, donde eliges la hora de inicio y confirmas. **Lanzamiento** permanece desactivado mientras haya cambios sin guardar, la campaña no tenga asistente aunque un paso de llamada o de correo no tenga uno propio («Choose an assistant in the campaign settings before launching.»), la confirmación no esté marcada o la campaña no tenga contactos.

**1. Revisa el resumen**

Revisa en la pestaña **Resumen** los contactos, los números del grupo, la secuencia y el calendario. Los contactos bloqueados, por ejemplo los números de la lista de exclusión, se cuentan por separado.

**2. Elige la hora de inicio**

Selecciona **Lanzamiento** en la cabecera de la campaña. En el cuadro de diálogo, selecciona **Empezar ahora**, o **Programar para más tarde** y elige una fecha y hora al menos 5 minutos en el futuro.

**3. Confirma**

En el cuadro de diálogo, marca la confirmación: «Confirmo que esta campaña cumple todas las leyes y requisitos de consentimiento aplicables a los contactos a los que se llama, incluidas las listas de exclusión de llamadas y las reglas de opt-in (por ejemplo, la TCPA en EE. UU., la UWG y el RGPD en la UE)». Después selecciona **Lanzamiento** (**Programar lanzamiento** si elegiste un inicio posterior).

Una campaña programada muestra su hora de inicio en la pestaña **Resumen**. Selecciona **Cancelar programación** en la cabecera de la campaña para devolverla a borrador.

Si el ajuste **Autocompletar cuando no queden leads** está desactivado, puedes lanzar o iniciar la campaña sin contactos. Entonces espera a los contactos que añadas más adelante mediante la API, MCP o automatizaciones. Esto vale para todas las formas de iniciar: la aplicación web, la API pública (`launch` y `start`), un inicio programado y MCP. Con el ajuste activado, que es el valor predeterminado, una campaña sin contactos se rechaza con «The campaign has no leads.»

> [!WARNING]
>
> Al confirmar, asumes la responsabilidad del consentimiento y de las listas que se aplican a tus contactos. Ejemplos: el consentimiento expreso previo para llamadas a consumidores en Alemania (UWG §7), el consentimiento expreso previo por escrito para llamadas de voz con IA en EE. UU. (TCPA) y la comprobación de los registros nacionales de exclusión. Antes de cada llamada, la plataforma comprueba la [lista de exclusión](https://docs.famulor.io/es/campaigns/dialer-and-compliance.md#lista-de-no-llamar-dnc) de tu espacio de trabajo. No comprueba por ti los registros nacionales ni estatales. Para números de EE. UU. puedes activar las [Comprobaciones DNC federales y estatales](https://docs.famulor.io/es/settings/consent-compliance.md): hasta que se verifiquen, las llamadas a números de EE. UU. esperan. Esta página no constituye asesoramiento jurídico.

La campaña guarda quién confirmó, cuándo, desde qué superficie (web, API, MCP o CLI) y qué versión del texto. Una campaña con secuencia no puede iniciarse en ninguna superficie sin esta confirmación.

## Parallel calls

**Llamadas paralelas** define cuántas llamadas de la campaña se ejecutan a la vez. El control deslizante termina en el límite de tu espacio de trabajo, es decir, tu plan más las Concurrent Lines compradas. La línea bajo el control muestra **Límite del espacio de trabajo**. Para aumentarlo, selecciona **Actualizar**: la página Plan se abre en una pestaña nueva con el complemento de Concurrent Lines, y el borrador de la campaña sigue abierto. Cuando vuelves a la pestaña de la campaña, el campo lee el nuevo límite. Los espacios de trabajo con líneas ilimitadas y los que no tienen página Plan no muestran ningún enlace.

## Después del lanzamiento

Puedes cambiar la secuencia de una campaña que ya empezó mientras está **en pausa**. Una campaña en pausa deja a cada contacto donde está, así que puedes corregir un mensaje, añadir un paso o cambiar una espera sin empezar de nuevo.

| Estado de la campaña | Secuencia |
| - | - |
| Borrador | Editable |
| En pausa | Editable |
| En curso | Bloqueada. Selecciona **Pausar** en el aviso de la pestaña **Secuencia**: «Pausa la campaña para editar la secuencia.» |
| Programado | Bloqueada. Selecciona **Cancelar programación**: «Cancela la programación para editar la secuencia.» |
| Completado | Bloqueada. Selecciona **Duplicar para editar**. Crea un borrador con los mismos ajustes, pero sin contactos y sin confirmación |

El **modo de números** queda fijo tras el primer inicio. Todavía puedes cambiar los números del grupo, el horario de llamadas, el ajuste de zona horaria, los festivos, el double dial y las llamadas en paralelo. Una campaña iniciada conserva su tipo: no puedes añadirle una secuencia ni quitársela.

### Los contactos conservan su sitio

Un contacto que no ha terminado (en espera, en cola o en llamada) está en un paso. Un contacto al que nadie ha contactado todavía está en el primer paso. La secuencia editada debe seguir conteniendo cada paso en el que haya esos contactos, con el mismo tipo de paso. Si no, Famulor rechaza el guardado: `Step "<name>" still has <n> contacts. Keep the step, or wait until they have moved on.` Cada tarjeta muestra cuántos contactos esperan en ella, y **Eliminar paso** está desactivado mientras ese número sea mayor que cero.

Todo lo demás puede cambiar: nombres, asistentes, intentos, mensajes, esperas, resultados, rutas y pasos nuevos. Puedes quitar los pasos sin contactos en espera.

### Qué significa un cambio para un contacto a mitad de camino

Un contacto continúa en su paso con los ajustes nuevos:

* Si ya hizo más intentos de los que el paso permite ahora, el paso cuenta como agotado y el contacto sigue la ruta **Sin respuesta**.
* Un mensaje que ya se envió no se vuelve a enviar.
* La espera de una respuesta se evalúa con las rutas nuevas.
* Una espera o un retraso que ya está en marcha conserva su hora de fin. El valor nuevo se aplica a partir del siguiente envío o intento.
* Los resultados ya registrados conservan la etiqueta con la que se escribieron. La analítica muestra un paso o un resultado que ya no existe con su etiqueta guardada.

Ningún contacto empieza de nuevo. Si, pese a todo, falta el paso de un contacto, el contacto termina como fallido y nunca vuelve a empezar en el primer paso.

### Confirmar de nuevo al reanudar

Una secuencia modificada borra la confirmación de lanzamiento, porque cubría la secuencia que revisaste. Selecciona **Reanudar**: se abre una ventana con los contactos, los pasos y los números de teléfono, y con la confirmación (consulta [Lanzar la campaña](#lanzar-la-campaña)). Márcala y selecciona **Reanudar** otra vez. **Reanudar** espera hasta que hayas guardado tus cambios. En la lista de campañas, **Reanudar** no reanuda directamente una campaña así: abre la página de la campaña con la confirmación. Una campaña en pausa cuya secuencia no cambiaste se reanuda con un clic. Con la API, envía `compliance_attestation: true` con `resumeCampaign` o `startCampaign`; sin ella, el motivo es `launch_required`.

Si la campaña se reanuda mientras guardas, Famulor rechaza el guardado. Recarga la campaña y repite el cambio.

| Acción | Efecto |
| - | - |
| Pausar | Detiene las llamadas nuevas. Las llamadas en curso terminan con normalidad |
| Reanudar | Reanuda una campaña en pausa. Tras un cambio de la secuencia, vuelve a pedir la confirmación |
| Cancelar programación | Devuelve una campaña programada a borrador y elimina la hora de inicio y la confirmación. Selecciona **Lanzamiento** de nuevo para iniciarla |

### Llamar a continuación a un contacto en espera

**Llamar a continuación** está en el menú ⋮ de un contacto en la pestaña **Contactos** y en los detalles del contacto. Mientras la campaña está en marcha, hace que un contacto que espera su próxima llamada pase a estar listo de inmediato. La llamada pasa por la secuencia como cualquier otro intento. Para un contacto que espera en un paso de mensaje, la acción está desactivada: al contacto se le llama cuando llega a un paso de llamada.

## Fases de un contacto

Cada contacto de una campaña con secuencia muestra en la pestaña **Contactos** su fase, el paso actual, el resultado y el identificador de llamada.

| Fase | Significado |
| - | - |
| Enrolled | Espera la siguiente llamada |
| In progress | Hay una llamada en curso o se está evaluando su resultado |
| Completed | La secuencia ha terminado para este contacto, incluidos No response y Do not call |
| Enroll failed | Nunca se llamó al contacto. Se muestra el motivo: excluido (el número está en la lista de exclusión), número no válido o sin ventana de llamada |
| Failed | La llamada no pudo completarse |

## Leer la analítica

![La pestaña Análisis de una campaña de ejemplo: 198 marcados, 96 conectados, 58 convertidos, una tasa de conversión del 29,3 %, 94 mensajes enviados y el reparto de resultados](https://mintcdn.com/ouraicall/fCMXM821NmRcRdYY/images/campaigns/sequence-analytics-example.webp?fit=max\&auto=format\&n=fCMXM821NmRcRdYY\&q=85\&s=5213a0fc0d19c74b029f4e81ad221ffa)

Ejemplo con datos de demostración

La pestaña **Análisis** de una campaña lanzada muestra estas cifras para el periodo seleccionado:

| Cifra | Definición |
| - | - |
| Dialed | Contactos con al menos una llamada en el periodo |
| Connected | Contactos con al menos una llamada contestada: se completó, no cayó en un buzón de voz ni en un número no disponible y tuvo tiempo de conversación |
| Converted | Contactos que alcanzaron un final exitoso en el periodo. En campañas sin secuencia, contactos con una llamada marcada como exitosa o cuyo campo de objetivo es verdadero |
| Conversion rate | Converted dividido entre Dialed, limitado al 100 %. Vacío mientras no se haya llamado a nadie |
| Mensajes enviados | Mensajes que los pasos de mensaje enviaron en el periodo: SMS, RCS, WhatsApp y correo. Los mensajes que no se pudieron enviar no cuentan |

Debajo encontrarás:

* **Tiempo de conversación y coste:** el tiempo total de conversación en minutos y el coste de las llamadas de la campaña en el periodo, como importe en la moneda de tu espacio de trabajo (no en créditos).
* **Distribución de resultados:** un flujo desde los contactos inscritos a través de los resultados de cada paso, hasta cuatro pasos. Los pasos posteriores se agrupan como «More». Los pasos de mensaje añaden **Enviado**, **Respondido** y **No enviado**. Los contactos sin resultado aparecen como en curso, en espera o sin alcanzar. Un contacto cuyo mensaje se envió y espera una respuesta está en espera. Una vista de tabla muestra las mismas cifras. Las campañas sin secuencia muestran en su lugar los estados de sus contactos.
* **Actividad a lo largo del tiempo:** llamadas, llamadas contestadas y contactos convertidos por día, en la zona horaria de la campaña.

Filtra por **Todo el período**, **7 días**, **30 días** o **90 días**, y por número de salida. Con un filtro de número de salida solo se cuentan los contactos a los que se llamó desde ese número. **Mensajes enviados** es la excepción: los mensajes no tienen número de salida, así que esta cifra siempre cuenta toda la campaña.

## Disponibilidad según el plan

Las secuencias y los grupos de números requieren un plan que incluya **Secuencias de campaña**. Una secuencia que empieza con un paso de mensaje requiere además **campañas multicanal**. Si tu plan no incluye alguno de los dos, consulta con tu proveedor. La analítica está disponible para todas las campañas.

## API, MCP y CLI

Cada acción anterior también está disponible fuera de la aplicación web:

| Acción | Operación REST | Herramienta MCP | Comando CLI |
| - | - | - | - |
| Lanzar o programar | `launchCampaign` | `launch_campaign` | `famulor launch-campaign` |
| Pausar | `pauseCampaign` | `pause_campaign` | `famulor pause-campaign` |
| Reanudar | `resumeCampaign` | `resume_campaign` | `famulor resume-campaign` |
| Cancelar la programación | `cancelCampaignSchedule` | `cancel_campaign_schedule` | `famulor cancel-campaign-schedule` |
| Duplicar | `duplicateCampaign` | `duplicate_campaign` | `famulor duplicate-campaign` |
| Analítica | `getCampaignAnalytics` | `get_campaign_analytics` | `famulor get-campaign-analytics` |
| Editar | `updateCampaign` | `update_campaign` | `famulor update-campaign` |
| Contactos por paso | `getCampaignStats` | `get_campaign_stats` | `famulor get-campaign-stats` |

La confirmación forma parte de la solicitud. Para lanzar se requiere `compliance_attestation: true`. La operación de inicio acepta la misma opción, de modo que una campaña con secuencia que aún no se lanzó también puede iniciarse con ella. Sin la confirmación, la API responde `attestation_required` al lanzar y `launch_required` al iniciar.

```bash theme={null}
famulor launch-campaign CAMPAIGN_ID --compliance-attestation true
```

Para asegurarte de que se lanza la secuencia que revisaste, puedes enviar `sequence_hash`. Lee el valor sin cambios de `GET /campaigns/{id}` (campo `sequence_hash`) antes de lanzar. Si la secuencia cambió entre tanto, el lanzamiento se rechaza con `sequence_changed` y no se inicia nada. El campo es opcional; omítelo para saltar la comprobación, y omítelo en campañas sin secuencia, donde `sequence_hash` está vacío.

Envía `start_at` como fecha ISO 8601 al menos 5 minutos en el futuro para programar, o `null` para iniciar de inmediato:

```bash theme={null}
curl -X POST https://app.famulor.io/api/v1/campaigns/CAMPAIGN_ID/launch \
  -H "Authorization: Bearer fam_..." \
  -H "Content-Type: application/json" \
  -d '{"compliance_attestation": true, "start_at": null}'
```

Si usas un dominio de marca blanca, sustituye `app.famulor.io` por ese dominio. Crea o actualiza una campaña con `sequence`, `number_pool`, `holidays`, `double_dial` y el modo de zona horaria del contacto; consulta la [referencia de la API](https://docs.famulor.io/es/api-reference/introduction.md).

En `sequence.nodes`, un paso sin `channel` es un paso de llamada. Un paso de mensaje tiene `channel` con el valor `sms`, `whatsapp_template` o `email` y un `message` con `config`, `wait_minutes`, `next`, `replied` opcional y `failed`. Los pasos no tienen posición: el flujo se dibuja solo, y una `position` en una solicitud se ignora. La respuesta de analítica incluye `kpis.messages_sent`.

```json theme={null}
{
  "id": "sms_reminder",
  "name": "SMS reminder",
  "channel": "sms",
  "message": {
    "config": { "from_number_id": "NUMBER_ID", "message": "Hi {{name}}, we tried to reach you." },
    "wait_minutes": 1440,
    "next": { "type": "end", "successful": false },
    "replied": { "type": "end", "successful": true },
    "failed": { "type": "end", "successful": false }
  }
}
```

Un paso `sms` nombra exactamente un remitente en `config`: `from_number_id` (un número del espacio de trabajo) o `rcs_sender_id` (un nombre de empresa, RCS). Los dos a la vez, o ninguno, dan un error 400. La misma regla vale para una campaña de SMS y para el seguimiento por SMS de una campaña clásica.

```json theme={null}
{ "rcs_sender_id": "SENDER_ID", "message": "Hi {{name}}, we tried to reach you." }
```

### Editar una campaña en pausa a través de la API

Envía la nueva `sequence` con `PATCH /campaigns/{id}`. Lee antes `sequence_step_contacts` de `getCampaignStats`: el campo lista los contactos sin terminar (en espera, en cola o en llamada) por id de paso, y un paso con contactos tiene que seguir en la secuencia.

```json theme={null}
{ "campaign_id": "CAMPAIGN_ID", "sequence_step_contacts": { "first_call": 18, "sms_reminder": 7 } }
```

El cambio falla con un 409 cuando no se puede aplicar:

| Respuesta | Causa |
| - | - |
| `Pause the campaign to edit the sequence.` | La campaña está en marcha |
| `Cancel the schedule before changing the sequence.` | La campaña está programada |
| `Duplicate the campaign to change the sequence.` | La campaña está completada, una campaña iniciada ganaría o perdería su secuencia, o cambiaría el modo del grupo de números |
| `Step "<name>" still has <n> contacts. Keep the step, or wait until they have moved on.` | La nueva secuencia quita un paso con contactos en espera o cambia su tipo |
| `The campaign changed while it was saved. Reload it and try again.` | El estado cambió entre tu lectura y tu escritura, por ejemplo por una reanudación. Vuelve a leer la campaña y reinténtalo |

Da a un paso que añades a una campaña iniciada un id que nunca se haya usado en ella, para que su historial no se mezcle con el de un paso eliminado. El constructor lo hace por ti. Como el cambio borra la confirmación de lanzamiento, reanuda con ella:

```bash theme={null}
famulor resume-campaign CAMPAIGN_ID --compliance-attestation true
```

Consulta también [Campañas y leads](https://docs.famulor.io/es/campaigns/overview.md), [Marcador, reintentos y cumplimiento](https://docs.famulor.io/es/campaigns/dialer-and-compliance.md) y el [Manual de llamadas salientes](https://docs.famulor.io/es/campaigns/outbound-playbook.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.