---

Daftar Semua Automasi

Automasi di Blue memungkinkan Anda untuk membuat alur kerja yang kuat yang memicu tindakan berdasarkan peristiwa tertentu. Endpoint ini mengambil semua automasi yang dikonfigurasi untuk proyek Anda, termasuk pemicu, tindakan, dan status saat ini.

Contoh Dasar

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

Contoh Lanjutan

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

Parameter Input

AutomationFilterInput

Parameter	Tipe	Diperlukan	Deskripsi
customFieldIds	[String]	Tidak	Menyaring automasi yang terkait dengan bidang kustom tertentu

Parameter Paginasi

Parameter	Tipe	Diperlukan	Deskripsi
skip	Int	Tidak	Jumlah item yang akan dilewati (default: 0)
take	Int	Tidak	Jumlah item yang akan dikembalikan (default: 20)

Bidang Respons

AutomationPagination

Bidang	Tipe	Deskripsi
items	[Automation!]!	Daftar objek automasi
pageInfo	PageInfo!	Informasi paginasi
totalCount	Int!	Jumlah total automasi

Automasi

Bidang	Tipe	Deskripsi
id	ID!	Pengidentifikasi unik
trigger	AutomationTrigger!	Peristiwa yang memicu automasi ini
actions	[AutomationAction!]!	Tindakan yang dilakukan saat dipicu
isActive	Boolean!	Apakah automasi saat ini aktif
createdBy	User!	Pengguna yang membuat automasi
project	Project!	Proyek tempat automasi ini berada
createdAt	DateTime!	Timestamp pembuatan
updatedAt	DateTime!	Timestamp pembaruan terakhir

AutomationTrigger

Bidang	Tipe	Deskripsi
id	ID!	Pengidentifikasi unik
type	AutomationTriggerType!	Tipe peristiwa pemicu
color	String	Warna terkait (format hex)
metadata	AutomationTriggerMetadata	Konfigurasi spesifik pemicu
customField	CustomField	Bidang kustom terkait (jika ada)
customFieldOptions	[CustomFieldOption!]	Opsi yang dipilih untuk bidang pilihan
todos	[CustomFieldReferenceTodo!]	Todo yang dirujuk
todoList	TodoList	Daftar todo terkait
tags	[Tag!]	Tag terkait
assignees	[User!]	Penugasan terkait

AutomationAction

Bidang	Tipe	Deskripsi
id	ID!	Pengidentifikasi unik
type	AutomationActionType!	Tipe tindakan yang akan dilakukan
color	String	Warna terkait (format hex)
duedIn	Int	Hari yang ditambahkan untuk tindakan tanggal jatuh tempo
assigneeTriggerer	String	Pengidentifikasi penugasan khusus
metadata	AutomationActionMetadata	Konfigurasi spesifik tindakan
customField	CustomField	Bidang kustom target
customFieldOptions	[CustomFieldOption!]	Opsi untuk bidang pilihan
todoList	TodoList	Daftar todo target
tags	[Tag!]	Tag yang akan ditambahkan/dihapus
assignees	[User!]	Penugasan yang akan ditambahkan/dihapus
httpOption	AutomationActionHttpOption	Konfigurasi permintaan HTTP

Tipe Pemicu

Tipe	Deskripsi
TODO_CREATED	Ketika catatan baru dibuat
TODO_LIST_CHANGED	Ketika catatan berpindah antar daftar
TODO_MARKED_AS_COMPLETE	Ketika catatan diselesaikan
TODO_MARKED_AS_INCOMPLETE	Ketika catatan tidak diselesaikan
ASSIGNEE_ADDED	Ketika penugasan ditambahkan
ASSIGNEE_REMOVED	Ketika penugasan dihapus
DUE_DATE_CHANGED	Ketika tanggal jatuh tempo dimodifikasi
DUE_DATE_REMOVED	Ketika tanggal jatuh tempo dihapus
DUE_DATE_EXPIRED	Ketika tanggal jatuh tempo telah lewat
TAG_ADDED	Ketika tag ditambahkan
TAG_REMOVED	Ketika tag dihapus
CHECKLIST_ITEM_MARKED_AS_DONE	Ketika item checklist diselesaikan
CHECKLIST_ITEM_MARKED_AS_UNDONE	Ketika item checklist tidak diselesaikan
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT	Ketika catatan diimpor
CUSTOM_FIELD_ADDED	Ketika nilai bidang kustom ditetapkan
CUSTOM_FIELD_REMOVED	Ketika nilai bidang kustom dihapus
CUSTOM_FIELD_BUTTON_CLICKED	Ketika tombol bidang diklik
COLOR_ADDED	Ketika warna diterapkan
COLOR_REMOVED	Ketika warna dihapus

Tipe Tindakan

Tipe	Deskripsi
CHANGE_TODO_LIST	Pindahkan catatan ke daftar yang berbeda
MARK_AS_COMPLETE	Selesaikan catatan
MARK_AS_INCOMPLETE	Tidak selesaikan catatan
ADD_ASSIGNEE	Tambahkan penugasan
REMOVE_ASSIGNEE	Hapus penugasan
ADD_ASSIGNEE_TRIGGERER	Tambahkan pengguna yang memicu automasi
CHANGE_DUE_DATE	Tetapkan atau perbarui tanggal jatuh tempo
REMOVE_DUE_DATE	Hapus tanggal jatuh tempo
ADD_TAG	Terapkan tag
REMOVE_TAG	Hapus tag
ADD_COLOR	Terapkan warna
REMOVE_COLOR	Hapus warna
ADD_CUSTOM_FIELD	Tetapkan nilai bidang kustom
REMOVE_CUSTOM_FIELD	Hapus nilai bidang kustom
CREATE_CHECKLIST	Buat checklist baru
MARK_CHECKLIST_ITEM_AS_DONE	Selesaikan item checklist
MARK_CHECKLIST_ITEM_AS_UNDONE	Tidak selesaikan item checklist
COPY_TODO	Duplikasi catatan
SEND_EMAIL	Kirim notifikasi email
GENERATE_PDF	Hasilkan dokumen PDF
MAKE_HTTP_REQUEST	Panggil API eksternal

Izin yang Diperlukan

Mendaftar automasi memerlukan autentikasi dan akses proyek:

Peran	Dapat Mendaftar Automasi
OWNER	✅ Ya
ADMIN	✅ Ya
MEMBER	✅ Ya
CLIENT	✅ Ya

Semua pengguna yang terautentikasi dengan akses proyek dapat melihat automasi.

Respons Kesalahan

Autentikasi Diperlukan

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

Proyek Tidak Ditemukan

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

Catatan Penting

• Pengurutan: Automasi selalu dikembalikan terbaru terlebih dahulu (berdasarkan tanggal pembuatan)
• Lingkup Proyek: Automasi terikat pada konteks proyek saat ini
• Status Aktif: Periksa isActive untuk menentukan apakah automasi saat ini sedang berjalan
• Metadata: Beberapa pemicu dan tindakan memiliki metadata tambahan untuk konfigurasi
• Kinerja: Gunakan paginasi untuk proyek dengan banyak automasi
• Penyaringan: Saat ini hanya mendukung penyaringan berdasarkan ID bidang kustom