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, kto zna nazwę tematu, może publikować i subskrybować. 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
Uwierzytelnianie	Nie wymagane	Wymagane (JWT, API key, topic token)
Kto może publikować	Każdy znający nazwę	Tylko właściciel + posiadacze tokenów
Kontrola dostępu	Brak (tylko limit IP)	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

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-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: Powinno działać bez uwierzytelniania
• 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