---

Listar todas las Automatizaciones

Las automatizaciones en Blue te permiten crear flujos de trabajo potentes que desencadenan acciones basadas en eventos específicos. Este endpoint recupera todas las automatizaciones configuradas para tu proyecto, incluyendo sus desencadenadores, acciones y estado actual.

Ejemplo Básico

query ListAutomations {
  automationList {
    items {
      id
      isActive
      trigger {
        type
        color
      }
      actions {
        type
        color
      }
      createdAt
    }
    pageInfo {
      totalItems
      hasNextPage
    }
  }
}

Ejemplo Avanzado

query ListAutomationsAdvanced {
  automationList(
    filter: {
      customFieldIds: ["field_123", "field_456"]
    }
    skip: 0
    take: 50
  ) {
    items {
      id
      isActive
      createdAt
      updatedAt
      
      # Trigger details
      trigger {
        id
        type
        color
        metadata {
          ... on AutomationTriggerMetadataTodoOverdue {
            incompleteOnly
          }
        }
        customField {
          id
          name
          type
        }
        customFieldOptions {
          id
          title
          color
        }
        todoList {
          id
          title
        }
        tags {
          id
          title
          color
        }
        assignees {
          id
          name
          email
        }
      }
      
      # Action details
      actions {
        id
        type
        color
        duedIn
        assigneeTriggerer
        
        # Action-specific fields
        customField {
          id
          name
        }
        customFieldOptions {
          id
          title
        }
        todoList {
          id
          title
        }
        tags {
          id
          title
        }
        assignees {
          id
          name
        }
        
        # Email action metadata
        metadata {
          ... on AutomationActionMetadataSendEmail {
            email {
              subject
              to
              from
              content
            }
          }
          ... on AutomationActionMetadataCreateChecklist {
            checklists {
              title
              checklistItems {
                title
                duedIn
              }
            }
          }
        }
      }
      
      # Creator info
      createdBy {
        id
        name
        email
      }
    }
    
    pageInfo {
      totalItems
      totalPages
      hasNextPage
      hasPreviousPage
    }
    
    totalCount
  }
}

Parámetros de Entrada

AutomationFilterInput

Parámetro	Tipo	Requerido	Descripción
customFieldIds	[String]	No	Filtrar automatizaciones relacionadas con campos personalizados específicos

Parámetros de Paginación

Parámetro	Tipo	Requerido	Descripción
skip	Int	No	Número de elementos a omitir (predeterminado: 0)
take	Int	No	Número de elementos a devolver (predeterminado: 20)

Campos de Respuesta

AutomationPagination

Campo	Tipo	Descripción
items	[Automation!]!	Lista de objetos de automatización
pageInfo	PageInfo!	Información de paginación
totalCount	Int!	Número total de automatizaciones

Automation

Campo	Tipo	Descripción
id	ID!	Identificador único
trigger	AutomationTrigger!	El evento que desencadena esta automatización
actions	[AutomationAction!]!	Acciones realizadas cuando se activa
isActive	Boolean!	Si la automatización está actualmente activa
createdBy	User!	Usuario que creó la automatización
project	Project!	Proyecto al que pertenece esta automatización
createdAt	DateTime!	Marca de tiempo de creación
updatedAt	DateTime!	Marca de tiempo de última actualización

AutomationTrigger

Campo	Tipo	Descripción
id	ID!	Identificador único
type	AutomationTriggerType!	Tipo de evento desencadenante
color	String	Color asociado (formato hex)
metadata	AutomationTriggerMetadata	Configuración específica del desencadenador
customField	CustomField	Campo personalizado relacionado (si aplica)
customFieldOptions	[CustomFieldOption!]	Opciones seleccionadas para campos de selección
todos	[CustomFieldReferenceTodo!]	Tareas referenciadas
todoList	TodoList	Lista de tareas relacionada
tags	[Tag!]	Etiquetas relacionadas
assignees	[User!]	Asignados relacionados

AutomationAction

Campo	Tipo	Descripción
id	ID!	Identificador único
type	AutomationActionType!	Tipo de acción a realizar
color	String	Color asociado (formato hex)
duedIn	Int	Días a agregar para acciones de fecha de vencimiento
assigneeTriggerer	String	Identificador de asignado especial
metadata	AutomationActionMetadata	Configuración específica de la acción
customField	CustomField	Campo personalizado objetivo
customFieldOptions	[CustomFieldOption!]	Opciones para campos de selección
todoList	TodoList	Lista de tareas objetivo
tags	[Tag!]	Etiquetas a agregar/quitar
assignees	[User!]	Asignados a agregar/quitar
httpOption	AutomationActionHttpOption	Configuración de solicitud HTTP

