Wisegent — system do zarządzania firmą sprzątającą

Wisegent dla programistów

Twoje narzędzia.Jeden wspólny przepływ.

Niech Twoje systemy ze sobą rozmawiają. Połącz CRM, stronę internetową lub narzędzie raportowe z Wisegent przez publiczne REST API. Mniej podwójnego wpisywania. Więcej na Twoich zasadach.

Porozmawiajmy o API Zobacz przykład

REST · JSON · API v1 · Uprawnienia, które wybierasz

Twoja własna integracja. Po drugiej stronie Wisegent.
  • Klienci i adresy
  • Odczyt wydarzeń kalendarza
  • Tokeny API z możliwością unieważnienia

Dopasowane do Twojej pracy

Właściwe dane. Tam, gdzie ich potrzebujesz.

Zbuduj integrację dopasowaną do swojego sposobu pracy. Oto co obsługuje dziś publiczne API.

Dane klientów w jednym obiegu

Odczytuj, wyszukuj, twórz i aktualizuj klientów ze swojego systemu. Użyj własnych numerów klientów, aby powiązać rekordy.

GET · POST · PUT

Właściwy adres dla klienta

Odczytuj adresy klienta, dodawaj nowe i aktualizuj istniejące. Przenoś dane kontaktowe i adresowe bez ponownego wpisywania.

GET · POST · PUT

Kalendarz także w Twoich narzędziach

Odczytuj rezerwacje i wydarzenia kalendarza z wybranego okresu. Wykorzystaj je we własnych zestawieniach i raportach.

GET /events

Kalendarz w publicznym API jest tylko do odczytu. Faktury, płace i usuwanie rekordów nie są częścią API v1.

Od zapytania do odpowiedzi

Jedno zapytanie. Czytelna odpowiedź.

Prześlij token w nagłówku Authorization i otrzymaj uporządkowany JSON. Oto przykład pobrania klienta.

ZapytaniecURL
curl "https://app.wisegent.se/api/public/v1/clients/42" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
Fragment odpowiedzi200 OK
{
  "data": {
    "id": 42,
    "type": "company",
    "name": "Example AB",
    "contact_email": "[email protected]",
    "status": 1
  }
}

Ilustracja z fikcyjnymi danymi. Nie wysyłamy tu żadnego zapytania. We własnej integracji zastąp YOUR_TOKEN i ID klienta.

Wszystkie endpointy, pola i kody błędów znajdziesz w dokumentacji API. Wymagane logowanie do Wisegent.

Dostęp z jasnymi granicami

Ty wybierasz, co może integracja.

Każda integracja korzysta z własnego tokenu. Nadaj tylko potrzebny dostęp i zachowaj kontrolę w Wisegent.

  • Wybierz uprawnienia

    Wybierz odczyt klientów, zapis klientów lub odczyt kalendarza. Obowiązują także istniejące uprawnienia konta.

  • Tylko dane Twojej firmy

    Token daje dostęp wyłącznie do danych właściciela konta. Klienci i rezerwacje innych firm nie są dostępne.

  • Sekret pod Twoją kontrolą

    Token jest pokazywany tylko raz, przy tworzeniu. Przechowuj go na serwerze, nigdy w publicznym kodzie przeglądarki. Unieważnij go w ustawieniach, gdy nie jest już potrzebny.

Od pomysłu do integracji

Trzy kroki do własnego połączenia.

Potrzebujesz konta Wisegent oraz programisty lub partnera integracyjnego, który zbuduje i utrzyma połączenie.

Adres bazowy APIhttps://app.wisegent.se/api/public/v1

  1. Utwórz token

    Właściciel konta otwiera Ustawienia → Integracje → API. Nadaje nazwę, wybiera uprawnienia i od razu kopiuje token.

  2. Przygotuj pierwsze zapytanie

    Postępuj zgodnie z dokumentacją i prześlij token jako Bearer token. Zacznij od odczytu klienta i sprawdzenia odpowiedzi w swoim systemie.

  3. Zadbaj o dalszy przepływ

    Obsłuż paginację, błędy walidacji i limity zapytań. Dodaj uprawnienia zapisu tylko wtedy, gdy integracja ma tworzyć lub aktualizować klientów.

Zanim zaczniesz

Pytania o API.

Porozmawiajmy o API
Do jakich danych mamy dostęp?

API v1 obsługuje odczyt, tworzenie i aktualizację klientów oraz ich adresów, a także odczyt wydarzeń kalendarza. Nie obejmuje faktur, płac, usuwania ani tworzenia i zmieniania rezerwacji.

Czy potrzebujemy programisty?

Tak, własna integracja API wymaga prac programistycznych i utrzymania. Jeśli szukasz gotowych automatyzacji bez własnego kodu, sprawdź naszą integrację z Zapierem.

Czy obowiązują limity zapytań?

Limit wynosi 120 zapytań na minutę na właściciela konta, w tym maksymalnie 30 zapytań zapisujących. Zapytania kalendarza mogą obejmować najwyżej 93 dni. Korzystaj z paginacji i obsłuż kod odpowiedzi 429 w swojej integracji.

Gdzie znajdziemy dokumentację?

Dokumentacja API jest dostępna w centrum pomocy Wisegent po zalogowaniu. Zawiera endpointy, uwierzytelnianie, przykłady i specyfikację OpenAPI. Link znajdziesz także w Ustawienia → Integracje → API.

Twoje systemy. Twoja integracja.

Co chcesz połączyć z Wisegent?

Opowiedz, jak dziś pracujesz. Pomożemy Ci sprawdzić, co obsługuje API i od czego zacząć.

Porozmawiajmy o APIBez własnego kodu? Zobacz Zapier