Integracje / Coda

Komunikacja, projekty i biuro

Integracja AI: Coda

Podłączamy się do Coda przez REST API v1 i czytamy strony, tabele oraz metadane modyfikacji z całego workspace. Asystent odpowiada na pytania z procedur, wskazuje dokumenty niezmieniane od roku i aktualizuje tabele danymi z innych systemów.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Rozmowa z asystentem AI w portalu redAi o danych z programu firmowego
Tak wygląda praca w portalu. Przykład na danych przykładowych.

W skrócie

Jak asystent AI łączy się z systemem Coda?

Łączymy się z Coda przez REST API v1 przy użyciu tokenu API generowanego w ustawieniach konta Coda (Account Settings, zakładka API Tokens). Token można skonfigurować tylko do odczytu albo z uprawnieniami do zapisu, gdy tabele mają być aktualizowane.

Na start potrzebujemy
Token API Coda z dostępem do workspace'u (plan darmowy wystarcza do samego odczytu).
Czego asystent nie robi
Nie usuwa ani nie archiwizuje stron w Coda bez potwierdzenia ze strony użytkownika.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie Coda włączamy dopiero wtedy, gdy sami tego chcecie.

Metadane stron workspace'u

CzytamyTytuł, identyfikator, ikona, poziom zagnieżdżenia w hierarchii i data ostatniej modyfikacji każdej strony.

AsystentBuduje mapę całej dokumentacji, wykrywa puste sekcje i generuje listę stron niemodyfikowanych od ponad roku.

Struktura i typy kolumn tabel

CzytamyNazwy kolumn, typy danych (tekst, data, lista wyboru, relacja do innej tabeli) oraz identyfikatory wierszy.

AsystentRozumie budowę tabeli przed aktualizacją, żeby trafić we właściwy wiersz i nie tworzyć duplikatów.

Tabele Projektów i Kontraktów

CzytamyWiersze z wartościami kolumn: klient, status, kwota, termin ważności, data ostatniej faktury i inne pola ustawione przez firmę.

AsystentPorównuje dane z systemem źródłowym i aktualizuje zmienione wiersze przez API bez angażowania człowieka.

Treść stron procedur

CzytamyPełna treść instrukcji: obsługa reklamacji, onboarding pracownika, kroki postępowania opisane kolejno.

AsystentOdpowiada na pytania pracowników z treści aktualnej procedury, cytując konkretne kroki zamiast wymyślać odpowiedź.

Pole updatedAt stron

CzytamyData ostatniej modyfikacji i identyfikator osoby, która edytowała stronę jako ostatnia.

AsystentFiltruje strony starsze niż 12 miesięcy i klasyfikuje je na prawdopodobnie nieaktualne lub wymagające weryfikacji.

Baza kontrahentów

CzytamyKolumny NIP, Waluta rozliczeń, Opiekun i inne pola identyfikujące kontrahenta w tabeli Coda.

AsystentOdpowiada na pytania o dane kontrahenta i wykrywa brakujące wpisy do uzupełnienia.

Tabela terminów umów

CzytamyKolumna z datą ważności kontraktu, etykiety statusu i powiązania z tabelą zadań dla sprzedawców.

AsystentCo tydzień sprawdza, które umowy wygasają w ciągu 30 dni, oznacza je etykietą i dopisuje do listy zadań zespołu.

Eksporty Craft do Markdown

CzytamyPliki Markdown z treścią stron i metadane pliku zawierające daty modyfikacji z folderu synchronizacji.

AsystentCzyta regulaminy i dokumenty strategiczne z eksportów i odpowiada na pytania bez konieczności dostępu do API Craft.

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Co robimy, kiedy klient chce zwrot po 30 dniach od zakupu?”
  • „Które procedury w Coda nikt nie zmieniał od ponad roku?”
  • „Jakie kontrakty mają termin odnowienia w ciągu najbliższych 30 dni?”
  • „Kiedy ostatnio ktoś aktualizował stronę z instrukcją reklamacji?”

Co się zmienia

Pracownicy przestają szukać procedur ręcznie, tabele Coda aktualizują się automatycznie z systemów źródłowych, a zakurzone dokumenty trafiają do właściwych osób do weryfikacji.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

Coda to środowisko pracy, w którym jeden dokument może zawierać tekst, tabele z formułami, przyciski uruchamiające akcje i widoki filtrowane dla różnych ról. Pod prostym interfejsem edytora kryje się relacyjna struktura z typami kolumn, powiązaniami między tabelami i możliwością budowania logiki bez instalowania osobnego oprogramowania.

Firmy korzystają z Coda do prowadzenia statusów projektów, baz kontrahentów, procedur operacyjnych i checklist onboardingu. Popularny w działach operacyjnych, sprzedaży i HR, gdzie dane muszą być dostępne dla całego zespołu z jednego miejsca. Dokumenty i tabele trzymane są w chmurze Coda, dostępnej z przeglądarki.

Gdzie to działa najlepiej

Pracownik obsługi klienta

