SprzęciarzOS
StartFunkcjeCennikBlogKontakt
Zarejestruj się Zaloguj się

Integracje i API : webhooki, tokeny API i asystenci AI

Wypożyczalnia rzadko działa w jednym programie. Masz CRM, arkusz z rozliczeniami, stronę WWW, a coraz częściej także asystenta AI. SprzęciarzOS udostępnia trzy sposoby połączenia: REST API z tokenem, webhooki, które same informują Twoje systemy o zmianach, oraz serwer MCP, przez który Claude, ChatGPT czy Cursor mogą odczytywać dane Twojego konta.

REST API i tokeny API

Token wygenerujesz w Ustawienia → Dane i integracje → Tokeny API. Nadajesz mu nazwę, np. „Integracja Zapier”, i kopiujesz go od razu – po opuszczeniu strony nie zobaczysz go ponownie. Token dodajesz w nagłówku Authorization: Bearer do każdego żądania.

Token działa w imieniu Twojego użytkownika i ma te same uprawnienia co Ty w tym koncie. Integracja nie zobaczy więc więcej niż osoba, która ją podłączyła. Na liście tokenów widzisz, kiedy każdy z nich był ostatnio używany, a niepotrzebny token jednym kliknięciem unieważniasz. Utworzenie i unieważnienie tokenu trafia do historii aktywności.

Pełny opis endpointów – klienci, przedmioty z dostępnością, rezerwacje z wyceną i płatnościami, działy, dodatki, kody rabatowe, zgody i pola niestandardowe – znajdziesz w dokumentacji API.


Webhooki: Twoje systemy wiedzą o zmianach od razu

Zamiast co kilka minut pytać API, czy coś się zmieniło, ustaw webhook. Podajesz adres HTTPS i wybierasz zdarzenia:

  • utworzenie, zmiana, zmiana statusu i usunięcie rezerwacji,
  • dodanie, zmiana danych i usunięcie klienta.

Gdy zdarzenie zajdzie, SprzęciarzOS wyśle pod ten adres żądanie POST w formacie JSON z aktualnymi danymi rezerwacji lub klienta oraz listą zmian. Tak zsynchronizujesz CRM, wyślesz powiadomienie na komunikator albo uruchomisz scenariusz w narzędziu do automatyzacji.


Bezpieczne i niezawodne dostawy

Każde żądanie jest podpisane sekretem webhooka. Nagłówek X-Sprzeciarz-Signature pozwala odbiorcy sprawdzić, że wiadomość naprawdę pochodzi od SprzęciarzOS, a X-Sprzeciarz-Delivery – odrzucić powtórzone dostawy. Sekret w każdej chwili wygenerujesz na nowo.

Jeśli Twój serwer nie odpowie kodem 2xx, system ponowi wysyłkę po 1 min, 5 min, 30 min, 2 h, 6 h, 12 h i 24 h. Po 20 kolejnych nieudanych dostawach webhook zostanie wyłączony, a właściciel konta dostanie maila. W „Dzienniku dostaw” widzisz każdą próbę razem z kodem odpowiedzi, możesz ręcznie ponowić dostawę albo wysłać zdarzenie testowe. Wpisy dziennika są przechowywane przez 30 dni.


Asystenci AI przez MCP

MCP to standard, dzięki któremu asystent AI może korzystać z danych zewnętrznego systemu. Po podłączeniu SprzęciarzOS możesz zapytać Claude’a albo ChatGPT, co dziś wydajesz i przyjmujesz, czy koparka jest wolna w przyszłym tygodniu albo jakie rezerwacje ma dany klient.

Asystent ma dostęp do:

  • wyszukiwania rezerwacji, klientów i przedmiotów,
  • szczegółów rezerwacji i listy rezerwacji w wybranym okresie,
  • dostępności sprzętu w zakresie dat,
  • danych klienta,
  • agendy wydań, zwrotów i zadań, łącznie z zaległymi.

Dostęp jest tylko do odczytu – asystent niczego nie zmieni ani nie usunie. Każde zapytanie sprawdza uprawnienia użytkownika, który połączył asystenta.


Połączenie jednym kliknięciem i pełna kontrola

W Ustawienia → Dane i integracje → Połączone aplikacje znajdziesz adres serwera MCP dla swojego konta i instrukcje dla Claude, Claude Code, ChatGPT, Cursor i VS Code. Przy pierwszym połączeniu asystent otworzy stronę SprzęciarzOS z prośbą o zgodę – po kliknięciu „Zezwól” pojawi się na liście połączonych aplikacji. W każdej chwili możesz go „Odłączyć”. Jeśli asystent nie obsługuje logowania OAuth, możesz użyć tokenu API.

Każdy użytkownik widzi i odłącza wyłącznie swoje połączenia.


Podsumowanie korzyści

SprzęciarzOS nie zamyka Twoich danych w jednym programie. API pozwala je pobierać i zmieniać, webhooki informują o zmianach bez opóźnień, a MCP daje asystentom AI wgląd w rezerwacje i dostępność – zawsze w granicach uprawnień użytkownika. Webhooki i tokeny API są dostępne w każdym planie. Dostęp asystentów AI przez serwer MCP oferujemy w planach Business i Premium.

Przydała Ci się ta funkcja?

Oceń ją i pomóż innym wybrać najlepsze rozwiązania.

Kliknij aby ocenić ten wpis!
[Ilość ocen: 0, Średnia ocena: 0]

Jak możemy Ci pomóc?

Jesteś zainteresowany ale chcesz uzyskać dodatkowe informacje? Zostaw nam swój adres e-mail a skontaktujemy się z Tobą i odpowiemy na wszystkie pytania

Masz pytania?

Skontaktuj się z nami – chętnie odpowiemy!