API i webhooki

Rezerwacje Umovi w Twoim systemie

Udostępnij wybór usługi i wolnego terminu w swoim portalu, CRM-ie lub aplikacji. API zapisze rezerwację w Umovi, a webhooki pozwolą odbierać informacje o późniejszych zmianach.

Zobacz, jak to działaDokumentacja API

Przykład: Twój portal klienta

Jak rezerwacja z portalu trafia do Umovi

Na przykładzie portalu klienta zobaczysz pobieranie dostępnych terminów, zapis rezerwacji i aktualizację po zmianie godziny.

  1. 01

    Portal pokazuje dostępne terminy.

    Twój portalDostępność Umovi

    Pobiera z Umovi usługi, osoby i wolne godziny. Klient wybiera termin zgodny z grafikiem, czasem usługi i przerwami ustawionymi w kalendarzu.

  2. 02

    Rezerwacja trafia do zespołu.

    Wybór klientaKalendarz zespołu

    Portal przesyła wybrany termin i dane klienta. Umovi sprawdza dostępność przy zapisie. Po udanym utworzeniu rezerwacja jest w kalendarzu, a portal otrzymuje jej identyfikator.

  3. 03

    Zmiana wraca do portalu.

    Zmiana w UmoviAktualizacja portalu

    Pracownik przekłada rezerwację w Umovi. Webhook powiadamia Twój system, który może pobrać aktualne dane i pokazać klientowi nowy termin.

Kiedy warto

Gdzie wykorzystasz API Umovi

Własny portal lub aplikacja

Klient wybiera termin tam, gdzie już zamawia usługę lub zarządza swoim kontem.

CRM i obsługa klienta

Konsultant sprawdza dostępność i zapisuje termin bez wychodzenia z narzędzia, w którym prowadzi rozmowę.

Automatyzacje po rezerwacji

Utworzenie, przełożenie lub anulowanie terminu uruchamia dalszy proces w Twoim systemie.

Chcesz po prostu udostępnić klientom rezerwację online? Zacznij od profilu Umovi i linku do rezerwacji.

Zobacz panel firmy

Zakres wdrożenia

Co trzeba przygotować do integracji

Integracja wymaga wdrożenia po stronie Twojego systemu. Programista przygotowuje formularz, powiązanie danych i obsługę aktualizacji. W Umovi ustawiasz ofertę, dostępność oraz uprawnienia połączenia.

W Umovi

Przygotowujesz usługi, zespół, godziny pracy i dostęp integracji dla swojej firmy.

W Twoim systemie

Programista łączy dane klientów i rezerwacji, obsługuje zajęty termin oraz aktualizacje z Umovi.

Dla osoby wdrażającej

Jak uruchomić połączenie przez API

REST server-to-server, OAuth2 client credentials i dostęp ograniczony do jednej firmy. Sekret integracji przechowuj po stronie serwera.

Operacje i warunki, które trzeba obsłużyć
  1. 01

    Pobierz token i katalog.

    Utwórz klienta integracji w panelu firmy, zachowaj jednorazowo pokazany sekret i pobierz token. Katalog zwraca usługi oraz osoby potrzebne do wyboru terminu.

  2. 02

    Sprawdź termin przed zapisem.

    Obsłuż konflikt dostępności. Przy ponowieniach używaj Idempotency-Key; identyfikator swojego systemu przekaż jako externalReservationId.

  3. 03

    Odbieraj zmiany przez HTTPS.

    Weryfikuj podpis HMAC na surowej treści. Webhook może dotrzeć ponownie i poza kolejnością — deduplikuj dostarczenia i pobieraj aktualny stan rezerwacji.

REST · /integrations

POST /integrations/oauth/token

grant_type: client_credentials

/integrations/v1/providers/{providerId}
  GET  /catalog
  POST /reservations
  POST /webhooks

Idempotency-Key: <unique-request-key>

booking.created
booking.rescheduled
booking.cancelled_by_client
Otwórz dokumentację RESTUruchom tester API

Masz konkretny proces do połączenia?

Porozmawiajmy o Twoim systemie

Opowiedz, z jakiego systemu korzystasz i co ma się wydarzyć po wyborze terminu. Ustalimy zakres połączenia z Umovi.

Porozmawiaj o integracjiPrzekaż dokumentację programiście