Dokumentacja dla programistów

Sekwencje

Aktualizacja 2026-09-06

Sekwencje e-mail pozwalają zespołom automatyzować wieloetapowe procesy wysyłania wiadomości e-mail dotyczące elementów na tablicy.

Dostępne tylko w wersji API 2026-04 i nowszych


Zapytania

allowed_sequences_to_enroll

Zwraca sekwencje dostępne do zapisania na nie elementów z tablicy.

Argumenty

Argument Typ Opis
board_id ID! Tablica, dla której mają zostać wyświetlone sekwencje dostępne do zapisania.

Zwraca

[Sequence!] - szczegóły pól znajdziesz w sekcji Sequence.

Przykład

query {
  allowed_sequences_to_enroll(board_id: "1234567890") {
    id
    title
    status
    context_type
    context_id
    user_id
    step_count
    duration
    created_at
    updated_at
  }
}

Mutacje

enroll_items_to_sequence

Zapisuje elementy do sekwencji e-mail. W jednym żądaniu możesz zapisać maksymalnie 50 elementów.

Argumenty

Argument Typ Opis
input EnrollToSequenceInput! Zobacz EnrollToSequenceInput.

Zwraca

EnrollToSequenceResult - zawiera succeeded_item_ids i failed_item_ids.

Przykład

mutation {
  enroll_items_to_sequence(
    input: {
      sequence_id: "9876543210"
      board_id: "1234567890"
      item_ids: ["111", "222", "333"]
    }
  ) {
    succeeded_item_ids
    failed_item_ids
  }
}

Pola typu Sequence

Pole Typ Opis
id ID! Unikalny identyfikator sekwencji.
title String Tytuł wyświetlany użytkownikom.
status SequenceStatus Stan cyklu życia sekwencji.
context_type SequenceContext Kontekst, w którym ma zastosowanie sekwencja (np. tablica).
context_id ID Identyfikator kontekstu (np. identyfikator tablicy, gdy context_type ma wartość BOARD).
user_id ID Identyfikator użytkownika powiązanego z sekwencją.
step_count Int Liczba kroków w sekwencji.
duration Int Łączny czas trwania sekwencji.
created_at Date Data utworzenia sekwencji.
updated_at Date Data ostatniej aktualizacji sekwencji.

Typy danych wejściowych i wyników opisano w sekcji Inne typy.