Nowa osoba w dziale dostaje zgłoszenie o zwrocie po 30 dniach od zakupu. Nie zna procedury, bo jest drugi tydzień w pracy. Zamiast przerywać starszemu pracownikowi, wpisuje pytanie do asystenta.

Z asystentem: Asystent odpowiada z treści procedury obsługi reklamacji z Coda w kilka sekund, podając konkretne kroki postępowania dla tej sytuacji.

Menedżer działu sprzedaży

Poniedziałek rano, przegląd tygodnia. Menedżer chce wiedzieć, które kontrakty wygasają w tym miesiącu, żeby rozdysponować zadania między handlowców. Bez narzędzia musiałby przeglądać tabelę wiersz po wierszu.

Z asystentem: Asystent wyciąga z tabeli Kontrakty wszystkie wiersze z terminem ważności w ciągu 30 dni i dopisuje je do tabeli zadań z etykietą Do kontaktu.

Właściciel albo dyrektor

Firma ma ponad 150 stron dokumentacji w Coda. Nikt nie wie, które są aktualne, a które opisują procesy sprzed dwóch lat. Przed planowanym szkoleniem nowych pracowników właściciel prosi o audyt.

Z asystentem: Asystent pobiera daty modyfikacji wszystkich stron, filtruje niezmieniane ponad rok i klasyfikuje je. Wynik trafia do tabeli w Coda z przypisaniem stron do weryfikacji przez odpowiednie osoby.

Jak się łączymy

Łączymy się z Coda przez REST API v1 przy użyciu tokenu API generowanego w ustawieniach konta Coda (Account Settings, zakładka API Tokens). Token można skonfigurować tylko do odczytu albo z uprawnieniami do zapisu, gdy tabele mają być aktualizowane. Narzędzie działa na serwerze klienta i stamtąd wywołuje zapytania do API.

Dane z Craft pobieramy z folderu eksportów na serwerze klienta, gdzie Craft synchronizuje kopie zapasowe dokumentów jako pliki Markdown. Zapis do tabel Coda odbywa się przez endpoint PATCH, wyłącznie po zatwierdzeniu przez użytkownika albo przez automat z dokładnie określonym zakresem wierszy. Do modelu AI trafia polecenie i fragmenty dokumentów potrzebne do odpowiedzi.

Czego potrzebujemy od Was

  • Token API Coda z dostępem do workspace'u (plan darmowy wystarcza do samego odczytu).
  • Uprawnienia do zapisu w tokenie, jeśli tabele mają być aktualizowane automatycznie.
  • Kolumna z unikalnym identyfikatorem (np. NIP, numer zamówienia) w tabelach przeznaczonych do zapisu.
  • Osoba po stronie firmy, która zna strukturę dokumentów i wskaże sekcje do podłączenia.
  • Folder z eksportami Craft zsynchronizowany z serwerem, jeśli firma korzysta z Craft.

Czego asystent nie robi

  • Nie usuwa ani nie archiwizuje stron w Coda bez potwierdzenia ze strony użytkownika.
  • Nie aktualizuje wierszy, jeśli tabela nie ma kolumny z unikalnym identyfikatorem do wskazania właściwego wiersza.
  • Nie odpowiada za treść procedur: jeśli dokumenty w Coda są nieaktualne, odpowiedzi odzwierciedlają to, co jest w dokumencie.
  • Nie zastępuje osoby odpowiedzialnej za dokumentację: wskazuje zakurzone strony, ale decyzja o ich aktualizacji lub usunięciu należy do firmy.

Częste pytania

Czy asystent od razu czyta cały workspace, wszystkie strony?

Nie, zaczynamy od wskazanej przez Was sekcji, np. jednej tabeli albo grupy procedur, i sprawdzamy, czy odpowiedzi są trafne. Podłączenie całego workspace'u bez wcześniejszego audytu treści kończy się błędnymi odpowiedziami z nieaktualnych stron.

Co się stanie, jeśli zmienimy procedurę w Coda po uruchomieniu integracji?

Asystent przy każdym pytaniu pobiera aktualną treść strony przez API, więc zmiana w Coda jest widoczna od razu, bez przeindeksowania ani powiadamiania nas. Wystarczy zaktualizować dokument w Coda, a asystent zacznie odpowiadać z nowej wersji.

Czy możemy wskazać, które tabele i strony są dostępne dla asystenta?

Tak, zakres dostępu ustalamy przy wdrożeniu. Podajecie identyfikatory dokumentów i tabel, które mają być czytane, a asystent operuje tylko na nich. Token API też można przypiąć do konkretnych dokumentów w workspace'ie.

Co, jeśli nasza tabela w Coda ma inne kolumny niż dane w systemie źródłowym?

Przed uruchomieniem automatycznej aktualizacji mapujemy kolumny z obu stron. Jeśli różnice są duże, proponujemy dostosowanie struktury tabeli albo warstwę transformacji po stronie narzędzia. Bez dopasowania kolumn zapis przez API jest blokowany, żeby nie nadpisać złych pól.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z Coda

Jedno zdanie wystarczy: czego szukacie w Coda albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Coda jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.