Przejdź do treści

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
  2. Przejdź do app.notifer.io
  3. Znajdź swój temat w zakładce "Moje tematy"

  4. Kliknij ikonę koła zębatego (⚙️) obok nazwy tematu

  5. Ze strony tematu

  6. Otwórz temat: app.notifer.io/topic/your-topic
  7. 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.

Tworzenie tokenów dostępu

  1. Przejdź do zakładki Tokeny dostępu
  2. Kliknij "Utwórz token"
  3. Wprowadź szczegóły tokenu:
  4. Nazwa - Identyfikator (np. "CI Pipeline", "Monitoring Script")
  5. Uprawnienia - Wybierz, co token może robić:
    • ✅ Publikuj - Wysyłaj wiadomości do tematu
    • ✅ Subskrybuj - Otrzymuj wiadomości z tematu
    • ✅ Oba - Pełny dostęp
  6. Kliknij "Utwórz"
  7. Skopiuj token (pokazywany tylko raz!)

Zapisz swój token

Token jest wyświetlany tylko raz. Zapisz go natychmiast w bezpiecznym miejscu.

Używanie tokenów dostępu

W żądaniach HTTP: 

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

W skryptach: 

# Przechowuj w zmiennej środowiskowej
export NOTIFER_TOKEN="tk_..."

# Użyj w automatyzacji
curl -d "Build completed" \
  -H "X-Topic-Token: $NOTIFER_TOKEN" \
  https://app.notifer.io/deployments

Zobacz Przewodnik tokenów dostępu do tematów po szczegółowe przykłady użycia.

Zarządzanie tokenami

Wyświetl użycie tokenu: - Ostatnio użyty - Kiedy token był ostatnio używany - Całkowita liczba żądań - Liczba wywołań API - Utworzony - Kiedy token został utworzony

Odwołaj token: 1. Znajdź token na liście 2. Kliknij "Odwołaj" lub "Usuń" 3. Potwierdź akcję

Odwołanie jest natychmiastowe

Po odwołaniu token natychmiast przestaje działać. Wszystkie integracje używające tego tokenu zawiodą.

Najlepsze praktyki tokenów

Zalecane: - Twórz oddzielne tokeny dla każdej integracji - Używaj opisowych nazw ("GitHub Actions", "Monitoring Script") - Przyznawaj minimalne uprawnienia (tylko publikowanie, jeśli to wszystko, czego potrzebujesz) - Regularnie odwoływaj nieużywane tokeny

Niezalecane: - Udostępniaj ten sam token w wielu usługach - Przyznawaj zarówno publikowanie, jak i subskrybowanie, jeśli potrzebne jest tylko jedno - Commituj tokeny do kontroli wersji - Udostępniaj tokeny w zwykłym tekście (e-mail, Slack)

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 60 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
FREE 7 dni 3 dni
ESSENTIALS 30 dni 7 dni
TEAM/BUSINESS 45 dni 7 dni

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: 5" \
  -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