> For the complete documentation index, see [llms.txt](https://docs.emaillabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emaillabs.io/konto/ustawienia/webhooki/konfiguracja-webhookow.md).

# Konfiguracja Webhooków

* Wybierz interesujący Cię kanał i typ zdarzeń, a następnie wypełnij wymagane pola.<br>

  <figure><img src="/files/UVnElx0NEoRUAbRqLUHK" alt=""><figcaption></figcaption></figure>

  * **URL** - Wprowadź endpoint (adres URL), na który serwery EmailLabs będą przesyłać dane.
  * **Drugi URL (opcjonalnie)** - Backupowy adres URL. W przypadku niedostępności lub błędnej odpowiedzi głównego URL, webhook zostanie przekazany na ten zapasowy adres.
  * **Reguła powiadomień** - Wybierz preferowany czas wysyłania powiadomień:
    * **Opcja 1**: co 1 godzinę, co 6 godzin, co 24 godziny,
    * **Opcja 2:** co 30 minut, co 2 godziny, co 24 godziny.
  * **Tryb autentykacji:**

    * **Brak** - Brak dodatkowej weryfikacji.
    * **Basic auth** - Po aktywacji tej opcji wprowadź login i hasło, które będą służyć do autoryzacji webhooka. Należy również dodać te informacje do ustawień autoryzacji na swoim endpoint. \
      \
      **Niezależnie od wybranego trybu, zalecane jest zawsze sprawdzenie poprawności hasha przychodzącego webhooka.**

    <figure><img src="/files/5krVlBs8siaxXf8n1oLL" alt=""><figcaption></figcaption></figure>
* Ważne informacje dotyczące kanału E-maile transakcyjne:
  * Jeśli chcesz otrzymywać zdarzenia z podziałem na subkonta dla raportów doręczeń, zaznacz checkbox 'W podziale na subkonta'.<br>

    <figure><img src="/files/FDkbEsjZaTPURAJYvZE9" alt=""><figcaption></figcaption></figure>
  * Pamiętaj, aby stosować **unikalne message\_id** podczas wysyłania wiadomości, co pozwoli na późniejszą agregację wszystkich webhooków (z kolejnymi statusami).
* Po przygotowaniu skryptu do odbioru danych, użyj opcji 'Test', aby sprawdzić, czy Twój skrypt poprawnie odbiera dane. Ustawienia webhooków zostaną zapisane dopiero po pomyślnym teście.

  Upewnij się, że Twój endpoint zwraca `HTTP/1.1 200 OK`, co potwierdza, że poprawnie otrzymał dane.
* 'Generuj SecretKey', czyli unikalny ciąg znaków, który służy do ochrony przesyłanych danych i zwiększeniu bezpieczeństwa.
* Po pomyślnym skonfigurowaniu webhooka kliknij 'Zapisz'.