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

# Automatizaciones

> Flujos de trabajo nativos del espacio de trabajo — activadores, acciones, historial de ejecuciones y enlace de webhook del asistente.

La página **Automations** es el generador de flujos de trabajo de tu espacio de trabajo. Crea grafos de varios pasos con activadores, acciones, ejecuciones de prueba y un historial de ejecuciones completo.

Tu plan determina las ejecuciones de automatización mensuales incluidas. Las ejecuciones que superan esa asignación consumen créditos adicionales a la tarifa **Automation runs** de tu espacio de trabajo; las tarifas actuales están en la [página de uso](https://app.famulor.io/usage).

Los **AI steps**, como Custom Prompt, Extract Fields y MCP Call Tool, pueden usar créditos adicionales del espacio de trabajo. El importe cobrado aparece en los detalles de la ejecución y en el panel Test.

**Graph end:** un paso sin conexión de salida completa la ejecución con éxito. Stop, Return variables y Webhook respond finalizan la ejecución de inmediato y no necesitan ninguna conexión más.

## Automatizaciones frente a Agent Tools

Las automatizaciones y las Agent Tools son dos formas de que un asistente actúe sobre sistemas externos, pero en momentos distintos. Una automatización es una secuencia fija de pasos que tú (o Milian) diseñas de antemano — normalmente iniciada por un activador en segundo plano como **On Call Completed**, aunque una automatización Live también puede vincularse a un asistente como una acción invocable durante una conversación (consulta **Llamar a una automatización desde una conversación** más abajo). En cualquier caso, ejecuta la secuencia que construiste, no algo decidido sobre la marcha. Para herramientas que el propio asistente elige y ejecuta por sí mismo, en vivo, en el momento en que las necesita — buscar algo, crear un registro — consulta [Agent Tools](/es/assistants/agent-tools).

|                     | Automatizaciones (esta página)                | Agent Tools                                            |
| ------------------- | --------------------------------------------- | ------------------------------------------------------ |
| Se ejecutan         | Sobre todo en segundo plano, con un activador | A mitad de conversación, mientras se habla con alguien |
| Los pasos los elige | Tú o Milian, de antemano                      | El asistente, a medida que los necesita                |

## Activadores

* **On Call Completed** — después de que termina una llamada de voz (con análisis). Requiere un **asistente específico**.
* **On Inbound Call** — cuando empieza una llamada entrante.
* **Inject input variables** — proporciona variables del asistente cuando empieza una llamada. Termina con **Return variables**.
* **Email received** — cuando llega un nuevo correo entrante.
* **Conversation started / ended** — canal de mensajería abierto / cerrado.
* **Message received** — cada mensaje entrante en un canal, no solo el primero.
* **Contact created** — aparece un nuevo contacto de Audience. Elige qué orígenes lo activan: **Created manually** (el único activado por defecto), **CSV / file import**, **API** y **CRM sync**. Si dejas desactivados import y CRM sync, una importación masiva no dispara la automatización para cada fila.
* **Incoming Webhook** — se inicia desde la URL de webhook segura que se muestra en el activador.
* **Booking created / cancelled / rescheduled**, **Manual**, **Schedule** (próximamente).
* **App events (Beta)** — las apps conectadas, como Gmail o GitHub, aportan sus propios activadores disponibles. Requiere **Beta Features** en el espacio de trabajo.

## Acciones (plugins)

Organizadas como **Platform → type → action** (Famulor, AI, Time, WhatsApp, Telegram, X, HTTP, Slack, …).

* **AI:** Extract Fields, Custom Prompt
* **Time:** Delay For / Until, Get Current Date and Time, Convert Timezone, Format
* **Logic:** Condition, Filter, Switch, Random, Stop, Note, Set variable, Run Code, **Loop on Items**
* **Contacts:** Create/Update, Get by phone, List, Add tags/attributes
* **Calls:** Call Phone Number
* **Messaging:** SMS, correo del espacio de trabajo, **Send Email (SMTP)** a través de una conexión SMTP guardada, mensajes de canal en conversaciones abiertas, y plantillas de WhatsApp aprobadas a números E.164. El generador muestra qué acciones usan créditos de mensajería del espacio de trabajo.
* **Knowledge:** Add / Delete / Get source
* **HTTP / webhooks:** HTTP Request, Incoming Webhooks de Slack / Discord / Teams, **Webhook respond** (sincroniza el estado/cuerpo HTTP de los webhooks entrantes)
* **CRM / SMTP / MCP connections:** credenciales reutilizables en **Automations → Connections**. **Test Connection** verifica un relay SMTP y envía un mensaje de prueba a la dirección configurada. Las integraciones disponibles aparecen en el selector de conexiones.
* **Connected apps (Beta):** elige **Browse apps** en Connections para conectar una app disponible. Sus herramientas y activadores compatibles aparecen en el generador después de conectarla. Requiere **Beta Features** en el espacio de trabajo.
* **Airtable actions:** List, **Find record**, **Search records**, **Find or create**, Get by id, Create / Create records (lote ≤10), Update, Delete.
* **MCP:** Call tool — conexión + selección múltiple de herramientas (o todas) + prompt del agente con variables flash; el agente elige la herramienta y completa los argumentos
* **Variables:** Return variables (para `call.variables`)

Consulta la [referencia de nodos de automatización](/es/automations/nodes) para conocer los campos y el comportamiento exactos de cada activador y acción.

## Ejemplos de automatizaciones

Un activador y un par de acciones suelen ser suficientes:

| Objetivo                           | Activador         | Pasos                                                                                                        |
| ---------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------ |
| Hacer seguimiento tras una llamada | On Call Completed | **Condition** sobre el resultado de la llamada → **Send WhatsApp Template** (o SMS) con los siguientes pasos |
| Saludar a un contacto nuevo        | Contact created   | **Send WhatsApp Template**, o **Call Phone Number** para iniciar una llamada de calificación                 |
| Recordar una reserva               | Booking created   | **Delay Until** el día anterior → **Send WhatsApp Template** con la hora de la cita                          |

<Tip>
  Empieza con un activador y una acción, confirma que se comporta como esperas y luego añade ramificaciones. Haz referencia a los datos del activador y de los pasos (`{{data.call_id}}` del activador, `{{steps.step1.output}}` de un paso anterior) en lugar de fijar valores directamente, ramifica con **Condition**/**Filter** en lugar de asumir que una llamada externa siempre tiene éxito, y usa **Run test** en cada paso mientras construyes — se ejecuta de verdad contra la app conectada y rellena Insert Variable con la salida real.
</Tip>

## Organización de automatizaciones

Las automatizaciones admiten **tags** libres para filtrar y muestran el **asistente** seleccionado cuando un activador es específico de un asistente. Créalas o actualízalas desde la interfaz, `POST/PATCH /api/v1/automations`, o MCP (`create_automation` / `update_automation`).

## Ejecuciones y alertas de fallos

La página de listado tiene las pestañas **Automations** y **Runs**. Usa **Alert settings** para definir una bandeja de entrada del espacio de trabajo para las ejecuciones fallidas y activar o desactivar las alertas.

Cuando no hay un correo personalizado configurado, las alertas van a los destinatarios de soporte configurados del espacio de trabajo y a los propietarios o administradores. Puedes activar o desactivar las alertas de fallos para cada automatización.

## Llamar a una automatización desde una conversación

Un asistente puede llamar a una automatización como si fuera una herramienta mientras la conversación todavía está en curso, no solo cuando termina. En **Assistant → Settings → Automations → During conversation**, crea una automatización invocable por el asistente y describe, en lenguaje natural, cuándo debería usarla el asistente — un campo de texto libre que el asistente lee antes de decidir si la llama. El vínculo se conecta automáticamente; construye los pasos de la automatización, mapea su respuesta y luego cambia la automatización a **Live**, ya que el asistente solo llama a automatizaciones que están en Live.

Esto funciona igual en conversaciones de voz, chat web, mensajería y correo, y un asistente puede tener más de una automatización invocable, cada una con su propia descripción. Crear o desvincular una es una acción de propietario o administrador. Es independiente de **On Call Completed** y de los activadores entrantes anteriores, que se disparan fuera de la conversación en lugar de ser llamados por el propio asistente.

## Enlace de webhook del asistente

En la tarjeta de Webhook del asistente, elige la entrega **Automation** y selecciona una automatización **On Call Completed**, o conserva una URL HTTPS personalizada.

## Solución de problemas

**Un paso de WhatsApp no envía.** **WhatsApp Send Message** solo funciona dentro de una conversación ya abierta (la ventana de servicio de 24 horas de Meta). Para llegar a alguien fuera de ella, usa en su lugar **Send WhatsApp Template**, y confirma que esa plantilla ya está aprobada para el remitente que elegiste. Consulta [WhatsApp](/es/channels/whatsapp#la-ventana-de-24-horas-y-las-plantillas) para conocer la ventana completa y las reglas de aprobación.

**Un paso falla con un número no válido.** Las acciones esperan E.164 (`+<código de país><número>`) — añade un código de país antes de pasar un número en formato nacional.

**Un paso de conector falla en cada ejecución.** Lo más probable es que la conexión subyacente esté desconectada o que su token haya caducado. Vuelve a conectarla en **Automations → Connections**.