---
title: Zacznij z Echobell – kompletny przewodnik konfiguracji
sidebarTitle: Pierwsze kroki
description: "Skonfiguruj Echobell w kilka minut: utwórz kanały powiadomień, podłącz wyzwalacze webhook lub e-mail i odbieraj na telefonie natychmiastowe alerty push albo połączenia."
---

# Zacznij z Echobell

Witamy w Echobell — aplikacji do natychmiastowych alertów, która pomoże Ci panować nad ważnymi powiadomieniami. Niezależnie od tego, czy jesteś programistą potrzebującym alertów webhook ze swojego procesu CI/CD, administratorem monitorującym serwery, czy zespołem zarządzającym krytycznymi powiadomieniami, ten obszerny przewodnik przeprowadzi Cię przez konfigurację i efektywne korzystanie z Echobell.

Po jego lekturze będziesz wiedzieć, jak tworzyć kanały powiadomień, konfigurować wyzwalacze webhook i e-mail, dostosowywać szablony powiadomień oraz integrować Echobell z narzędziami i procesami, których już używasz.

## Czym jest Echobell?

Echobell to rozbudowane narzędzie do zarządzania powiadomieniami, stworzone dla programistów, zespołów DevOps i wszystkich, którzy potrzebują niezawodnych, natychmiastowych alertów. Łączy Twoje systemy z urządzeniem mobilnym, dbając o to, by krytyczne informacje docierały do Ciebie od razu.

**Kluczowe możliwości:**

- **Integracja przez webhooki**: podłącz dowolny system, który potrafi wysyłać żądania HTTP — narzędzia monitorujące, procesy CI/CD, urządzenia IoT i inne
- **Wyzwalacze e-mail**: zamień dowolną wiadomość w natychmiastowe powiadomienie, przekazując ją na dedykowany adres e-mail swojego kanału
- **Własne szablony**: używaj dynamicznych zmiennych, aby tworzyć treściwe powiadomienia z kontekstem
- **Elastyczne typy powiadomień**: wybieraj między standardowymi powiadomieniami, alertami czasowo krytycznymi a powiadomieniami w formie połączenia przy krytycznych problemach
- **Projekt oparty na prywatności**: historia Twoich powiadomień zostaje na urządzeniu, a nie na naszych serwerach
- **Współpraca zespołowa**: udostępniaj kanały współpracownikom i zarządzaj dostępem subskrybentów

Dowiedz się więcej o tym, [co wyróżnia Echobell](/docs/what-is-echobell), i zobacz [pełny przegląd funkcji](/docs/features).

![Echobell Overview](/images/docs/screenshot-overview.en.webp)

## Podstawowe pojęcia

Zanim zaczniemy, poznajmy kilka kluczowych pojęć:

### Kanały

**Kanał** to podstawowa jednostka w Echobell służąca do porządkowania i rozsyłania powiadomień:

- Każdy kanał ma unikalną **nazwę** i **kolor**, dzięki czemu łatwo rozpoznasz różne źródła alertów
- Kanały zawierają **[szablony powiadomień](/docs/template)**, które określają, jakie informacje trafiają do subskrybentów
- Kanały wyzwalane są przez **[webhooki](/docs/webhook)** lub **[e-maile](/docs/email-trigger)**
- Możesz tworzyć własne kanały albo subskrybować kanały udostępnione przez innych
- Każdy kanał obsługuje **[warunki](/docs/conditions)** filtrujące, które wyzwolenia faktycznie wysyłają powiadomienia
- Kanałami możesz dzielić się z zespołem lub publicznie przez bezpieczne linki subskrypcji

Pomyśl o kanale jak o rurociągu powiadomień: dane wpływają przez wyzwalacze, formatowane są przez szablony, filtrowane przez warunki i dostarczane jako powiadomienia do wszystkich subskrybentów.

### Wyzwalacze

**Wyzwalacz** to mechanizm, który uruchamia kanał i wysyła powiadomienia. Echobell obsługuje dwie metody wyzwalania:

