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

# Automatizaciones

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

La página **Automatizaciones** (`/automations`) es el generador de flujos de trabajo nativo de tu espacio de trabajo. Crea gráficos de varios pasos con activadores, acciones, ejecuciones de prueba y un historial de ejecuciones completo.

Puerta de plan: `automation_platform`. Asignación mensual de ejecuciones **gratis**: `max_automation_runs` (`-1` = ilimitado gratis, `0` = sin ejecuciones gratis). Una vez agotada la cuota gratis, cada ejecución adicional debita `automation_run_credits` (base de la plataforma en `credit_settings`, precio de venta del tenant vía `tenants.credit_pricing`).

Los **pasos de IA** (Prompt personalizado, Extraer campos, MCP · Llamar herramienta) además debitan créditos del espacio de trabajo por el uso de tokens: precio de lista × **2,5** (costo del token + margen del **150 %**). Los créditos cobrados aparecen en la ejecución (`credits_charged`) y en la salida del paso o el panel de prueba.

**Fin del gráfico:** un nodo hoja sin conexión de salida completa la ejecución con éxito. Los terminales explícitos (`stop`, `variables.return`, `webhook.respond`) marcan `halt` y finalizan de inmediato — no se necesita ninguna conexión adicional (el lienzo oculta el conector de origen).

## Activadores

* **Llamada completada** — después de que termina una llamada de voz (con análisis). Requiere un **asistente específico**.
* **Llamada entrante** — cuando comienza una llamada entrante.
* **Inyectar variables de entrada** (`call.variables`) — al inicio de la llamada; reemplaza el webhook de variables del asistente. Termina con **Devolver variables**.
* **Correo recibido** — correo entrante vía SendGrid.
* **Conversación iniciada / finalizada** — canal de mensajería abierto / cerrado.
* **Webhook entrante** — `POST /api/automations/{id}/webhook`.
* **Reserva creada / cancelada / reprogramada**, **Manual**, **Programado** (próximamente).
* **Eventos de app (Beta)** — cada app conectada (Gmail, GitHub, …) aparece como plataforma propia con activadores basados en el esquema. Requiere **Beta Features**. Al activar se crea la instancia del activador.

## Acciones (plugins)

Organizadas como **Plataforma → tipo → acción** (Famulor, IA, Tiempo, WhatsApp, Telegram, X, HTTP, Slack, …).

* **IA:** Extraer campos, Prompt personalizado
* **Tiempo:** Retrasar por / hasta, Obtener fecha y hora actual, Convertir zona horaria, Formato
* **Lógica:** Condición, Filtro, Switch, Aleatorio, Detener, Nota, Establecer variable, Ejecutar código, **Bucle en elementos**
* **Contactos:** Crear/Actualizar, Obtener por teléfono, Listar, Agregar etiquetas/atributos
* **Llamadas:** Llamar a un número de teléfono
* **Mensajería:** SMS, Correo electrónico (canal del espacio de trabajo), **Enviar correo electrónico (SMTP)** mediante una conexión SMTP guardada, Mensaje de canal (WhatsApp / Telegram / X en conversaciones abiertas)
* **Base de conocimientos:** Agregar / Eliminar / Obtener fuente
* **HTTP / webhooks:** Solicitud HTTP, Webhooks entrantes de Slack / Discord / Teams, **Responder webhook** (sincroniza el estado/cuerpo HTTP para webhooks entrantes)
* **Conexiones CRM / SMTP / MCP:** credenciales reutilizables en Automatizaciones → Conexiones (Airtable, HubSpot, Salesforce, Close, SMTP, **Supabase / Neon / Brevo / Atlassian / Shopify Storefront MCP**, además de Notion/Stripe/GitHub/Linear/Slack MCP). Probar conexión, para SMTP, verifica el relay y envía un correo de prueba al administrador. Los ajustes preestablecidos oficiales de MCP que son **solo OAuth** en la documentación del proveedor (por ejemplo, ClickUp, Asana, inicio de sesión de PayPal) todavía no están disponibles: nuestro modelo de conexión necesita una clave Bearer/API para ejecuciones de automatización desatendidas.
* **Apps conectadas (Beta):** en Conexiones → **Explorar apps**, conecta toolkits por OAuth (búsqueda + scroll infinito del catálogo completo). En el builder, las plataformas de apps cargan primero metadatos paginados; herramientas/activadores por app al seleccionarlas (runtime: `composio.execute` / `composio.event`). Requiere la clave del conector y Beta Features. Los nodos nativos de CRM/SMS/MCP no cambian. El catálogo bulk (`/api/automations/composio/catalog`) solo calienta la página pedida (default 40, máx. 100) — preferir `toolkit=` o `/tools` + `/trigger-types` para lazy load.
* **Acciones de Airtable:** Listar, **Buscar registro**, **Buscar registros**, **Buscar o crear**, Obtener por ID, Crear / Crear registros (lote ≤10), Actualizar, Eliminar. Buscar registro/Buscar registros se implementan mediante Listar registros + `filterByFormula`.
* **MCP:** Llamar herramienta — 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:** Devolver variables (para `call.variables`)

## Organización

Las automatizaciones admiten **etiquetas** libres (para filtrar en la página de lista) y muestran el **asistente** vinculado cuando el activador usa `assistant_id`. Se crean o actualizan desde la interfaz, por REST (`tags` en `/api/v1/automations`) o por MCP (`create_automation` / `update_automation`).

## Ejecuciones y alertas de fallos

La página de lista tiene las pestañas **Automatizaciones** y **Ejecuciones**. Usa **Configuración de alertas** para definir una bandeja de entrada del espacio de trabajo para las ejecuciones fallidas (`tenants.automation_alert_email`) y para activar o desactivar las alertas (`automation_failure_alerts_enabled`).

Cuando no hay un correo personalizado configurado, las ejecuciones fallidas se notifican por correo a:

* **Espacios de trabajo de clientes de marca blanca** → el `support_email` del tenant-admin (además de los propietarios/administradores del espacio de trabajo)
* **Espacios de trabajo raíz de la plataforma** → el correo de contacto del administrador de la plataforma o el correo SMTP definido en `/admin/settings` (`welcome_email.contact_email`; si no, `smtp_settings.from_email`), además de los propietarios/administradores del espacio de trabajo

Se puede alternar por automatización: `notify_on_failure` (activado por defecto).

## Enlace del webhook del asistente

En la tarjeta Webhook del asistente, elige el envío por **Automatización** y selecciona una automatización de `call.completed`, o conserva una URL HTTPS personalizada.
