Ustawienia tematu

Kompletny przewodnik po konfigurowaniu i zarządzaniu ustawieniami tematów.

Wymagania wstępne

Musisz być właścicielem tematu, aby uzyskać dostęp do ustawień tematu.

Dostęp do ustawień tematu

1. Z panelu głównego

   • Przejdź do app.notifer.io
   • Znajdź swój temat w zakładce "Moje tematy"
   • Kliknij ikonę koła zębatego (⚙️) obok nazwy tematu

2. Ze strony tematu

   • Otwórz temat: app.notifer.io/topic/your-topic
   • Kliknij przycisk "Ustawienia tematu" (prawy górny róg)

Przegląd ustawień

Ustawienia tematu są zorganizowane w zakładki:

• Ogólne - Podstawowe informacje i prywatność
• Tokeny dostępu - Uwierzytelnianie dla integracji (tylko tematy prywatne)
• Subskrybenci - Wyświetl i zarządzaj subskrybentami
• Powiadomienia - Preferencje powiadomień
• Zaawansowane - Retencja, limity, strefa zagrożenia

Ustawienia ogólne

Podstawowe informacje

Nazwa wyświetlana

• Przyjazna nazwa pokazywana w interfejsie
• Można zmienić w dowolnym momencie
• Nie wpływa na URL tematu

Opis

• Do czego służy ten temat
• Pokazywany na liście tematów i stronie odkrywania
• Obsługuje formatowanie markdown

Ikona/Emoji (opcjonalnie)

• Wizualny identyfikator tematu
• Pokazywany na liście tematów

Ustawienia prywatności

Prywatność tematu

• Publiczny - Każdy może publikować/subskrybować
• Prywatny - Wymagane uwierzytelnianie

Zmiana prywatności

Zmiana z publicznego na prywatny natychmiast wymusi uwierzytelnianie dla wszystkich wydawców i subskrybentów.

Widoczność

• Pokaż w Odkryj - Temat pojawia się w publicznym odkrywaniu (tylko tematy publiczne)
• Ukryj w Odkryj - Temat jest publiczny, ale nie wykrywalny

Tokeny dostępu (tematy prywatne)

Tokeny dostępu zapewniają zakresowe uwierzytelnianie dla integracji z tematami prywatnymi. W zakładce Tokeny dostępu możesz tworzyć, przeglądać i odwoływać tokeny.

Każdy token może mieć uprawnienia do publikowania, subskrybowania lub obu operacji.

curl -d "Message from CI" \
  -H "X-Topic-Token: tk_FjZTOcx14k4_Kg6RtUCikAPYc2KNjXIMkWQUvDSREFc" \
  https://app.notifer.io/your-topic

Szczegółowy przewodnik tokenów

Pełna dokumentacja tworzenia, zarządzania, najlepszych praktyk i rozwiązywania problemów z tokenami dostępu znajduje się w Tokeny dostępu do tematów.

Subskrybenci

Wyświetl i zarządzaj osobami subskrybującymi Twój temat.

Lista subskrybentów

Pokazuje wszystkich aktywnych subskrybentów z:

• Urządzenie - Platforma (Web, iOS, Android)
• Subskrybowany - Kiedy się subskrybowali
• Ustawienia powiadomień - Ich filtry priorytetu/tagów
• Ostatnio aktywny - Ostatni raz, gdy otrzymali wiadomość

Akcje subskrybenta

Usuń subskrybenta:

1. Znajdź subskrybenta na liście
2. Kliknij "Usuń"
3. Potwierdź akcję

Tylko tematy prywatne

Zarządzanie subskrybentami jest dostępne tylko dla tematów prywatnych. Tematy publiczne nie śledzą subskrybentów.

Ustawienia zaawansowane

Retencja wiadomości

Kontroluj, jak długo wiadomości są przechowywane:

Plan	Retencja
FREE	7 dni
ESSENTIALS	30 dni
TEAM	45 dni

Zmień retencję:

1. Przejdź do zakładki Zaawansowane
2. Wybierz okres retencji
3. Kliknij "Zapisz"

Zmniejszanie retencji

Zmniejszenie okresu retencji natychmiast usunie starsze wiadomości.

Retencja nieaktywnych tematów

Tematy bez opublikowanych wiadomości przez dłuższy okres są automatycznie usuwane w celu utrzymania jakości usługi.

Plan	Okres nieaktywności	Ostrzeżenie przed usunięciem
FREE	7 dni	3 dni (ostrzeżenie wysłane w dniu 4)
ESSENTIALS	30 dni	7 dni (ostrzeżenie wysłane w dniu 23)
TEAM	45 dni	7 dni (ostrzeżenie wysłane w dniu 38)

