Echobell Direct: osobiste alerty z webhooków bez konfigurowania kanału

Spis treści

• Czym jest Echobell Direct?
• Konfiguracja w 3 krokach
• Krok 1: utwórz klucz Direct
• Krok 2: skopiuj adres URL webhooka
• Krok 3: wyślij pierwsze powiadomienie
• Poziomy pilności
• Dodawanie kontekstu do alertów
• Direct a kanały
• Zasady bezpieczeństwa
• FAQ
• Powiązane materiały

Echobell Direct to tryb osobistego alertowania, który całkowicie pomija konfigurowanie kanału. Tworzysz klucz Direct, dostajesz adres URL webhooka i wysyłasz metodą POST pola title oraz body, aby natychmiast odebrać powiadomienie na urządzeniu. Bez subskrybentów, bez szablonów, bez konfiguracji routingu.

Ten przewodnik wyjaśnia, czym jest Direct, jak go skonfigurować i kiedy używać go zamiast kanałów.

Czym jest Echobell Direct?

Każdy klucz Direct generuje unikalny adres URL webhooka (/d/{token}). Wyślij żądanie pod ten adres, a powiadomienie od razu pojawi się na Twoim urządzeniu.

Używaj Direct, gdy potrzebujesz:

• Osobistych powiadomień ze skryptów, zadań cron albo potoków CI
• Własnego tytułu i treści dla każdego żądania zamiast stałych szablonów
• Szybkiego startu bez konfigurowania pełnego kanału

Jeśli potrzebujesz powiadomień współdzielonych, szablonów wielokrotnego użytku albo dostarczania warunkowego, sięgnij po kanały z webhookami.

Konfiguracja w 3 krokach

Krok 1: utwórz klucz Direct

Otwórz Echobell, dotknij Direct na liście kanałów i utwórz klucz. Nazwij go tak jak usługę, do której należy (np. CI Server, Cron, AI Tasks).

Krok 2: skopiuj adres URL webhooka

Każdy klucz ma adres URL w formacie:

https://hook.echobell.one/d/YOUR_KEY_TOKEN

Traktuj ten adres jak sekret — każdy, kto go zna, może wysyłać Ci powiadomienia.

Krok 3: wyślij pierwsze powiadomienie

curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy failed",
    "body": "api-service failed health check",
    "notificationType": "time-sensitive",
    "externalLink": "https://dashboard.example.com/deploys/123"
  }'

Pełny opis pól: API Direct

Poziomy pilności

Direct obsługuje pole notificationType, więc możesz dopasować pilność do zdarzenia:

• active — zwykłe aktualizacje
• time-sensitive — ważne alerty, które przebijają się przez tryb Skupienia
• calling — incydenty krytyczne (wymaga aktywnej subskrypcji premium; w przeciwnym razie działa jak time-sensitive)

Pełny opis zachowania znajdziesz w sekcji Typy powiadomień.

Dodawanie kontekstu do alertów

Dodaj pole externalLink w treści żądania, aby dołączyć do powiadomienia adres URL — przydaje się to przy odsyłaniu wprost do logu wdrożenia, dashboardu albo pull requesta.

W przypadku agentów AI i długich zadań asynchronicznych Direct to najprostszy sposób, by dostać powiadomienie o zakończeniu pracy zamiast ręcznie odpytywać o status. Zobacz też: WebhookMCP + Echobell.

Direct a kanały

Wybierz kanały, gdy alerty mają docierać do wielu osób albo gdy zależy Ci na spójnym formatowaniu w obrębie usługi. Dokumentacja szablonów · Czym jest Echobell

Zasady bezpieczeństwa

• Trzymaj tokeny Direct w zmiennych środowiskowych albo w menedżerze sekretów, nie w kodzie
• Twórz osobny klucz dla każdej usługi, aby móc unieważniać je pojedynczo
• Natychmiast rotuj tokeny, jeśli adres URL mógł wyciec
• Zarezerwuj calling na prawdziwe incydenty — nadużywanie prowadzi do zmęczenia alertami

FAQ

Czy Direct jest tylko dla programistów? Nie. Skorzysta z niego każdy, kto ma narzędzie potrafiące wysyłać żądania HTTP.

Czy Direct obsługuje żądania GET? Tak, ale zalecamy POST z JSON-em.

Co się stanie, gdy moja subskrypcja wygaśnie, a używam calling? Powiadomienie automatycznie zadziała jak time-sensitive.

---

Zacznij od przewodnika po Direct. Gdy Twój sposób pracy urośnie i będzie wymagał współpracy lub szablonów, kanały są naturalnym kolejnym krokiem.

Powiązane materiały

• Dokumentacja API Direct — pełny opis pól i przykłady
• WebhookMCP + Echobell — powiadomienia o zakończeniu zadań AI z użyciem Direct
• Jak omijać tryb Skupienia w iOS — jak dobrać właściwy poziom pilności
• Powiadomienia z webhooków Zapiera — automatyzacje dla osób nieprogramujących
• Typy powiadomień — zachowanie trybów standardowego, czasowo krytycznego i połączenia