Tipos de Desencadenadores

Tipo	Descripción
TODO_CREATED	Cuando se crea un nuevo registro
TODO_LIST_CHANGED	Cuando un registro se mueve entre listas
TODO_MARKED_AS_COMPLETE	Cuando un registro se completa
TODO_MARKED_AS_INCOMPLETE	Cuando un registro se descompleta
ASSIGNEE_ADDED	Cuando se añade un asignado
ASSIGNEE_REMOVED	Cuando se elimina un asignado
DUE_DATE_CHANGED	Cuando se modifica la fecha de vencimiento
DUE_DATE_REMOVED	Cuando se borra la fecha de vencimiento
DUE_DATE_EXPIRED	Cuando la fecha de vencimiento pasa
TAG_ADDED	Cuando se añade una etiqueta
TAG_REMOVED	Cuando se elimina una etiqueta
CHECKLIST_ITEM_MARKED_AS_DONE	Cuando se completa un elemento de la lista de verificación
CHECKLIST_ITEM_MARKED_AS_UNDONE	Cuando se descompleta un elemento de la lista de verificación
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT	Cuando se importa un registro
CUSTOM_FIELD_ADDED	Cuando se establece el valor de un campo personalizado
CUSTOM_FIELD_REMOVED	Cuando se borra el valor de un campo personalizado
CUSTOM_FIELD_BUTTON_CLICKED	Cuando se hace clic en el campo de botón
COLOR_ADDED	Cuando se aplica color
COLOR_REMOVED	Cuando se elimina color

Tipos de Acción

Tipo	Descripción
CHANGE_TODO_LIST	Mover registro a una lista diferente
MARK_AS_COMPLETE	Completar el registro
MARK_AS_INCOMPLETE	Descompletar el registro
ADD_ASSIGNEE	Añadir asignado(s)
REMOVE_ASSIGNEE	Eliminar asignado(s)
ADD_ASSIGNEE_TRIGGERER	Añadir usuario que desencadenó la automatización
CHANGE_DUE_DATE	Establecer o actualizar la fecha de vencimiento
REMOVE_DUE_DATE	Borrar fecha de vencimiento
ADD_TAG	Aplicar etiqueta(s)
REMOVE_TAG	Eliminar etiqueta(s)
ADD_COLOR	Aplicar color
REMOVE_COLOR	Eliminar color
ADD_CUSTOM_FIELD	Establecer valor de campo personalizado
REMOVE_CUSTOM_FIELD	Borrar valor de campo personalizado
CREATE_CHECKLIST	Crear nueva lista de verificación
MARK_CHECKLIST_ITEM_AS_DONE	Completar elementos de la lista de verificación
MARK_CHECKLIST_ITEM_AS_UNDONE	Descompletar elementos de la lista de verificación
COPY_TODO	Duplicar el registro
SEND_EMAIL	Enviar notificación por correo electrónico
GENERATE_PDF	Generar documento PDF
MAKE_HTTP_REQUEST	Llamar a API externa

Permisos Requeridos

Listar automatizaciones requiere autenticación y acceso al proyecto:

Rol	Puede Listar Automatizaciones
OWNER	✅ Sí
ADMIN	✅ Sí
MEMBER	✅ Sí
CLIENT	✅ Sí

Todos los usuarios autenticados con acceso al proyecto pueden ver las automatizaciones.

Respuestas de Error

Autenticación Requerida

{
  "errors": [{
    "message": "You must be logged in",
    "extensions": {
      "code": "UNAUTHENTICATED"
    }
  }]
}

Proyecto No Encontrado

{
  "errors": [{
    "message": "Project not found",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

Notas Importantes

• Ordenamiento: Las automatizaciones siempre se devuelven de más nuevas a más antiguas (por fecha de creación)
• Alcance del Proyecto: Las automatizaciones están limitadas al contexto del proyecto actual
• Estado Activo: Verifica isActive para determinar si una automatización está actualmente en ejecución
• Metadatos: Algunos desencadenadores y acciones tienen metadatos adicionales para la configuración
• Rendimiento: Utiliza paginación para proyectos con muchas automatizaciones
• Filtrado: Actualmente solo admite filtrado por IDs de campos personalizados