Tworzenie tematów

Dowiedz się, jak tworzyć i konfigurować tematy dla swoich powiadomień.

Czym są tematy?

Tematy to kanały służące do organizacji powiadomień. Pomyśl o nich jak o folderach e-mail lub kanałach Slack - każdy temat grupuje powiązane wiadomości.

Tworzenie pierwszego tematu

Przez panel internetowy

1. Przejdź do panelu głównego

   • Wejdź na app.notifer.io
   • Kliknij przycisk "+ Nowy temat" na pasku bocznym

2. Wprowadź szczegóły tematu

   • Nazwa tematu - Unikalny identyfikator (np. server-alerts, deployments)
     • Musi zawierać znaki alfanumeryczne z myślnikami/podkreśleniami
     • Nie można zmienić po utworzeniu
   • Opis (opcjonalnie) - Do czego służy ten temat

3. Wybierz poziom prywatności

   • Publiczny - Każdy uwierzytelniony użytkownik (JWT/klucz API) może publikować. Każdy może subskrybować bez uwierzytelniania. Możesz opcjonalnie udostępnić temat w katalogu publicznym, gdzie inni użytkownicy mogą go odnaleźć.
   • Prywatny - Tylko Ty kontrolujesz dostęp. Opcjonalnie możesz ustawić temat jako odkrywalny dla publicznych subskrypcji tylko do odczytu.

4. Opcje odkrywalności

   • Tematy publiczne: Zaznacz "Udostępnij w publicznym katalogu" aby pojawić się w Odkryj
   • Tematy prywatne: Zaznacz "Odkrywalny w publicznym katalogu" aby umożliwić subskrypcje tylko do odczytu

5. Kliknij "Utwórz temat"

Najlepsze praktyki nazewnictwa tematów

Dobre nazwy:

• server-alerts - Jasne, opisowe
• ci-deployments - Zorganizowane według systemu
• customer-signups - Oparte na zdarzeniach
• high-priority-incidents - Zawiera kontekst

Unikaj:

• topic1, test123 - Nieopisowe
• my topic name - Spacje nie są dozwolone
• aBc-XyZ - Niespójna wielkość liter

Tematy publiczne vs prywatne

Funkcja	Temat publiczny	Temat prywatny
Kto może publikować	Każdy uwierzytelniony użytkownik (JWT/klucz API)	Tylko właściciel + posiadacze tokenów (token tematu/JWT/klucz API)
Kto może subskrybować	Każdy	Właściciel, posiadacze tokenów lub subskrybenci odkrywalnych tematów (tylko odczyt)
Kontrola dostępu	Wymagane uwierzytelnianie do publikowania (zapobiega spamowi)	Pełna kontrola tokenami
Wymagany plan	FREE	ESSENTIALS+
Najlepszy dla	Testowanie, społeczności, status publiczny	Produkcja, dane wrażliwe, zespoły

Dowiedz się więcej o tematach prywatnych

Szczegółowe informacje o tematach prywatnych, odkrywalności, kontroli dostępu i najlepszych praktykach znajdziesz w Tematy prywatne.

Ustawienia tematu

Po utworzeniu tematu skonfiguruj go w Ustawieniach tematu.

Zobacz Przewodnik po ustawieniach tematu po szczegółową konfigurację, w tym tokeny dostępu, subskrybentów i ustawienia zaawansowane.

Zarządzanie tematami

Wyświetl swoje tematy

Zakładka Moje tematy:

• Pokazuje wszystkie tematy, których jesteś właścicielem
• Wyświetla liczbę wiadomości, liczbę subskrybentów
• Szybkie akcje: Ustawienia, Usuń

Sekcja Subskrypcje:

• Pokazuje tematy, które subskrybujesz
• Twoje ustawienia powiadomień dla każdego tematu

Usuń temat

Akcja nieodwracalna

Usunięcie tematu nie może zostać cofnięte. Wszystkie wiadomości i ustawienia zostaną utracone.

1. Otwórz ustawienia tematu (ikona koła zębatego)
2. Przewiń w dół → Strefa zagrożenia
3. Kliknij "Usuń temat"
4. Potwierdź wpisując nazwę tematu

Grupowanie i kolejność tematów

W aplikacji webowej możesz układać tematy we własne grupy, np. Produkcja, Homelab albo Klienci. Te same grupy widać w panelu bocznym (Subskrypcje) i na stronie Moje tematy.

Utworzenie grupy:

• Kliknij Nowa grupa na stronie Moje tematy albo ikonę folderu obok Subskrypcje w panelu bocznym
• Wpisz nazwę i naciśnij Enter

