---

Elenca tutte le Automazioni

Le automazioni in Blue ti permettono di creare flussi di lavoro potenti che attivano azioni basate su eventi specifici. Questo endpoint recupera tutte le automazioni configurate per il tuo progetto, inclusi i loro trigger, azioni e stato attuale.

Esempio di Base

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

Esempio Avanzato

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
  }
}

Parametri di Input

AutomationFilterInput

Parametro	Tipo	Richiesto	Descrizione
customFieldIds	[String]	No	Filtra le automazioni relative a specifici campi personalizzati

Parametri di Paginazione

Parametro	Tipo	Richiesto	Descrizione
skip	Int	No	Numero di elementi da saltare (predefinito: 0)
take	Int	No	Numero di elementi da restituire (predefinito: 20)

Campi di Risposta

AutomationPagination

Campo	Tipo	Descrizione
items	[Automation!]!	Elenco di oggetti automazione
pageInfo	PageInfo!	Informazioni sulla paginazione
totalCount	Int!	Numero totale di automazioni

Automation

Campo	Tipo	Descrizione
id	ID!	Identificatore unico
trigger	AutomationTrigger!	L'evento che attiva questa automazione
actions	[AutomationAction!]!	Azioni eseguite quando attivato
isActive	Boolean!	Se l'automazione è attualmente attiva
createdBy	User!	Utente che ha creato l'automazione
project	Project!	Progetto a cui appartiene questa automazione
createdAt	DateTime!	Timestamp di creazione
updatedAt	DateTime!	Timestamp dell'ultimo aggiornamento

AutomationTrigger

Campo	Tipo	Descrizione
id	ID!	Identificatore unico
type	AutomationTriggerType!	Tipo di evento trigger
color	String	Colore associato (formato esadecimale)
metadata	AutomationTriggerMetadata	Configurazione specifica del trigger
customField	CustomField	Campo personalizzato correlato (se applicabile)
customFieldOptions	[CustomFieldOption!]	Opzioni selezionate per i campi di selezione
todos	[CustomFieldReferenceTodo!]	Todo referenziati
todoList	TodoList	Elenco todo correlato
tags	[Tag!]	Tag correlati
assignees	[User!]	Assegnatari correlati

AutomationAction

Campo	Tipo	Descrizione
id	ID!	Identificatore unico
type	AutomationActionType!	Tipo di azione da eseguire
color	String	Colore associato (formato esadecimale)
duedIn	Int	Giorni da aggiungere per le azioni di scadenza
assigneeTriggerer	String	Identificatore speciale per l'assegnatario
metadata	AutomationActionMetadata	Configurazione specifica per l'azione
customField	CustomField	Campo personalizzato di destinazione
customFieldOptions	[CustomFieldOption!]	Opzioni per i campi di selezione
todoList	TodoList	Elenco todo di destinazione
tags	[Tag!]	Tag da aggiungere/rimuovere
assignees	[User!]	Assegnatari da aggiungere/rimuovere
httpOption	AutomationActionHttpOption	Configurazione della richiesta HTTP

Tipi di Trigger

Tipo	Descrizione
TODO_CREATED	Quando viene creato un nuovo record
TODO_LIST_CHANGED	Quando un record si sposta tra le liste
TODO_MARKED_AS_COMPLETE	Quando un record è completato
TODO_MARKED_AS_INCOMPLETE	Quando un record è non completato
ASSIGNEE_ADDED	Quando un assegnatario è aggiunto
ASSIGNEE_REMOVED	Quando un assegnatario è rimosso
DUE_DATE_CHANGED	Quando la data di scadenza è modificata
DUE_DATE_REMOVED	Quando la data di scadenza è cancellata
DUE_DATE_EXPIRED	Quando la data di scadenza passa
TAG_ADDED	Quando un tag è aggiunto
TAG_REMOVED	Quando un tag è rimosso
CHECKLIST_ITEM_MARKED_AS_DONE	Quando un elemento della checklist è completato
CHECKLIST_ITEM_MARKED_AS_UNDONE	Quando un elemento della checklist è non completato
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT	Quando un record è importato
CUSTOM_FIELD_ADDED	Quando il valore del campo personalizzato è impostato
CUSTOM_FIELD_REMOVED	Quando il valore del campo personalizzato è cancellato
CUSTOM_FIELD_BUTTON_CLICKED	Quando il campo del pulsante è cliccato
COLOR_ADDED	Quando il colore è applicato
COLOR_REMOVED	Quando il colore è rimosso

Tipi di Azione

Tipo	Descrizione
CHANGE_TODO_LIST	Sposta il record in un'altra lista
MARK_AS_COMPLETE	Completa il record
MARK_AS_INCOMPLETE	Non completare il record
ADD_ASSIGNEE	Aggiungi assegnatario(i)
REMOVE_ASSIGNEE	Rimuovi assegnatario(i)
ADD_ASSIGNEE_TRIGGERER	Aggiungi utente che ha attivato l'automazione
CHANGE_DUE_DATE	Imposta o aggiorna la data di scadenza
REMOVE_DUE_DATE	Cancella la data di scadenza
ADD_TAG	Applica tag(i)
REMOVE_TAG	Rimuovi tag(i)
ADD_COLOR	Applica colore
REMOVE_COLOR	Rimuovi colore
ADD_CUSTOM_FIELD	Imposta valore del campo personalizzato
REMOVE_CUSTOM_FIELD	Cancella valore del campo personalizzato
CREATE_CHECKLIST	Crea nuova checklist
MARK_CHECKLIST_ITEM_AS_DONE	Completa elementi della checklist
MARK_CHECKLIST_ITEM_AS_UNDONE	Non completare elementi della checklist
COPY_TODO	Duplica il record
SEND_EMAIL	Invia notifica email
GENERATE_PDF	Genera documento PDF
MAKE_HTTP_REQUEST	Chiama API esterna

Permessi Richiesti

Elencare le automazioni richiede autenticazione e accesso al progetto:

Ruolo	Può Elencare Automazioni
OWNER	✅ Sì
ADMIN	✅ Sì
MEMBER	✅ Sì
CLIENT	✅ Sì

Tutti gli utenti autenticati con accesso al progetto possono visualizzare le automazioni.

Risposte di Errore

Autenticazione Richiesta

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

Progetto Non Trovato

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

Note Importanti

• Ordinamento: Le automazioni vengono sempre restituite dalla più recente alla più vecchia (in base alla data di creazione)
• Ambito del Progetto: Le automazioni sono limitate al contesto del progetto attuale
• Stato Attivo: Controlla isActive per determinare se un'automazione è attualmente in esecuzione
• Metadati: Alcuni trigger e azioni hanno metadati aggiuntivi per la configurazione
• Prestazioni: Usa la paginazione per progetti con molte automazioni
• Filtraggio: Attualmente supporta solo il filtraggio per ID di campi personalizzati