- **[Webhook](/docs/webhook)**: punkt końcowy URL, który po wywołaniu metodą HTTP GET lub POST aktywuje kanał. Idealny do integracji z systemami monitoringu, procesami CI/CD, funkcjami serverless i każdym narzędziem, które potrafi wysłać żądanie HTTP.
  
- **[Wyzwalacz e-mail](/docs/email-trigger)**: unikalny adres e-mail powiązany z kanałem. Gdy wiadomość trafi na ten adres, kanał zostaje aktywowany. Świetny przy alertach e-mailowych, przekazywaniu ważnych wiadomości albo systemach, które obsługują wyłącznie powiadomienia pocztą.

Obu typów wyzwalaczy możesz używać jednocześnie w tym samym kanale, co daje maksymalną swobodę w wysyłaniu alertów. Dowiedz się więcej o [integracji przez webhooki](/docs/webhook) i [wyzwalaczach e-mail](/docs/email-trigger).

### Typy powiadomień

Subskrybując kanał, możesz wybrać różne [style powiadomień](/docs/notification), które decydują o tym, jak alerty pojawiają się na Twoim urządzeniu:

- **Standardowe (Aktywne)**: zwykłe powiadomienie aplikacji, które trafia do centrum powiadomień. Najlepsze przy niepilnych aktualizacjach i informacjach.

- **Czasowo krytyczne**: powiadomienie o wysokim priorytecie, które potrafi przebić się przez tryby Skupienia i ustawienia Nie przeszkadzać. Zalecane przy ważnych alertach wymagających szybkiej uwagi, ale niebędących krytyczną awarią.

- **Połączenie**: alert w formie połączenia, z dzwonkiem i pełnoekranowym interfejsem, przypominający przychodzący telefon. Niezbędny przy krytycznych incydentach wymagających natychmiastowej reakcji, takich jak awarie produkcji czy alerty bezpieczeństwa.

Wybór typu powiadomienia zależy od tego, jak pilne są treści danego kanału. W razie potrzeby możesz zasubskrybować ten sam kanał kilka razy z różnymi typami powiadomień. Przeczytaj nasz [szczegółowy przewodnik po powiadomieniach](/docs/notification), aby wiedzieć, kiedy sięgać po każdy z nich.

## Pierwsze kroki

### 1. Zakładanie konta

1. Pobierz Echobell z [App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=docs-index-pl&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid)
2. Otwórz aplikację i zaloguj się adresem e-mail albo przez Zaloguj się z Apple

![Account Setup](/images/docs/screenshot-sign-in.en.webp)

### 2. Tworzenie pierwszego kanału

1. W widoku głównym dotknij przycisku w prawym dolnym rogu, aby przejść do widoku **Kanały**
2. Dotknij przycisku **+**, aby utworzyć nowy kanał
3. Wpisz nazwę kanału (np. „Alerty serwera”)
4. Wybierz kolor identyfikujący kanał
5. Skonfiguruj szablony powiadomień:
   - **Szablon tytułu**: to, co pojawia się jako nagłówek powiadomienia
   - **Szablon treści**: szczegółowa zawartość powiadomienia
6. Opcjonalnie zdecyduj, czy od razu zasubskrybować kanał samodzielnie
7. Wybierz **typ powiadomienia** dla kanału (Standardowe, Czasowo krytyczne lub Połączenie)
8. Zapisz nowy kanał

![Create Channel](/images/docs/screenshot-create-channel.en.webp)

### 3. Konfigurowanie wyzwalacza

Gdy kanał jest już utworzony, powiadomienia możesz wyzwalać na dwa sposoby: webhookami albo e-mailami. Dotknij właśnie utworzonego kanału, aby przejść do jego ustawień. W ustawieniach kanału znajdziesz sekcję **Wyzwalacze**.

![Channel Settings](/images/docs/screenshot-channel-settings.en.webp)

#### Wyzwalacz webhook

