> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatizaciones

> Automatice las partes repetitivas de la administración de propiedades - mensajes, creación de tareas, escalaciones y más

## Deje de hacer las mismas cosas una y otra vez

Todo administrador de propiedades tiene tareas que repite docenas de veces por semana: enviar instrucciones de check-in, crear tareas de limpieza después del checkout, notificar al equipo sobre un problema. Las automatizaciones se encargan de esto por usted - de manera confiable, cada vez.

***

## ¿Qué puede automatizar?

<CardGroup cols={2}>
  <Card title="Mensajes a huéspedes" icon="message">
    Envíe instrucciones de check-in, recordatorios de checkout, solicitudes de reseñas y seguimientos - programados automáticamente según cada reservación.
  </Card>

  <Card title="Creación de tareas" icon="clipboard-list" href="/es/platform/tasks">
    Cree [tareas](/es/platform/tasks) específicas por departamento cuando ocurran eventos específicos - como un checkout de huésped o una nueva reservación.
  </Card>

  <Card title="Alertas de escalación" icon="bell">
    Notifique a los gerentes inmediatamente cuando algo necesite atención humana - una queja, una solicitud de reembolso o una conversación que la IA no puede manejar.
  </Card>

  <Card title="Resúmenes operativos" icon="chart-bar">
    Envíe resúmenes programados de reservaciones, escalaciones y tareas que necesitan atención del equipo.
  </Card>

  <Card title="Notificaciones al equipo" icon="users">
    Alerte a su equipo cuando se asignen tareas, se escalen conversaciones o lleguen problemas urgentes.
  </Card>

  <Card title="Actualización de datos" icon="arrows-rotate">
    Actualice automáticamente registros, cambie estados o etiquete conversaciones basándose en condiciones que usted defina.
  </Card>
</CardGroup>

***

## Cómo funcionan las automatizaciones

Cada automatización tiene tres partes: un **disparador** (qué la inicia), **condiciones** opcionales (cuándo debe ejecutarse) y **acciones** (qué hace).

### Disparadores - qué inicia la automatización

<Tabs>
  <Tab title="Basado en eventos">
    La automatización se ejecuta cuando algo sucede en Trellis:

    * Se crea una nueva reservación
    * Un huésped hace check-in o checkout
    * Se escala una conversación
    * Se completa una tarea
    * Llega un nuevo mensaje

    Este es el tipo más común. Por ejemplo: "Cuando un huésped hace checkout, crear una tarea de limpieza."
  </Tab>

  <Tab title="Programado">
    La automatización se ejecuta en un horario recurrente:

    * Cada mañana a las 8 AM
    * Cada lunes a las 9 AM
    * Primero de cada mes

    Ideal para cosas como resúmenes diarios de tareas, listas del equipo, recordatorios de códigos de acceso o seguimientos periódicos.

    <Warning>
      Las automatizaciones programadas requieren una **zona horaria** en la configuración del disparador. Si su automatización usa valores de fecha u hora (como la fecha de hoy, la hora actual o fechas relativas como mañana), Trellis mostrará un error al guardar a menos que se configure una zona horaria. Esto garantiza que las fechas y horas se calculen correctamente para su ubicación.
    </Warning>
  </Tab>

  <Tab title="Manual">
    Usted inicia la automatización desde la interfaz de Trellis. Útil para flujos de trabajo que necesita ocasionalmente pero no automáticamente - como enviar masivamente un mensaje estacional a todos los próximos huéspedes.
  </Tab>
</Tabs>

### Condiciones - cuándo debe ejecutarse

Agregue condiciones para hacer sus automatizaciones más inteligentes. Por ejemplo:

* Solo crear una tarea de limpieza si el checkout es en una propiedad específica
* Solo enviar un mensaje de check-in si la reservación está confirmada (no cancelada)
* Solo escalar si el huésped ha mencionado una palabra clave específica

Las condiciones le permiten construir una automatización que maneja múltiples escenarios de manera inteligente.

### Acciones - qué hace

Las acciones son los pasos que toma su automatización. Puede encadenar múltiples acciones juntas:

