Sama technika integracji agenta z jednym systemem — na przykład CRM przez udokumentowane API — to zwykle kilka dni pracy inżynierskiej. To, co realnie wydłuża projekt do tygodni, to liczba systemów do spięcia, jakość i dostępność ich interfejsów oraz to, czy dane, na których agent ma pracować, są w ogóle uporządkowane.
Z czego naprawdę składa się „czas integracji"
Kiedy klient pyta „ile to potrwa”, zwykle ma na myśli czas pisania kodu. W praktyce ten czas to tylko jeden z czterech składników:
- Czas techniczny — projektowanie i pisanie kodu łączącego agenta z API danego systemu.
- Czas oczekiwania na dostępy — klucze API, zgody działu IT, konta testowe. Ten etap potrafi trwać dłużej niż sam kod, zwłaszcza w firmach z formalnym procesem zatwierdzania dostępów.
- Czas testowania na prawdziwych danych — sprawdzenie, czy integracja działa poprawnie nie tylko na przykładzie testowym, ale na realnym ruchu, z jego nieregularnościami.
- Czas na obsługę przypadków brzegowych — sytuacji, w których dane są niepełne, format się różni, albo system źródłowy odpowiada z opóźnieniem lub błędem.
Co realnie wydłuża integrację
- Liczba systemów do spięcia. Każdy kolejny system to nie dodawanie, tylko mnożenie złożoności — trzeba przemyśleć, jak dane z jednego wpływają na drugi.
- Jakość dokumentacji API dostawcy. Dobrze udokumentowane, powszechnie używane API (typowe nowoczesne SaaS) idzie szybko. Słabo udokumentowane lub rzadko używane endpointy wymagają eksperymentowania metodą prób i błędów.
- Brak REST API po stronie systemu. Jeśli jedynym sposobem wyjścia danych z systemu jest ręczny eksport CSV albo interfejs do klikania bez API, integracja przestaje być kwestią dni — trzeba budować dodatkową warstwę pośredniczącą.
- Wewnętrzne procesy bezpieczeństwa i zgody IT. W firmach z regulowaną branżą (finanse, ochrona zdrowia) sam proces uzyskania zgody na dostęp do systemu może zająć więcej czasu niż sama integracja.
- Jakość danych źródłowych. Dane rozproszone, niespójnie nazwane albo wymagające ręcznego czyszczenia przed użyciem wymagają dodatkowego etapu normalizacji, zanim agent zacznie z nimi pracować.
Co realnie skraca integrację
- Nowoczesny system SaaS z dobrze udokumentowanym REST API i wsparciem dla webhooków.
- Dedykowana osoba po stronie klienta, która ma uprawnienia do szybkiego nadawania dostępów.
- Jasno zdefiniowany, wąski zakres wyniesiony wprost z etapu prototypu — integracja bez niedomówień co do tego, jakie dane mają faktycznie płynąć między systemami.
- Wcześniejsze doświadczenie zespołu wdrożeniowego z danym typem systemu (np. konkretnym CRM), co eliminuje etap odkrywania jego ograniczeń od zera.
Ogólny porządek wielkości
Bez podawania sztywnego cennika czy fikcyjnego harmonogramu, warto mieć punkt odniesienia co do rzędu wielkości:
| Złożoność | Charakterystyka | Rząd wielkości |
|---|---|---|
| Prosta | Jeden system, dobre REST API, dane już uporządkowane | Dni |
| Średnia | 2–3 systemy, część wymaga dodatkowej konfiguracji dostępów | Tygodnie |
| Złożona | 4+ systemów, w tym starsze systemy bez nowoczesnego API, regulowana branża | Tygodnie do miesięcy |
To ogólne ramy, nie obietnica dla konkretnego przypadku — realny czas zawsze zależy od kombinacji czynników opisanych wyżej, dlatego wycenę i harmonogram ustalamy dopiero po rozmowie o konkretnych systemach klienta.
Jak przygotować się, żeby przyspieszyć start
Część czasu integracji jest po stronie zespołu wdrożeniowego, ale część zależy wyłącznie od przygotowania klienta — i to ta druga część najczęściej daje się skrócić bez żadnego dodatkowego kosztu. Zanim padnie pierwsza rozmowa o integracji, warto mieć zebraną listę systemów, które mają zostać spięte, wraz z informacją, czy mają dokumentację API i kto w firmie ma do niej dostęp. Warto też z wyprzedzeniem ustalić, kto może szybko nadać dostępy testowe — jeśli o zgodę trzeba pytać dopiero w trakcie prac, właśnie to najczęściej staje się wąskim gardłem, nie sam kod.
Drugi element przygotowania to jasność co do tego, które dane faktycznie mają płynąć między systemami. Zespół techniczny może zaproponować rozwiązanie, ale to klient najlepiej wie, które pola są krytyczne, a które opcjonalne — i ustalenie tego przed startem integracji, a nie w jej trakcie, eliminuje jedną z najczęstszych przyczyn poślizgów.
Pytania, które warto zadać dostawcy integracji
- Czy wyceniacie integrację przed czy po sprawdzeniu dokumentacji API naszych systemów?
- Co się dzieje, jeśli w trakcie pracy okaże się, że system nie ma potrzebnego endpointu?
- Kto po Waszej stronie zajmuje się testowaniem na realnych, a nie tylko testowych danych?
- Jak wygląda obsługa przypadków, w których system źródłowy zwróci błąd albo niepełne dane?
Jeśli jesteś na etapie przed integracją i zastanawiasz się, jak wygląda poprzedzający ją prototyp, przeczytaj Jak wygląda prototyp rozwiązania AI, zanim zapadnie decyzja o wdrożeniu. Jeśli dopiero oceniasz, czy Twoja firma jest w ogóle gotowa na ten etap, sprawdź Checklist: czy Twoja firma jest gotowa na pierwsze wdrożenie AI. Więcej o naszym procesie — na stronie głównej Orkestra Labs.