1. Dotknij przycisku **webhook**, aby skopiować wygenerowany adres URL webhooka
2. Wpleć ten adres w swoje systemy (np. monitoring serwerów, proces CI/CD)
3. Wywołanie tego adresu wyzwoli Twój kanał

Zmienne do szablonów powiadomień możesz przekazywać na dwa sposoby:

```bash
# Example webhook call with query parameters
curl -X GET "https://hook.echobell.one/t/<channel-token>?server=production&status=critical&message=CPU%20usage%20at%2095%25"

# OR with JSON body
curl -X POST https://hook.echobell.one/t/<channel-token> \
  -H "Content-Type: application/json" \
  -d '{"server": "production", "status": "critical", "message": "CPU usage at 95%"}'
```

Te zmienne posłużą do wypełnienia szablonów powiadomień. Na przykład jeśli szablon tytułu to `{{server}} - {{status}}`, wyrenderuje się jako „production - critical”.

**Zmienne specjalne:**

- `externalLink`: jeśli dołączysz tę zmienną, zostanie pokazana jako klikalny odnośnik we wpisach powiadomień

#### Wyzwalacz e-mail

1. Dotknij przycisku **email**, aby skopiować wygenerowany adres e-mail swojego kanału
2. Wysłanie wiadomości na ten adres wyzwoli Twój kanał

Przy wyzwalaczach e-mail Echobell automatycznie wyodrębnia z wiadomości następujące zmienne:

- `from`: adres e-mail nadawcy
- `to`: adres e-mail odbiorcy (adres e-mail Twojego kanału)
- `subject`: temat wiadomości
- `text`: treść wiadomości w postaci zwykłego tekstu
- `html`: treść wiadomości w formacie HTML

Zmiennych tych możesz używać w szablonach, na przykład `{{subject}}` czy `{{text}}`.

### 4. Dostosowywanie szablonów powiadomień

Szablony korzystają ze zmiennych wypełnianych danymi z wyzwalacza:

1. W ustawieniach kanału przejdź do sekcji **Szablony powiadomień**
2. Jako szablonu tytułu możesz użyć: `{{server}} - {{status}}`
3. Jako szablonu treści możesz użyć: `{{message}} Detected at {{timestamp}}`
4. Zmienne zapisuje się w podwójnych nawiasach klamrowych: `{{variable_name}}`
5. Przetestuj szablon na przykładowych danych

### 5. Subskrybowanie kanałów

1. Możesz udostępniać innym linki subskrypcji swoich kanałów
2. Albo skorzystać z linków udostępnionych przez innych, aby zasubskrybować ich kanały
3. Dotknij **Subskrybuj** w widoku kanałów
4. Wklej link subskrypcji
5. Wybierz preferowany **typ powiadomienia**:
   - Standardowe przy zwykłych alertach
   - Czasowo krytyczne przy ważnych alertach
   - Połączenie w sytuacjach krytycznych
6. Potwierdź subskrypcję

## Ustawienia aplikacji

Sposób obsługi powiadomień przez Echobell możesz dostosować tymi ustawieniami:

- **Powtarzaj treść głosową**: przy powiadomieniach w formie połączenia to ustawienie sprawia, że treść powiadomienia jest powtarzana
- **Ponawiaj nieudane połączenia**: automatycznie ponawia powiadomienia w formie połączenia, które nie doszły do skutku z powodu trybu Skupienia lub innych przyczyn

## Prywatność i przechowywanie danych

Echobell traktuje Twoją prywatność priorytetowo:

- Na naszych serwerach przechowywane są wyłącznie konta użytkowników, kanały i dane subskrypcji
- Treść i historia powiadomień są przechowywane lokalnie na Twoim urządzeniu
- Dane Twoich alertów nigdy nie wymykają się spod Twojej kontroli

## Kolejne kroki

Skoro masz już skonfigurowany pierwszy kanał, sięgnij po te materiały, aby wycisnąć z Echobell maksimum:

### Najważniejsze przewodniki