| Acción                       | Qué hace                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Enviar un mensaje**        | Enviar un mensaje con plantilla a un huésped, propietario o proveedor a través de cualquier canal                   |
| **Crear una tarea**          | Crear una tarea específica por departamento con todos los detalles pre-llenados                                     |
| **Actualizar un registro**   | Cambiar el estado, asignado o cualquier campo en una propiedad, reservación, tarea o conversación                   |
| **Notificar a su equipo**    | Enviar una notificación a miembros específicos del equipo o roles                                                   |
| **Esperar**                  | Pausar la automatización por un tiempo determinado, hasta una fecha específica o hasta que algo suceda              |
| **Pedir aprobación**         | Pausar y pedir a un gerente que revise antes de continuar - perfecto para acciones de alto impacto                  |
| **Ejecutar el agente de IA** | Hacer que el [agente de IA](/es/platform/ai-agent) analice una situación, redacte una respuesta o tome una decisión |

<Tip>
  Cuando agrega un paso de **agente de IA** con salida estructurada, Trellis valida su configuración antes de guardar. Verifica que los valores de tiempo de espera sean suficientemente largos, que cualquier contexto referenciado esté disponible y que las variables de bucle solo se usen dentro de bucles. Corrija cualquier advertencia para evitar fallas inesperadas en tiempo de ejecución.
</Tip>

***

## Aprobación humana en el flujo

Algunas automatizaciones no deberían ejecutarse completamente en piloto automático. El paso de **aprobación** pausa el flujo de trabajo y pide a un miembro del equipo que revise antes de continuar.

<Steps>
  <Step title="La automatización llega al paso de aprobación">
    El flujo de trabajo se pausa y crea una solicitud de aprobación visible en su [bandeja de entrada](/es/platform/inbox).
  </Step>

  <Step title="Se notifica al revisor">
    El revisor asignado recibe una notificación con todo el contexto que necesita para tomar una decisión.
  </Step>

  <Step title="Aprobar o rechazar">
    El revisor aprueba la acción (y la automatización continúa) o la rechaza (y la automatización se detiene o toma un camino alternativo).
  </Step>
</Steps>

**Cuándo usar aprobaciones:**

* Antes de enviar mensajes sobre temas sensibles (reembolsos, cambios de política)
* Antes de crear tareas de mantenimiento costosas
* Antes de enviar mensajes que incluyan datos financieros sensibles
* Cuando quiera un punto de control humano en un flujo por lo demás automático

***

## Comenzando con plantillas

No necesita construir automatizaciones desde cero. Trellis viene con plantillas pre-construidas para los flujos de trabajo más comunes de administración de propiedades:

<AccordionGroup>
  <Accordion title="Mensaje de check-in al huésped">
    **Disparador:** 24 horas antes del check-in
    **Acción:** Enviar al huésped sus instrucciones de check-in, incluyendo dirección de la propiedad, código de puerta, contraseña de Wi-Fi, información de estacionamiento y reglas de la casa. Los detalles de la propiedad se extraen automáticamente.
  </Accordion>

  <Accordion title="Tarea de limpieza de checkout">
    **Disparador:** El huésped hace checkout
    **Acción:** Crear una tarea de limpieza para la propiedad, asignarla al miembro del equipo de limpieza predeterminado, adjuntar la lista de verificación estándar de rotación y establecer la fecha de vencimiento para el mismo día.
  </Accordion>

  <Accordion title="Notificación de escalación">
    **Disparador:** Se escala una conversación (por la IA o manualmente)
    **Acción:** Enviar una notificación inmediata al gerente de turno con el resumen de la conversación, detalles del huésped y un enlace a la conversación.
  </Accordion>

  <Accordion title="Resumen operativo diario">
    **Disparador:** Cada mañana
    **Acción:** Enviar a su equipo un resumen de reservaciones, escalaciones abiertas y tareas que necesitan atención ese día.
  </Accordion>

  <Accordion title="Solicitud de reseña">
    **Disparador:** 1 día después del checkout
    **Acción:** Enviar al huésped un mensaje amigable agradeciéndole su estancia y pidiéndole que deje una reseña. Solo se envía si no se escalaron problemas durante su estancia.
  </Accordion>

  <Accordion title="Alerta de mantenimiento desde mensaje del huésped">
    **Disparador:** La IA detecta un problema de mantenimiento en un mensaje del huésped
    **Acción:** Crear una tarea de mantenimiento, asignarla a la persona de mantenimiento de guardia y notificar al administrador de la propiedad.
  </Accordion>