Jak to działa:

1. Zegar nieaktywności - Rozpoczyna się od ostatniej opublikowanej wiadomości
2. Powiadomienie ostrzegawcze - Otrzymasz powiadomienie w aplikacji i email przed usunięciem
3. Automatyczne usunięcie - Jeśli nie zostaną opublikowane żadne wiadomości, temat zostanie trwale usunięty

Utrzymaj swoje tematy aktywne

Po prostu opublikuj dowolną wiadomość do tematu, aby zresetować zegar nieaktywności. Nawet prosty komunikat "ping" zapobiegnie usunięciu.

Usunięte tematy nie mogą być odzyskane

Po usunięciu tematu z powodu nieaktywności wszystkie wiadomości, tokeny dostępu i ustawienia są trwale utracone. Nazwa tematu staje się dostępna dla innych.

Limity szybkości

Wyświetl i skonfiguruj limity szybkości:

Plan	Wiadomości/godzinę	Burst
FREE	10	100
ESSENTIALS	30	300
TEAM	100	1 000

Nadpisz limity (tylko plan TEAM):

• Niestandardowe limity szybkości dla określonych tematów
• Skontaktuj się z obsługą w sprawie wyższych limitów

Limity rozmiaru wiadomości

Plan	Maks. rozmiar wiadomości
FREE	4 KB
ESSENTIALS	16 KB
TEAM	64 KB

Strefa zagrożenia

Niszczące akcje, których nie można cofnąć.

Usuń temat

Akcja nieodwracalna

Ta akcja nie może zostać cofnięta. Wszystkie wiadomości, subskrybenci i ustawienia zostaną trwale usunięte.

Aby usunąć temat:

1. Przewiń do Strefy zagrożenia na dole zakładki Zaawansowane
2. Kliknij "Usuń temat"
3. Wpisz nazwę tematu, aby potwierdzić
4. Kliknij "Usuń na zawsze"

Co zostaje usunięte:

• ❌ Wszystkie wiadomości
• ❌ Wszystkie tokeny dostępu
• ❌ Wszyscy subskrybenci
• ❌ Wszystkie ustawienia i konfiguracja
• ❌ Nazwa tematu staje się dostępna dla innych

Przykłady

Konfiguracja integracji CI/CD

# 1. Utwórz temat prywatny
Temat: "ci-deployments" (Prywatny)

# 2. Utwórz token dostępu
Nazwa: "GitHub Actions"
Uprawnienia: Tylko publikowanie

# 3. Dodaj token do GitHub Secrets
NOTIFER_TOPIC_TOKEN=tk_...

# 4. Użyj w przepływie pracy
curl -d "Deploy completed" \
  -H "X-Topic-Token: ${{ secrets.NOTIFER_TOPIC_TOKEN }}" \
  https://app.notifer.io/ci-deployments

Alerty monitorowania serwera

# 1. Utwórz temat prywatny
Temat: "server-alerts" (Prywatny)

# 2. Utwórz token dostępu
Nazwa: "Monitoring Script"
Uprawnienia: Tylko publikowanie

# 3. Wysyłaj alerty
curl -d "CPU usage critical" \
  -H "X-Priority: 1" \
  -H "X-Topic-Token: tk_..." \
  https://app.notifer.io/server-alerts

Rozwiązywanie problemów

Nie można uzyskać dostępu do ustawień tematu

Problem: Przycisk ustawień nie jest widoczny lub wyszarzony

Rozwiązanie:

• Tylko właściciele tematów mogą uzyskać dostęp do ustawień
• Zweryfikuj, że jesteś zalogowany jako poprawny użytkownik
• Sprawdź, czy przeglądasz swój własny temat w "Moje tematy"

Token dostępu nie działa

Problem: 401 Unauthorized przy użyciu tokenu

Rozwiązanie:

• Zweryfikuj, że token nie został odwołany (sprawdź zakładkę Tokeny dostępu)
• Upewnij się, że używasz poprawnego nagłówka: X-Topic-Token (nie X-API-Key)
• Sprawdź, czy token ma wymagane uprawnienie (publikowanie lub subskrybowanie)
• Zweryfikuj brak literówek w tokenie (zalecane kopiowanie-wklejanie)

Kolejne kroki

• Tokeny dostępu do tematów - Szczegółowy przewodnik uwierzytelniania
• Publikowanie wiadomości - Wysyłaj powiadomienia do swoich tematów
• Tworzenie tematów - Tworzenie i organizacja tematów