- **[Czym jest Echobell?](/docs/what-is-echobell)** – poznaj podstawowe pojęcia i filozofię stojącą za Echobell
- **[Przegląd funkcji](/docs/features)** – zobacz wszystkie dostępne funkcje i możliwości
- **[Przewodnik po szablonach](/docs/template)** – opanuj składnię szablonów i twórz dynamiczne powiadomienia
- **[Warunki](/docs/conditions)** – naucz się filtrować powiadomienia na podstawie danych z wyzwalacza
- **[Integracja przez webhooki](/docs/webhook)** – zanurz się w konfigurację webhooków i dobre praktyki
- **[Wyzwalacze e-mail](/docs/email-trigger)** – skonfiguruj wyzwalanie powiadomień pocztą

### Przewodniki integracji

Połącz Echobell z popularnymi narzędziami i platformami:

- **[Integracja z Grafaną](/docs/developer/grafana)** – monitoruj infrastrukturę z natychmiastowymi alertami
- **[GitHub Actions](/docs/developer/github)** – otrzymuj powiadomienia o zdarzeniach w procesie CI/CD
- **[Prometheus](/docs/developer/prometheus)** – skonfiguruj alerty dla metryk Prometheusa
- **[Home Assistant](/docs/developer/home-assistant)** – powiadomienia z automatyki domowej
- **[Monitoring dostępności](/docs/developer/uptime-kuma)** – alerty o dostępności witryn i usług
- **[TradingView](/docs/trader/tradingview)** – alerty giełdowe i powiadomienia rynkowe

### Dobre praktyki

- **Zacznij prosto**: najpierw twórz podstawowe kanały z prostymi szablonami, a stopniowo dokładaj złożoności
- **Testuj szablony**: używaj testowych wywołań webhooka, aby sprawdzić poprawność renderowania, zanim wdrożysz je na produkcję
- **Rozsądnie używaj warunków**: odfiltruj szum, ustawiając w kanałach warunki alertowania tylko o ważnych zdarzeniach
- **Dobieraj odpowiednie typy powiadomień**: zarezerwuj powiadomienia „Połączenie” dla naprawdę krytycznych alertów, aby uniknąć znieczulenia na alerty
- **Porządkuj kolorami**: używaj kolorów kanałów przemyślanie, aby jednym rzutem oka rozpoznawać źródła alertów
- **Dokumentuj kanały**: w notatkach kanału zapisuj, co go wyzwala i jak należy zareagować

### Typowe zastosowania

Zobacz, jak korzystają z Echobell inni:

- **Monitoring serwerów**: natychmiastowe alerty, gdy zużycie CPU, pamięci lub dysku przekroczy progi
- **Powiadomienia CI/CD**: od razu wiesz, kiedy build się nie powiódł albo wdrożenie się zakończyło
- **Alerty e-commerce**: powiadomienia o nowych zamówieniach, problemach z płatnościami czy stanach magazynowych
- **Monitoring bezpieczeństwa**: krytyczne alerty o nieudanych logowaniach, podejrzanej aktywności i zdarzeniach bezpieczeństwa
- **IoT i inteligentny dom**: powiadomienia z czujników, kamer i systemów automatyki domowej
- **Koordynacja zespołu**: udostępniaj kanały członkom zespołu, aby wspólnie reagować na incydenty

### Uzyskaj pomoc

Potrzebujesz wsparcia albo masz pytania?

- **[Centrum wsparcia](/docs/support)** – przejrzyj częste pytania i przewodniki rozwiązywania problemów
- **Wsparcie e-mail**: napisz do nas na echobell@weelone.com
- **Społeczność**: dołącz do dyskusji i podziel się swoimi zastosowaniami z innymi użytkownikami Echobell

Gotowi na integrację Echobell ze swoimi systemami? Zajrzyj do naszego [przewodnika po integracji z webhookami](/docs/webhook) albo przejrzyj [integracje dla programistów](/docs/developer/github), aby zacząć!