</AccordionGroup>

***

## Construyendo su propia automatización

El constructor de automatizaciones usa un lienzo visual donde puede ver todo su flujo de trabajo de un vistazo. Una barra lateral colapsable a la izquierda le permite alternar entre su lista de flujos de trabajo y el lienzo, dándole más espacio para trabajar cuando lo necesite.

<Steps>
  <Step title="Ir a Automatizaciones">
    Navegue a **Automatizaciones** en la barra lateral izquierda y haga clic en **Nueva automatización**.
  </Step>

  <Step title="Elegir un disparador">
    Seleccione qué inicia su automatización - un evento (como un checkout), un horario (como cada lunes) o activación manual. Haga clic en el nodo del disparador en el lienzo para configurarlo en el panel de detalle.
  </Step>

  <Step title="Agregar condiciones (opcional)">
    Reduzca cuándo debe ejecutarse la automatización. Por ejemplo, solo para propiedades específicas, fuentes de reservación o tipos de huéspedes.
  </Step>

  <Step title="Agregar acciones">
    Defina qué debe hacer la automatización. Agregue tantos pasos como necesite - enviar un mensaje, crear una tarea, esperar, notificar y más. Haga clic en cualquier paso del lienzo para abrir su panel de detalle y configurarlo. Los pasos se ejecutan en orden.
  </Step>

  <Step title="Ejecutar ahora o activar">
    Cuando esté listo, haga clic en **Ejecutar ahora** para ejecutar la automatización inmediatamente, o actívela para ejecución automática. Use las pestañas de **Constructor**, **Ejecuciones** y **Versiones** en la parte superior para alternar entre diseñar, monitorear y revisar versiones anteriores de su automatización.
  </Step>
</Steps>

<Tip>
  Trellis valida su flujo de trabajo cuando lo guarda. Si un paso de condición o transformación hace referencia a una entrada que no ha sido declarada, o si una automatización programada usa valores de fecha y hora sin una zona horaria configurada, verá un error inmediatamente - para que pueda corregir el problema antes de que el flujo de trabajo se ejecute.
</Tip>

<Warning>
  Siempre pruebe una nueva automatización con una sola propiedad o reservación antes de implementarla en todo su portafolio. Esto le ayuda a detectar problemas antes de que afecten a los huéspedes.
</Warning>

***

## Monitoreo de ejecuciones de automatización

Después de que una automatización se ejecuta, puede revisar exactamente qué pasó desde la pestaña de **Ejecuciones**. Cada ejecución muestra su estado, los pasos que completó y cualquier error que ocurrió.

### Vistas de lista y calendario

La pestaña de ejecuciones ofrece dos formas de ver su historial de automatizaciones:

* **Vista de lista** - la tabla predeterminada que muestra cada ejecución como una fila con estado, progreso de pasos, tipo de disparador y marcas de tiempo. La lista muestra por defecto las ejecuciones de los últimos 7 días para que vea la actividad reciente primero. Ajuste el rango de fechas en cualquier momento usando el calendario en línea. Ideal para escanear actividad reciente y filtrar por estado.
* **Vista de calendario** - un calendario mensual que traza las ejecuciones por fecha. Cambie a esta vista usando el interruptor en la parte superior de la lista de ejecuciones. Use las flechas izquierda y derecha para navegar entre meses, y haga clic en cualquier día para ver las ejecuciones de esa fecha.

<Tip>
  La vista de calendario es especialmente útil para automatizaciones programadas. De un vistazo puede confirmar que sus flujos de trabajo diarios o semanales se ejecutan en los días esperados - y detectar brechas donde se perdió una ejecución.
</Tip>

### Filtrado de ejecuciones

Use las opciones de filtro en la parte superior de la lista de ejecuciones para encontrar ejecuciones específicas rápidamente. Los filtros se aplican tanto a la vista de lista como a la de calendario:

* **Estado** - filtre por ejecuciones en cola, en ejecución, completadas, fallidas o canceladas usando las pestañas de estado
* **Rango de fechas** - elija una fecha de inicio y fin usando el calendario en línea. Por defecto, se muestran las ejecuciones de los últimos 7 días.
* **Tipo de disparador** - muestre solo ejecuciones iniciadas por un disparador específico (evento, horario o manual)
* **Ejecución de prueba** - muestre u oculte ejecuciones de prueba (marcadas con un ícono de matraz) para que pueda enfocarse en ejecuciones reales o revisar resultados de prueba por separado

### Detalles de la ejecución

Haga clic en cualquier ejecución para ver un desglose paso a paso en el lienzo. Cada paso muestra si tuvo éxito, falló o fue omitido, junto con su resultado. Una columna de **Progreso de pasos** en la lista de ejecuciones le da un resumen visual rápido de qué tan lejos llegó cada ejecución antes de completarse o encontrar un error.

Un panel lateral de detalle se abre junto al lienzo para que pueda inspeccionar cada paso sin perder de vista el flujo de trabajo completo.

#### Resúmenes de pasos

Haga clic en un paso del lienzo para abrir su resumen en el panel lateral. Cada tipo de paso muestra información adaptada a lo que hace:

* **Pasos de trigger** - muestran el tipo de disparador (manual, basado en evento, iniciado por IA o programado) y el evento que inició la ejecución
* **Pasos de condición** - indican si la condición se evaluó como verdadera o falsa con una insignia clara
* **Pasos de acción** - listan las entidades que el paso afectó, como reservaciones, tareas, propiedades o contactos
* **Pasos de ciclo** - muestran las entidades siendo iteradas y cuántos elementos se procesaron

#### Entidades relacionadas

Cuando un paso involucra reservaciones, tareas, propiedades o contactos, el panel lateral muestra filas de entidades clicables con detalles clave a simple vista - por ejemplo, una fila de reservación muestra el nombre del huésped y las fechas de check-in/check-out. Haga clic en cualquier fila de entidad para ir directamente a ese registro en Trellis.

#### Pestaña de detalles

Cambie a la pestaña **Detalles** en el panel lateral para ver información de ejecución más profunda para cualquier paso. Para pasos que usan el agente de IA, esta pestaña incluye tiempos de respuesta y una línea de tiempo en lenguaje claro de lo que hizo el agente. Un registro de ejecución a nivel de run en la parte inferior muestra cada paso en orden cronológico, facilitando revisar la secuencia completa de eventos.

### Panel lateral de detalle de la ejecución

Cuando ve una ejecución, un panel lateral de detalle se abre junto al lienzo. Le da una imagen completa de lo que sucedió sin salir de la página.

**Pestaña Resumen**

La pestaña Resumen muestra de un vistazo lo que la automatización tocó:

* **Filas de entidades** - reservaciones, tareas, propiedades y contactos involucrados en la ejecución se listan como filas clicables. Cada fila muestra detalles clave (como nombre del huésped, fechas de check-in y check-out para una reservación, o título y estado de la tarea) para que pueda identificar rápidamente los registros afectados y hacer clic para ver más.
* **Resumen del trigger** - vea qué inició la ejecución: un disparador manual, una ejecución programada, un disparador basado en evento o una acción iniciada por IA.
* **Resultados paso a paso** - cada paso muestra su insignia de tipo, nombre, duración y resultado. Los pasos de condición muestran si se evaluaron como verdaderos o falsos. Los pasos de ciclo listan las entidades sobre las que iteraron.

**Pestaña Detalles**

La pestaña Detalles proporciona información de revisión más profunda para cada paso:

* **Registro de ejecución** - una lista cronológica de cada paso en la ejecución, con marcas de tiempo y duraciones, para que pueda ver el orden exacto de ejecución.
* **Tiempos del paso** - para pasos impulsados por IA, el panel lateral muestra tiempos de respuesta y detalles de estado. Esto le ayuda a entender dónde se gasta el tiempo y si un paso necesita ajustes.

<Tip>
  Los detalles del paso se cargan bajo demanda - solo se obtienen cuando expande un paso en la pestaña Detalles, manteniendo el panel lateral rápido incluso para ejecuciones con muchos pasos.
</Tip>

### Solución de errores en pasos

Cuando un paso falla, Trellis muestra los detalles del error directamente en el lienzo. Dos acciones están disponibles en cada paso fallido para ayudarle a resolver el problema rápidamente:

