API a webhooky

Rezervace Umovi ve tvém systému

Nabídni výběr služby a volného termínu ve svém portálu, CRM nebo aplikaci. API uloží rezervaci v Umovi a webhooky předají informace o pozdějších změnách.

Jak to fungujeDokumentace API

Příklad: tvůj klientský portál

Jak se rezervace z portálu dostane do Umovi

Na příkladu klientského portálu uvidíš načtení volných termínů, uložení rezervace a aktualizaci po změně času.

  1. 01

    Portál zobrazí volné termíny.

    Tvůj portálDostupnost v Umovi

    Načte z Umovi služby, pracovníky a volné časy. Klient vybere termín, který odpovídá pracovní době, délce služby a přestávkám v kalendáři.

  2. 02

    Rezervace se dostane k týmu.

    Výběr klientaKalendář týmu

    Portál odešle vybraný termín a údaje klienta. Umovi při ukládání ověří dostupnost. Po úspěšném vytvoření je rezervace v kalendáři a portál dostane její identifikátor.

  3. 03

    Změna se vrátí do portálu.

    Změna v UmoviAktualizace portálu

    Pracovník přesune rezervaci v Umovi. Webhook upozorní tvůj systém, který může načíst aktuální údaje a ukázat klientovi nový termín.

Kdy se to hodí

Kde využiješ API Umovi

Vlastní portál nebo aplikace

Klient vybírá termín tam, kde už objednává službu nebo spravuje svůj účet.

CRM a zákaznická podpora

Konzultant ověří dostupnost a zapíše termín v nástroji, ve kterém vede rozhovor.

Automatizace po rezervaci

Vytvoření, přesunutí nebo zrušení rezervace spustí další krok v tvém systému.

Chceš klientům jen umožnit rezervovat online? Začni profilem Umovi a odkazem na rezervaci.

Prohlédnout firemní panel

Rozsah implementace

Co je potřeba připravit pro integraci

Integrace vyžaduje úpravy tvého systému. Vývojář připraví formulář, propojení dat a zpracování aktualizací. V Umovi nastavíš nabídku, dostupnost a přístupová oprávnění.

V Umovi

Připravíš služby, tým, pracovní dobu a přístup integrace pro svou firmu.

Ve tvém systému

Vývojář propojí klienty a rezervace, ošetří obsazené termíny a zpracuje aktualizace z Umovi.

Pro vývojáře

Jak zprovoznit připojení přes API

REST mezi servery, OAuth2 client credentials a přístup omezený na jednu firmu. Tajný klíč integrace uchovávej na serveru.

Operace a situace, které je potřeba ošetřit
  1. 01

    Získej token a katalog.

    Ve firemním panelu vytvoř integračního klienta, ulož jednorázově zobrazený tajný klíč a vyžádej token. Katalog vrátí služby a pracovníky pro výběr termínu.

  2. 02

    Před uložením ověř dostupnost.

    Ošetři konflikt termínů. Při opakování používej Idempotency-Key a vlastní identifikátor záznamu pošli jako externalReservationId.

  3. 03

    Přijímej změny přes HTTPS.

    Ověř podpis HMAC nad původním tělem zprávy. Webhooky mohou přijít opakovaně a mimo pořadí: odstraň duplicitní doručení a načti aktuální stav rezervace.

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
Otevřít dokumentaci RESTSpustit tester API

Máš konkrétní proces k propojení?

Proberme tvůj systém

Řekni nám, jaký systém používáš a co se má stát po výběru termínu. Společně určíme rozsah propojení s Umovi.

Probrat integraciDokumentace pro tvého vývojáře