Jak zintegrować SimpleBoard z innymi systemami

Kiedy warto integrować?

Ręczne przepisywanie zadań z jednego systemu do drugiego to jedna z najbardziej kosztownych czynności w pracy biurowej. Zajmuje czas, generuje błędy i frustruje ludzi, którzy mają do wykonania rzeczy ważniejsze niż kopiowanie tytułów zgłoszeń. Jeśli Twoje zadania rodzą się w innym systemie — helpdesku, CRM, formularzu kontaktowym, repozytorium kodu — możesz sprawić, żeby trafiały do SimpleBoard automatycznie.

W tym artykule pokazujemy cztery konkretne scenariusze integracji z przykładami gotowymi do użycia.

Jak to działa

SimpleBoard oferuje dwa mechanizmy integracji, które wzajemnie się uzupełniają:

• API (REST) — Ty wywołujesz SimpleBoard. Chcesz stworzyć kartę, przenieść zadanie, pobrać raport — wysyłasz żądanie HTTP i dostajesz odpowiedź. To model pull: inicjatywa leży po Twojej stronie.
• Webhooki — SimpleBoard wywołuje Ciebie. Gdy w SimpleBoard coś się zmieni (karta utworzona, przeniesiona, ukończona), system wysyła zdarzenie na Twój endpoint. To model push: reagujesz na zdarzenia w czasie rzeczywistym.

W praktyce najciekawsze integracje łączą oba mechanizmy: zdarzenie z zewnętrznego systemu trafia do Ciebie jako webhook, a Ty odpowiadasz wywołaniem API SimpleBoard.

System zgłoszeń serwisowych

Scenariusz: Klient zgłasza problem przez helpdesk. Chcesz, żeby zgłoszenie automatycznie pojawiło się jako karta w kolumnie "Do zrobienia" na tablicy serwisowej.

Schemat działania: helpdesk wysyła webhook do Twojego skryptu przy każdym nowym zgłoszeniu. Skrypt wywołuje SimpleBoard API i tworzy kartę. Poniżej przykład wywołania API:

curl -X POST https://api.simpleboard.pl/v1/boards/brd_01j9xk2m/cards \
  -H "Authorization: Bearer TWÓJ_KLUCZ_API" \
  -H "Content-Type: application/json" \
  -d '{"title": "Zgłoszenie #4821", "column_id": "col_todo"}'

Karta pojawia się na tablicy w ciągu sekund od złożenia zgłoszenia. Możesz też przekazać dodatkowe dane — opis, etykietę, przypisaną osobę — przez rozbudowanie ciała żądania o pola description, labels i assignee_id.

CRM — nowy klient = nowa tablica

Scenariusz: Sprzedawca oznacza deal jako "Wygrany" w CRM. Chcesz, żeby automatycznie powstała nowa tablica dla tego klienta z gotowym zestawem kart dla procesu onboardingu.

CRM wysyła webhook przy zmianie statusu. Twój skrypt odbiera zdarzenie, wywołuje POST /v1/boards, żeby utworzyć tablicę z nazwą klienta, a następnie serię wywołań POST /v1/boards/{id}/cards tworzących standardowe karty onboardingowe: "Podpisanie umowy", "Konfiguracja środowiska", "Szkolenie użytkowników", "Odbiór projektu".

Efekt: od momentu wygrania dealu cały zespół ma gotową tablicę roboczą, zanim ktokolwiek zdąży się przesiąść od spotkania sprzedażowego do biurka.

GitHub — merge = gotowe

Scenariusz: Pull request zostaje scalony z główną gałęzią. Chcesz, żeby odpowiadająca mu karta w SimpleBoard automatycznie przesunęła się do kolumny "Gotowe".

GitHub obsługuje webhooki natywnie — w ustawieniach repozytorium możesz skonfigurować endpoint, który dostanie zdarzenie pull_request przy każdym merge. Twój skrypt wyciąga numer PR z payloadu, wyszukuje kartę po etykiecie lub tytule zawierającym ten numer (np. "PR-412"), a następnie wywołuje PATCH /v1/cards/{id} z nowym column_id wskazującym na kolumnę "Gotowe".

Całość działa bez żadnej interakcji człowieka — deploy się skończy, a tablica już pokazuje aktualny stan.

Formularze kontaktowe

Scenariusz: Klient wypełnia formularz na Twojej stronie. Dane kontaktowe i opis wymagań mają automatycznie trafiać do tablicy sprzedażowej jako karta gotowa do obsługi przez handlowca.

To najprostszy scenariusz — formularz (Typeform, Tally, własny backend) wysyła dane na Twój endpoint, a Ty wywołujesz API SimpleBoard z tytułem karty, opisem i ewentualną etykietą "Inbound". Handlowiec otwiera tablicę rano i widzi wszystkie nowe leady z poprzedniej doby — żadnego przeszukiwania skrzynki mailowej.

Przykładowy payload webhooka SimpleBoard

Gdy konfigurujesz webhook wychodzący z SimpleBoard (np. żeby powiadamiać zewnętrzny system o zmianach), payload zdarzenia wygląda tak:

{
  "event": "card.created",
  "card_id": "crd_xyz123",
  "card_title": "Zgłoszenie #4821 — brak dostępu do konta",
  "board_id": "brd_01j9xk2m",
  "column_id": "col_todo"
}

Każde zdarzenie zawiera typ (event), identyfikatory zasobów i metadane. Pełna lista zdarzeń dostępna w dokumentacji API.

Jak zacząć

Trzy kroki do pierwszej integracji:

• 1. Wygeneruj klucz API — przejdź do Ustawienia → API → Nowy klucz. Nadaj mu opisową nazwę i wybierz zakres uprawnień.
• 2. Przeczytaj dokumentację API — pełna specyfikacja endpointów, parametrów i odpowiedzi dostępna na /api-reference. Możesz testować żądania bezpośrednio w przeglądarce.
• 3. Skonfiguruj webhooki — jeśli chcesz reagować na zdarzenia w SimpleBoard, przejdź do Ustawienia → Webhooki i dodaj swój endpoint.