Przenoszenie tematów:

• Przeciągnij temat w panelu bocznym albo kafelek na stronie Moje tematy do innej grupy lub na inne miejsce
• Albo otwórz menu ⋮ tematu i wybierz Przenieś do grupy, Przesuń w górę lub Przesuń w dół
• Na ekranie dotykowym przytrzymaj temat przez chwilę, a potem go przeciągnij

Zarządzanie grupą przez jej menu ⋮:

• Sortuj tematy: Moja kolejność (ustalona przez Ciebie) albo Ostatnia aktywność (najnowsza wiadomość na górze, przypięte tematy na początku). Ręczna zmiana kolejności przełącza grupę na Moja kolejność.
• Zmień nazwę
• Usuń grupę: jej tematy trafiają do Bez grupy. Żaden temat nie jest usuwany.

Kliknij nazwę grupy, aby ją zwinąć lub rozwinąć. Panel boczny i Moje tematy zapamiętują to osobno, więc grupa może być zwinięta w panelu bocznym i rozwinięta na stronie Moje tematy.

Tematy, których nie przypisano do żadnej grupy, są w sekcji Bez grupy. Przypięte tematy zostają w swojej grupie i mają ikonę pinezki; przy sortowaniu Ostatnia aktywność są na początku.

wskazówka

Grupy są zapisywane na Twoim koncie, więc wyglądają tak samo na każdym komputerze, na którym się zalogujesz.

Wskazówki dotyczące organizacji tematów

Konwencje nazewnictwa

Używaj spójnych wzorców w tematach:

Według środowiska:

prod-alerts
staging-alerts
dev-alerts

Według systemu:

backend-errors
frontend-errors
database-alerts

Według priorytetu:

critical-incidents
high-priority
low-priority

Według zespołu:

team-engineering
team-sales
team-support

Tworzenie hierarchii tematów

Chociaż Notifer nie ma struktury folderów, użyj nazewnictwa do tworzenia logicznych grup:

# Monitorowanie serwera
server-cpu-alerts
server-disk-alerts
server-network-alerts

# Zdarzenia aplikacji
app-user-signups
app-purchases
app-errors

Przykłady

Użytek osobisty

# Poranne przypomnienia
Topic: daily-reminders (Prywatny)
curl -d "Time for standup meeting" \
  -H "X-API-Key: noti_..." \
  https://app.notifer.io/daily-reminders

Współpraca zespołowa

# Powiadomienia o wdrożeniach
Topic: deployments (Prywatny)
curl -d "Production deployment started" \
  -H "X-Topic-Token: tk_..." \
  -H "X-Priority: 2" \
  https://app.notifer.io/deployments

Projekt open source

# Ogłoszenia o wydaniach
Topic: project-releases (Publiczny)
curl -d "v2.0 released! 🎉" \
  -H "X-API-Key: noti_..." \
  -H "X-Tags: release,major" \
  https://app.notifer.io/project-releases

Rozwiązywanie problemów

Nazwa tematu już zajęta

Problem: Błąd "Nazwa tematu już istnieje"

Rozwiązanie:

• Nazwy tematów są globalnie unikalne
• Spróbuj dodać prefiks/sufiks: myapp-alerts zamiast alerts
• Sprawdź, czy już posiadasz ten temat w "Moje tematy"

Nie można publikować do tematu

Problem: 401 Unauthorized lub 403 Forbidden

Rozwiązanie:

• Temat publiczny: Wymagane uwierzytelnianie (JWT lub klucz API)
• Temat prywatny: Sprawdź, czy używasz poprawnego uwierzytelniania:
  • Token dostępu do tematu: -H "X-Topic-Token: tk_..."
  • Klucz API: -H "X-API-Key: noti_..."
  • JWT: -H "Authorization: Bearer ..."

Temat nie pojawia się w Odkryj

Problem: Publiczny temat nie jest widoczny w "Odkryj tematy"

Rozwiązanie:

• Tylko tematy publiczne pojawiają się w Odkryj
• Nowe tematy mogą potrzebować kilku minut, aby się pojawić
• Tematy bez wiadomości mogą nie być pokazywane
• Sprawdź prywatność tematu w ustawieniach

Kolejne kroki

• Ustawienia tematu - Konfiguruj ustawienia tematu i tokeny dostępu
• Publikowanie wiadomości - Rozpocznij wysyłanie powiadomień
• Tokeny dostępu do tematów - Bezpieczne integracje