* **Pedir a la IA que corrija** - Trellis analiza el error, explica qué salió mal en lenguaje simple y sugiere una corrección. En muchos casos puede aplicar la corrección automáticamente, para que pueda volver a ejecutar la automatización sin profundizar en los detalles.
* **Reportar problema** - Si el error parece un bug o algo que no puede resolver por su cuenta, haga clic para abrir un diálogo de retroalimentación que está pre-llenado como reporte de error con los detalles ya adjuntos. Envíelo directamente al equipo de soporte de Trellis - sin necesidad de copiar mensajes de error o describir qué salió mal manualmente.

<Tip>
  Pruebe primero **Pedir a la IA que corrija** - resuelve la mayoría de los problemas de configuración instantáneamente, como una referencia de campo faltante o una condición incorrecta. Use **Reportar problema** cuando el error esté fuera de su control o siga ocurriendo después de una corrección.
</Tip>

### Notificaciones de falla de ejecución

Cuando una ejecución de automatización falla, Trellis notifica automáticamente a todos los miembros del espacio de trabajo para que su equipo pueda responder rápidamente. Las notificaciones de falla aparecen en la **campana de notificaciones** en la barra de navegación superior.

Haga clic en una notificación de falla para ir directamente a la vista de detalle de la ejecución fallida, donde puede ver exactamente qué paso falló y usar las herramientas de solución de problemas descritas anteriormente.

<Info>
  Las notificaciones de falla se envían a todos los miembros del espacio de trabajo. No necesita configurar nada - están habilitadas automáticamente para cada automatización.
</Info>

***

## Cancelación de una automatización en ejecución

Si una automatización está actualmente en ejecución y necesita detenerla - por ejemplo, si se activó por error o las condiciones han cambiado - puede cancelarla directamente desde la vista de detalle de la ejecución. Haga clic en el botón **Cancelar** en el encabezado de la ejecución. Aparece un diálogo de confirmación para asegurarse de que tenía la intención de detener la ejecución. Una vez cancelada, la ejecución se marca con un estado de cancelada y no se ejecutan más pasos.

***

## Gestión masiva de automatizaciones

Seleccione múltiples automatizaciones de la lista para habilitarlas, deshabilitarlas o eliminarlas en un solo paso. Esto es útil cuando necesita pausar todas las automatizaciones para una temporada, limpiar flujos de trabajo antiguos o activar rápidamente un conjunto de automatizaciones para un nuevo grupo de propiedades.

***

## Consejos para excelentes automatizaciones

<CardGroup cols={2}>
  <Card title="Comience con las plantillas" icon="rocket">
    Las plantillas están probadas en batalla y cubren los flujos de trabajo más comunes. Personalícelas para que coincidan con su operación en lugar de construir desde cero.
  </Card>

  <Card title="Use pasos de aprobación para acciones de alto impacto" icon="shield-check">
    Los mensajes sobre reembolsos, cambios de política o datos financieros siempre deben tener un paso de revisión humana.
  </Card>

  <Card title="Superponga condiciones para precisión" icon="filter">
    Cuanto más específicas sean sus condiciones, más inteligentes serán sus automatizaciones. Una automatización de limpieza de checkout que solo se activa para estancias confirmadas evita tareas innecesarias por cancelaciones.
  </Card>

  <Card title="Revise los registros de automatización regularmente" icon="clock-rotate-left">
    Revise el historial de ejecuciones para asegurarse de que sus automatizaciones funcionan como se esperaba. Busque ejecuciones omitidas o errores que necesiten atención.
  </Card>

  <Card title="Use ejecuciones de prueba para probar de forma segura" icon="flask">
    Ejecute su automatización en modo de prueba antes de activarla. Las ejecuciones de prueba están claramente marcadas con un ícono de matraz para que pueda distinguirlas de las ejecuciones reales.
  </Card>

  <Card title="Filtre ejecuciones para encontrar problemas rápido" icon="magnifying-glass">
    Use los filtros de estado, fecha y tipo de disparador en la pestaña de Ejecuciones para reducir rápidamente las ejecuciones fallidas o inesperadas.
  </Card>
</CardGroup>
