Artykuły na: Integracje

Webhooks

Webhook to prosty i skuteczny mechanizm komunikacji pozwalający na udostępnianie danych do innych aplikacji w czasie rzeczywistym. Dane są dostarczane natychmiast po wykonaniu zdarzenia bez potrzeby częstego odpytywania aplikacji poprzez API.


Webhooki wychodzące


W inEwi możesz zdefiniować webhooki dla dwóch zdarzeń:


  1. Nowy wniosek (zmodyfikowany również)
  2. Usunięto zaakceptowany wniosek


Dodawanie webhooka


Przejdź do Ustawień organizacji (ikona konta w aplikacji) > sekcja po lewej Integracje i wciśnij zielony przycisk Konfiguracja przy integracji Webhooki.


Integracja Webhooks


Konfiguracja


  1. Wybierz z listy zdarzenie, dla którego chcesz zdefiniować webhooka,
  2. Dodaj własny URL,
  3. Zdefiniuj Token (opcjonalnie).


Token używany do autoryzacji jest opcjonalny. Jeżeli zostanie wpisany, wówczas będzie dołączony do żądania w postaci nagłówka "token".W przypadku włączonej dwuetapowej akceptacji wniosków urlopowych w inEwi, zdarzenie zostanie wysłane dopiero po pełnej akceptacji (2 osoby).


Wysyłanie


Webhooki wysyłane są gdy:

  • ✅ Wniosek urlopowy zostanie zaakceptowany
  • ✅ Wniosek urlopowy zostanie edytowany i zapisany
  • ✅ Wniosek urlopowy **zaakceptowany **zostanie usunięty
  • ❌ Wniosek urlopowy zostanie dodany
  • ❌ Wniosek urlopowy niezaakceptowany zostanie usunięty
  • ❌ Wniosek urlopowy zostanie zaakceptowany przez jedną osobę z dwóch


Format webhooka dla zaakceptowanego wniosku urlopowego oraz zmodyfikowanego:

{
    "applicationNumber": "2020/1",
    "applicationType": "Urlop wypoczynkowy",
    "acronym": "123",
    "applicantFullName": "Imię i nazwisko",
    "startDateTimeUtc": "1600034400",
    "endDateTimeUtc": "1600552800",
    "ignoreWeekends": "true",
    "ignoreHolidays": "true",
    "isWholeDay": "true",
    "note": "Notatka"
}


Czasy przesyłane są w formacie UNIX.


Format webhooka dla usuniętego wniosku zaakceptowanego:

{
    "applicationNumber": "2020/1"
}


Aktualizowane na: 29/01/2025