Współpraca zespołowa¶

Plan TEAM w Notifer umożliwia wielu użytkownikom współpracę nad wspólnymi tematami powiadomień, co czyni go idealnym dla zespołów programistycznych, grup DevOps i działów biznesowych.

Przegląd¶

Z planem TEAM możesz:

Tworzyć zespoły z wieloma członkami
Udostępniać tematy powiadomień w całym zespole
Przypisywać role z różnymi poziomami uprawnień
Wykorzystywać subskrypcję właściciela zespołu dla wszystkich członków zespołu
Publikować wspólnie używając wspólnej puli limitów szybkości

Ekonomiczna współpraca

Tylko właściciel zespołu potrzebuje subskrypcji TEAM ($24/miesiąc baza). Wszyscy członkowie zespołu mogą używać kont FREE tier i nadal publikować do tematów zespołowych z hojnymi limitami właściciela.

Kluczowe pojęcia¶

Zespoły¶

Zespół to grupa użytkowników, którzy współpracują nad wspólnymi tematami powiadomień. Każdy zespół ma:

Jednego właściciela (wymaga subskrypcji TEAM)
Wielu członków (mogą mieć konta FREE tier)
Wspólne tematy, do których wszyscy członkowie mogą publikować
Scentralizowane limity szybkości oparte na subskrypcji właściciela

Tematy zespołowe¶

Tematy zespołowe to kanały powiadomień należące do zespołu:

Tworzone przez właściciela zespołu lub administratorów
Wszyscy członkowie zespołu mogą do nich publikować
Używają limitów szybkości i retencji właściciela zespołu
Mogą być publiczne lub prywatne
Prywatne tematy zespołowe mogą być ustawione jako odkrywalne (publiczny dostęp tylko do odczytu)

Role¶

Zespoły mają trzy poziomy ról:

Rola	Opis	Wymagana subskrypcja
OWNER	Pełna kontrola nad zespołem i płatnościami	TEAM ($24/mies. + $5/dodatkowy użytkownik)
ADMIN	Zarządzaj członkami i tematami	FREE+ (dowolny poziom)
MEMBER	Publikuj do tematów zespołowych	FREE+ (dowolny poziom)

Tworzenie zespołu¶

Wymagania wstępne¶

Aktywna subskrypcja TEAM ($24/mies. baza + $5/dodatkowy użytkownik)
Zweryfikowany adres e-mail

Kroki¶

Przejdź do strony Zespoły w swoim panelu
Kliknij przycisk "Utwórz zespół"
Wprowadź szczegóły zespołu:
Nazwa zespołu: Wybierz opisową nazwę (np. "Engineering", "DevOps")
Opis: Opcjonalny opis celu zespołu
Kliknij "Utwórz"

Twój zespół jest teraz utworzony i automatycznie jesteś ustawiony jako OWNER.

Zapraszanie członków zespołu¶

Kto może zapraszać¶

Właściciel zespołu
Administrator zespołu

Proces zapraszania¶

Przejdź do strony szczegółów zespołu
Kliknij "Zaproś członka"
Wprowadź adres e-mail członka
Wybierz ich rolę:
ADMIN: Może zarządzać członkami i tematami
MEMBER: Może tylko publikować do tematów
Kliknij "Wyślij zaproszenie"

E-mail z zaproszeniem¶

Zaproszony otrzymuje e-mail z:

Nazwą zespołu i informacją kto zaprosił
Przypisaną rolą
Linkiem zaproszenia (ważnym przez 7 dni)
Instrukcjami akceptacji

Akceptowanie zaproszeń¶

Jeśli zaproszony ma konto:

Kliknij link zaproszenia
Zaloguj się do swojego konta
Zaproszenie jest automatycznie zaakceptowane
Zostaje przekierowany na stronę zespołu

Jeśli zaproszony nie ma konta:

Kliknij link zaproszenia
Zobacz szczegóły zaproszenia
Utwórz konto FREE (nie wymaga płatności)
Zaproszenie jest automatycznie zaakceptowane
Zostaje przekierowany na stronę zespołu

Witamy konta FREE

Członkowie zespołu nie muszą aktualizować z poziomu FREE. Mogą publikować do tematów zespołowych używając limitów poziomu TEAM właściciela.

Zarządzanie oczekującymi zaproszeniami¶

Oczekujące zaproszenia pojawiają się na liście członków zespołu z żółtym tłem.

Dostępne akcje:

Wyślij ponownie: Wyślij e-mail z zaproszeniem ponownie
Anuluj: Odwołaj zaproszenie

Zaproszenia automatycznie wygasają po 7 dniach.

Dodawanie członków do wielu zespołów¶

Polityka rozliczeniowa członków

Liczenie unikalnych członków: Jeśli posiadasz wiele zespołów i dodasz tę samą osobę do więcej niż jednego zespołu, liczą się jako jedno miejsce członka w Twoim rozliczeniu, a nie wiele.

Przykład:

Masz plan TEAM z 3 bazowymi miejscami członków (włączone) i tworzysz dwa zespoły:

Zespół Engineering: Alice, Bob, Charlie
Zespół DevOps: Alice, Bob, David

Mimo że Alice i Bob są w obu zespołach (4 członkostwa razem), zajmują tylko 2 miejsca członków, ponieważ rozliczenia liczą unikalnych użytkowników.

Całkowita liczba unikalnych członków: Alice, Bob, Charlie, David = 4 członków

Twoje rozliczenie: - Plan bazowy: 3 członków włączonych = $24/mies. - Dodatkowy członek: 1 × $5 = $5/mies. - Razem: $29/mies. ✅

Proces zapraszania:

Gdy zapraszasz kogoś, kto jest już w innym Twoim zespole:

System zezwala na zaproszenie (nie duplikat)
Otrzymują nowy e-mail z zaproszeniem do drugiego zespołu
Muszą zaakceptować zaproszenie, aby dołączyć do drugiego zespołu
Brak dodatkowej opłaty rozliczeniowej (ta sama osoba liczona raz)

Ten projekt pozwala elastycznie organizować członków w zespołach bez kar rozliczeniowych.

Role i uprawnienia zespołu¶

OWNER¶

Pełna kontrola nad zespołem

✅ Może:

Edytować szczegóły zespołu (nazwa, opis)
Usunąć zespół
Zapraszać i usuwać wszystkich członków
Zmieniać role członków (w tym administratorów)
Tworzyć, edytować i usuwać tematy zespołowe
Zarządzać tokenami dostępu do tematów
Publikować do wszystkich tematów zespołowych

❌ Nie może:

Opuścić zespołu (musi usunąć zespół lub przekazać własność)
Usunąć siebie jako właściciela

Wymagana subskrypcja

Właściciel zespołu musi utrzymywać aktywną subskrypcję TEAM. Jeśli obniży poziom, zespół staje się nieaktywny i członkowie nie mogą publikować do tematów zespołowych.

ADMIN¶

Uprawnienia zarządzania codziennego

✅ Może:

Zapraszać i usuwać zwykłych członków
Zmieniać role tylko dla zwykłych członków
Tworzyć i edytować tematy zespołowe (nie może usuwać)
Zarządzać tokenami dostępu do tematów
Publikować do wszystkich tematów zespołowych
Wyświetlać wszystkie szczegóły zespołu

❌ Nie może:

Edytować ustawień zespołu
Usuwać zespołu
Usuwać tematów zespołowych
Usuwać lub degradować innych administratorów
Usuwać lub degradować właściciela
Zmieniać swojej roli

Nie wymaga subskrypcji

Administratorzy mogą używać kont FREE tier. Korzystają z limitów poziomu TEAM właściciela zespołu podczas publikowania do tematów zespołowych.

MEMBER¶

Rola skoncentrowana na publikowaniu

✅ Może:

Publikować do wszystkich tematów zespołowych
Wyświetlać tematy zespołowe
Subskrybować tematy zespołowe
Generować osobiste klucze API
Wysyłać testowe powiadomienia

❌ Nie może:

Tworzyć ani zarządzać tematami
Zapraszać ani zarządzać innymi członkami
Edytować ustawień zespołu
Zarządzać tokenami dostępu do tematów
Usuwać czegokolwiek

Idealne dla programistów

Członkowie mogą używać kont FREE tier i publikować nieograniczoną liczbę wiadomości do tematów zespołowych (w ramach limitów właściciela zespołu).

Tworzenie tematów zespołowych¶

Kto może tworzyć¶

Właściciel zespołu
Administrator zespołu

Kroki¶

Kliknij "Utwórz temat" w panelu
Wprowadź szczegóły tematu:
Nazwa tematu: Użyj opisowej nazwy (np. "deployment-prod")
Poziom dostępu:
- Publiczny: Każdy może subskrybować i publikować
- Prywatny: Tylko członkowie zespołu mogą publikować
Odkrywalność:
- Tematy publiczne: Pokaż w publicznym katalogu
- Tematy prywatne: Zezwól na publiczne subskrypcje tylko do odczytu (subskrybenci mogą przeglądać, ale nie mogą publikować)
Wybierz swój zespół z listy rozwijanej
Kliknij "Utwórz"

Odkrywalne prywatne tematy zespołowe

Ustaw prywatny temat zespołowy jako odkrywalny, gdy chcesz, aby użytkownicy zewnętrzni mogli otrzymywać powiadomienia bez dawania im dostępu do publikowania.

Temat jest teraz utworzony i:

Widoczny dla wszystkich członków zespołu
Możliwy do publikowania przez wszystkich członków zespołu
Używa retencji właściciela zespołu (90 dni)
Liczony w użyciu właściciela zespołu

Najlepsze praktyki nazewnictwa tematów¶

Używaj spójnych konwencji nazewnictwa:

✅ Dobre przykłady:
deployment-production
deployment-staging
errors-backend
alerts-critical
metrics-cpu

❌ Złe przykłady:
prod-deploy
staging_deployment
backend_errors
CriticalAlerts
cpu_metrics

Zalecane wzorce:

{cel}-{środowisko}: deployment-prod, deployment-staging
{typ}-{komponent}: errors-backend, errors-frontend
{kategoria}-{poziom}: alerts-critical, alerts-warning

Publikowanie do tematów zespołowych¶

Wszyscy członkowie zespołu (Owner, Admin, Member) mogą publikować do tematów zespołowych.

Interfejs webowy¶

Przejdź do strony tematu
Wprowadź swoją wiadomość
Opcjonalnie ustaw:
Tytuł: Nagłówek wiadomości
Priorytet: 1 (niski) do 5 (pilny)
Tagi: Tagi kategoryzacji
Kliknij "Publikuj"

HTTP/cURL¶

Z osobistym kluczem API (zalecane)¶

curl -d "Deployment completed successfully" \
  -H "X-API-Key: your_personal_api_key" \
  -H "X-Title: Deployment" \
  -H "X-Priority: 3" \
  https://app.notifer.io/deployment-prod

Osobiste klucze API

Wszyscy członkowie zespołu (w tym FREE tier) mogą generować osobiste klucze API w Ustawienia → Klucze API. Są one bezpieczniejsze niż wspólne tokeny.

Z tokenem JWT¶

curl -d "Deployment completed successfully" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "X-Title: Deployment" \
  -H "X-Priority: 3" \
  https://app.notifer.io/deployment-prod

Z tokenem dostępu do tematu¶

curl -d "Deployment completed successfully" \
  -H "X-Topic-Token: tk_team_topic_token" \
  -H "X-Title: Deployment" \
  -H "X-Priority: 3" \
  https://app.notifer.io/deployment-prod

Bezpieczeństwo tokenów

Tokeny dostępu do tematów są udostępniane między członkami zespołu i systemami zewnętrznymi. Używaj osobistych kluczy API, gdy to możliwe, dla lepszego bezpieczeństwa i śladów audytu.

Limity szybkości i użycie¶

Jak działają limity szybkości zespołu¶

Notifer używa limitowania szybkości świadomego zespołu:

Dla tematów zespołowych:

Limity szybkości oparte na poziomie subskrypcji właściciela zespołu
Wszyscy członkowie zespołu dzielą tę samą pulę
Użycie liczone względem konta właściciela zespołu

Dla tematów osobistych:

Limity szybkości oparte na własnym poziomie subskrypcji użytkownika
Użycie liczone względem własnego konta użytkownika

Poziomy limitów szybkości¶

Poziom	Na minutę	Na godzinę	Na dzień
FREE	10	100	1 000
ESSENTIALS	30	300	10 000
TEAM	60	500	100 000
BUSINESS	120	1 000	250 000

Przykładowe scenariusze¶

Scenariusz 1: Członek publikujący do tematu zespołowego¶

Zespół: "Engineering"
Właściciel: alice@company.com (poziom TEAM)
Członek: bob@company.com (poziom FREE)
Temat zespołowy: "deployment-prod"

Gdy bob publikuje do "deployment-prod":
✅ Używa limitów TEAM Alice (60/min, 500/godz, 100k/dzień)
✅ NIE używa limitów FREE Boba
✅ Liczone w panelu użycia Alice

Scenariusz 2: Członek publikujący do tematu osobistego¶

Członek: bob@company.com (poziom FREE)
Temat osobisty: "bob-personal"

Gdy bob publikuje do "bob-personal":
✅ Używa limitów FREE Boba (10/min, 100/godz, 1k/dzień)
✅ NIE wpływa na limity zespołu
✅ Liczone w panelu użycia Boba

Panel użycia¶

Widok właściciela zespołu:

Właściciel zespołu widzi kompleksowe statystyki użycia, w tym:

Całkowite użycie z tematów osobistych + zespołowych łącznie
Liczba członków zespołu (unikalni członkowie vs limit - ta sama osoba w wielu zespołach liczona raz)
Podział na członka - zobacz kto publikuje najwięcej
Podział na temat - zidentyfikuj tematy o dużym ruchu

Dostęp do panelu użycia w Ustawienia → Użycie lub przez API na /api/usage.

Przykładowy panel właściciela zespołu:

{
  "usage": {
    "daily_messages": {
      "used": 1234,
      "remaining": 98766,
      "limit": 100000
    },
    "team_breakdown": {
      "teams": [
        {
          "team_name": "Engineering",
          "total_messages_today": 1234,
          "per_member": [
            {
              "email": "alice@team.com",
              "role": "ADMIN",
              "messages_published": 789
            },
            {
              "email": "bob@team.com",
              "role": "MEMBER",
              "messages_published": 345
            }
          ],
          "per_topic": [
            {
              "topic_name": "deployment-prod",
              "messages_today": 456
            },
            {
              "topic_name": "errors-backend",
              "messages_today": 778
            }
          ]
        }
      ]
    }
  }
}

Czego możesz się dowiedzieć z podziału:

Najbardziej aktywni członkowie: Zidentyfikuj głównych użytkowników
Tematy o dużym ruchu: Które tematy zużywają większość limitów
Nieaktywni członkowie: Członkowie z 0 wiadomości (kandydaci do usunięcia)
Wzorce użycia: Planuj pojemność i optymalizuj strukturę tematów

Widok członka zespołu:

Pokazuje tylko użycie tematów osobistych
Publikacje do tematów zespołowych nie pojawiają się w użyciu członka
Członkowie nie mogą zobaczyć podziału zespołu (tylko właściciel)

Błędy limitów szybkości¶

Gdy limity są przekroczone:

Limit tematu zespołowego:

429 Too Many Requests
Team rate limit exceeded. The team owner's TEAM plan allows
60 messages per minute. Try again in 42 seconds.

Limit tematu osobistego:

429 Too Many Requests
Rate limit exceeded. Your FREE plan allows 10 messages per
minute. Try again in 38 seconds.

Zarządzanie członkami zespołu¶

Wyświetlanie członków¶

Przejdź do strony zespołu, aby zobaczyć:

Aktywnych członków z ich rolami
Oczekujące zaproszenia (żółte tło)
Daty dołączenia członków

Zmiana ról¶

Kto może zmieniać role:

Właściciel: Może zmieniać rolę dowolnego członka
Administrator: Może zmieniać tylko role zwykłych członków (nie innych administratorów)

Kroki:

Znajdź członka na liście członków zespołu
Kliknij ich aktualną odznakę roli
Wybierz nową rolę z listy rozwijanej
Potwierdź zmianę

Usuwanie członków¶

Kto może usuwać:

Właściciel: Może usunąć każdego oprócz siebie
Administrator: Może usuwać tylko zwykłych członków

Kroki:

Znajdź członka na liście członków zespołu
Kliknij menu trzech kropek (⋮)
Wybierz "Usuń z zespołu"
Potwierdź usunięcie

Natychmiastowy efekt

Usunięci członkowie tracą dostęp do tematów zespołowych natychmiast. Nie mogą już publikować ani subskrybować tematów zespołowych.

Tokeny dostępu do tematów¶

Czym są?¶

Tokeny dostępu do tematów to wspólne tokeny uwierzytelniające, które pozwalają:

Systemom zewnętrznym (CI/CD, monitorowanie) publikować
Wspólnym usługom wysyłać powiadomienia
Publikowaniu tylko przez API bez kont użytkowników

Kto może zarządzać¶

Właściciel zespołu
Administrator zespołu

Tworzenie tokenów¶

Przejdź do tematu zespołowego
Kliknij "Zarządzaj tokenami dostępu"
Kliknij "Utwórz token"
Ustaw uprawnienia:
Odczyt: Może subskrybować i czytać wiadomości
Zapis: Może publikować wiadomości
Odczyt+Zapis: Oba uprawnienia
Skopiuj token (pokazywany tylko raz)

Bezpieczeństwo tokenu

Tokeny dostępu do tematów są pokazywane tylko raz podczas tworzenia. Przechowuj je bezpiecznie (np. GitHub Secrets, zmienne środowiskowe).

Używanie tokenów¶

# W pipeline CI/CD
curl -d "Build #$BUILD_NUMBER deployed" \
  -H "X-Topic-Token: tk_your_token_here" \
  -H "X-Title: CI/CD" \
  https://app.notifer.io/deployment-prod

Odwoływanie tokenów¶

Przejdź do "Zarządzaj tokenami dostępu"
Znajdź token do odwołania
Kliknij "Odwołaj"
Potwierdź

Token jest natychmiast unieważniony.

Osobiste klucze API vs tokeny tematów¶

Osobiste klucze API¶

Zalecane dla:

Indywidualnych programistów
Lokalnego rozwoju
Osobistych skryptów i automatyzacji

Zalety:

Powiązane z kontem użytkownika (ślad audytu)
Dostęp do wszystkich tematów, do których użytkownik może publikować
Można rotować bez wpływu na zespół
Bardziej bezpieczne (nie udostępniane)

Jak utworzyć:

Ustawienia → Klucze API → Wygeneruj nowy klucz

Tokeny dostępu do tematów¶

Zalecane dla:

Pipeline CI/CD
Wspólnych narzędzi monitorujących
Usług zewnętrznych
Automatyzacji na poziomie zespołu

Zalety:

Nie powiązane z indywidualnymi użytkownikami
Można bezpiecznie udostępniać w zespole
Uprawnienia specyficzne dla tematu
Zarządzane przez właściciela/administratora

Jak utworzyć:

Strona tematu → Zarządzaj tokenami dostępu → Utwórz token

Najlepsza praktyka

Używaj osobistych kluczy API, gdy to możliwe, dla lepszego bezpieczeństwa i odpowiedzialności. Używaj tokenów dostępu do tematów tylko dla naprawdę wspólnych usług.

Ustawienia zespołu¶

Edycja szczegółów zespołu¶

Kto może edytować: Tylko właściciel

Kroki:

Przejdź do strony zespołu
Kliknij "Edytuj zespół"
Zaktualizuj:
Nazwa zespołu
Opis
Kliknij "Zapisz"

Usuwanie zespołu¶

Kto może usunąć: Tylko właściciel

Akcja nieodwracalna

Usunięcie zespołu jest nieodwracalne i nie może zostać cofnięte.

Co zostaje usunięte:

Zespół i wszystkie tematy zespołowe
Wszystkie wiadomości w tematach zespołowych
Powiązania członków zespołu
Tokeny dostępu do tematów

Co NIE jest usuwane:

Konta członków zespołu
Osobiste tematy członków
Subskrypcje członków

Kroki:

Przejdź do strony zespołu
Kliknij "Usuń zespół"
Wpisz nazwę zespołu, aby potwierdzić
Kliknij "Usuń na stałe"

Monitorowanie użycia zespołu¶

Dostęp do statystyk użycia¶

Właściciele zespołów mogą monitorować szczegółowe statystyki użycia, aby optymalizować wydajność zespołu i identyfikować problemy.

Metody dostępu:

Panel internetowy: Ustawienia → Użycie
Endpoint API: GET /api/usage (wymaga uwierzytelniania)

Zrozumienie podziału¶

Statystyki na członka¶

Zobacz dokładnie, ile wiadomości opublikował każdy członek zespołu dzisiaj:

Przypadki użycia:

Zidentyfikuj głównych użytkowników: Członkowie publikujący najwięcej wiadomości
Wykryj nieaktywnych członków: Członkowie z 0 wiadomości w czasie
Zbalansuj obciążenie: Rozłóż publikowanie między członków zespołu
Rozwiązywanie problemów: Jeśli limity są osiągnięte, zobacz kto publikuje najwięcej

Przykład:

alice@team.com (ADMIN): 789 wiadomości
bob@team.com (MEMBER): 345 wiadomości
charlie@team.com (MEMBER): 0 wiadomości  ← Nieaktywny?

Akcje, które możesz podjąć:

Usuń nieaktywnych członków, aby zwolnić miejsca w zespole
Skontaktuj się z wydawcami o dużej objętości, aby zoptymalizować ich integracje
Zaktualnij do poziomu BUSINESS, jeśli konsekwentnie osiągasz limity

Statystyki na temat¶

Zobacz, które tematy generują najwięcej ruchu:

Przypadki użycia:

Optymalizuj tematy o dużym ruchu: Zmniejsz gadatliwe logi lub grupuj wiadomości
Zidentyfikuj nieużywane tematy: Tematy z 0 wiadomości (kandydaci do usunięcia)
Planowanie pojemności: Wiedz, które tematy optymalizować, jeśli zbliżasz się do limitów
Organizacja tematów: Restrukturyzuj tematy na podstawie rzeczywistego użycia

Przykład:

errors-backend: 778 wiadomości   ← Duży ruch - optymalizować?
deployment-prod: 456 wiadomości
metrics-cpu: 0 wiadomości        ← Nieużywany - usunąć?

Akcje, które możesz podjąć:

Filtruj gadatliwe tematy u źródła
Archiwizuj lub usuwaj nieużywane tematy
Podziel tematy o dużym ruchu na podtematy
Grupuj wiadomości, gdy to możliwe

Codzienny przepływ monitorowania¶

Zalecane dla właścicieli zespołów:

Cotygodniowy sprawdzian: Przeglądaj panel użycia każdy poniedziałek
Szukaj anomalii:
Nagłe skoki w określonych tematach
Członkowie z nieoczekiwanymi 0 wiadomościami
Tematy zużywające >30% dziennego limitu
Podejmij działanie:
Skontaktuj się z członkami w sprawie nietypowych wzorców
Optymalizuj tematy o dużym ruchu
Usuń nieaktywnych członków

Dostęp do API dla automatyzacji¶

Zintegruj monitorowanie użycia z przepływem pracy ops:

# Pobierz statystyki użycia
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://app.notifer.io/api/usage

# Parsuj z jq
curl -s -H "Authorization: Bearer YOUR_TOKEN" \
  https://app.notifer.io/api/usage | \
  jq '.usage.team_breakdown.teams[0].per_topic[] |
      select(.messages_today > 1000)'

Przykład alertowania:

#!/bin/bash
# Alertuj, jeśli jakikolwiek temat przekracza 10k wiadomości/dzień

USAGE=$(curl -s -H "Authorization: Bearer $TOKEN" \
  https://app.notifer.io/api/usage)

HIGH_TRAFFIC=$(echo $USAGE | jq -r \
  '.usage.team_breakdown.teams[0].per_topic[] |
   select(.messages_today > 10000) | .topic_name')

if [ -n "$HIGH_TRAFFIC" ]; then
  echo "High traffic topics: $HIGH_TRAFFIC"
  # Wyślij alert przez e-mail/Slack/itp.
fi

Najlepsze praktyki¶

Organizacja zespołu¶

Definiuj jasne role
Użyj Owner dla rozliczeń i krytycznych decyzji
Użyj Admins dla codziennego zarządzania (zalecane 1-2 administratorów)
Użyj Members dla programistów, którzy tylko muszą publikować
Regularne audyty
Przeglądaj członków zespołu kwartalnie
Usuwaj nieaktywnych członków
Anuluj osierocone zaproszenia
Konwencje nazewnictwa
Używaj spójnych wzorców nazw tematów w zespole
Dokumentuj wzorce nazewnictwa w wiki/dokumentacji zespołu
Użyj prefiksów dla środowisk (prod-, staging-, dev-)

Bezpieczeństwo¶

Regularnie rotuj tokeny dostępu
Minimum co 90 dni
Po odejściu członka zespołu
Po podejrzeniu kompromitacji
Używaj odpowiednich typów tokenów
Osobiste klucze API dla indywidualnych osób
Tokeny dostępu do tematów dla wspólnych systemów
Minimalne wymagane uprawnienia
Tematy prywatne dla wrażliwych danych
Logi błędów ze śladami stosu
Powiadomienia o wdrożeniach ze szczegółami serwera
Alerty specyficzne dla klienta

Zarządzanie limitami szybkości¶

Monitoruj użycie
Sprawdzaj panel cotygodniowo
Ustaw alerty przy progu 80%
Planuj aktualizacje przed osiągnięciem limitów
Optymalizuj tematy o dużej objętości
Grupuj wiadomości, gdy to możliwe
Używaj odpowiednich poziomów priorytetów
Filtruj gadatliwe logi przed publikowaniem
Rozdziel zagadnienia
Różne tematy dla różnych środowisk
Oddziel logi debugowania od krytycznych alertów
Używaj tagów do kategoryzacji

Typowe scenariusze¶

Konfiguracja zespołu programistów¶

Cel: Utwórz zespół dla 5 programistów do udostępniania powiadomień o wdrożeniach

Kroki:

Właściciel (alice@company.com) subskrybuje plan TEAM ($29/miesiąc)
Alice tworzy zespół "Engineering"
Alice zaprasza 4 programistów jako Members (wszyscy mogą używać FREE tier)
Alice tworzy tematy:
deployment-production (prywatny)
deployment-staging (prywatny)
errors-backend (prywatny)
alerts-critical (publiczny)
Wszyscy programiści mogą teraz publikować do tych tematów używając limitów poziomu TEAM Alice

Wynik:

✅ Jedna subskrypcja pokrywa cały zespół
✅ 100 000 wiadomości/dzień dzielonych w zespole
✅ Retencja wiadomości przez 90 dni
✅ Wszyscy programiści mogą swobodnie publikować

Integracja CI/CD¶

Cel: GitHub Actions publikuje powiadomienia o wdrożeniach

Kroki:

Administrator tworzy token dostępu do tematu dla deployment-prod
Token przechowywany w GitHub Secrets jako NOTIFER_TOKEN

Przepływ pracy GitHub Actions:

- name: Notify deployment
  run: |
    curl -d "Deployed to production" \
      -H "X-Topic-Token: ${{ secrets.NOTIFER_TOKEN }}" \
      https://app.notifer.io/deployment-prod

Wynik:

✅ Automatyczne powiadomienia o wdrożeniach
✅ Brak danych uwierzytelniających użytkownika w pipeline
✅ Token może być rotowany przez dowolnego administratora

Rozwiązywanie problemów¶

Nie można utworzyć zespołu¶

Błąd: "Wymagana aktualizacja do planu TEAM"

Rozwiązanie:

Przejdź do Ustawienia → Subskrypcja
Kliknij "Uaktualnij do TEAM"
Dokończ płatność
Spróbuj ponownie utworzyć zespół

Zaproszenie nie otrzymane¶

Możliwe przyczyny:

E-mail w folderze spam
Literówka w adresie e-mail
Opóźnienie doręczenia e-maila

Rozwiązania:

Sprawdź folder spam
Wyślij ponownie zaproszenie ze strony zespołu
Anuluj i utwórz nowe zaproszenie z poprawnym e-mailem

Członek nie może publikować¶

Możliwe przyczyny:

Wyczerpane limity szybkości właściciela zespołu
Właściciel zespołu obniżył subskrypcję
Temat jest osobisty, nie zespołowy

Debugowanie:

Sprawdź typ tematu:
Przejdź do strony tematu
Szukaj odznaki "Zespół: [nazwa]"
Sprawdź użycie właściciela zespołu:
Właściciel powinien sprawdzić panel
Szukaj ostrzeżeń o dziennym/godzinnym limicie
Sprawdź status zespołu:
Zweryfikuj, że właściciel ma aktywną subskrypcję TEAM
Sprawdź, że zespół nie jest oznaczony jako nieaktywny

Limity szybkości za niskie¶

Scenariusz: Zespół często osiąga limit 100k/dzień

Rozwiązania:

Natychmiastowe:
Zmniejsz częstotliwość odpytywania
Filtruj wiadomości o niskim priorytecie
Grupuj, gdy to możliwe
Długoterminowe:
Zaktualnij do poziomu BUSINESS (250k/dzień)
Optymalizuj wyzwalacze powiadomień
Przejrzyj architekturę tematów

FAQ¶

Czy wszyscy członkowie zespołu potrzebują subskrypcji TEAM?

Nie! Tylko właściciel zespołu potrzebuje subskrypcji TEAM ($29/miesiąc). Wszyscy inni członkowie mogą używać kont FREE tier i nadal publikować do tematów zespołowych z limitami poziomu TEAM właściciela.

Co się stanie, jeśli właściciel obniży poziom?

Zespół staje się nieaktywny. Tematy zespołowe pozostają, ale członkowie nie mogą do nich publikować. Zespół może być reaktywowany przez aktualizację z powrotem do poziomu TEAM.

Czy członkowie mogą tworzyć tematy?

Nie. Tylko właściciel zespołu i administratorzy mogą tworzyć tematy zespołowe. Zwykli członkowie mogą tylko publikować do istniejących tematów.

Jak różnią się tematy osobiste od zespołowych?

Tematy zespołowe używają limitów szybkości i retencji właściciela. Tematy osobiste używają limitów własnego poziomu użytkownika. Członkowie korzystają z poziomu TEAM właściciela tylko dla tematów zespołowych.

Czy mogę przenieść własność zespołu?

Obecnie transfer własności nie jest dostępny przez interfejs. Skontaktuj się z support@notifer.io w sprawie pomocy z transferami własności.

Jaka jest różnica między Administratorami a Członkami?

Administratorzy mogą zarządzać członkami zespołu, tworzyć/edytować tematy i zarządzać tokenami dostępu. Członkowie mogą tylko publikować do tematów - idealni dla programistów, którzy nie potrzebują dostępu do zarządzania.

Ile zespołów mogę utworzyć?

Nie ma twardego limitu na zespoły, ale potrzebujesz subskrypcji TEAM dla każdego zespołu, którego jesteś właścicielem. Możesz być członkiem nieograniczonej liczby zespołów bez żadnej subskrypcji.

Czy mogę zobaczyć, który członek zespołu opublikował wiadomość?

Jeśli członkowie używają osobistych kluczy API, tak - metadane wiadomości zawierają wydawcę. Z tokenami dostępu do tematów, nie - są one wspólne i nie śledzą indywidualnych wydawców.

Kolejne kroki¶

Tworzenie tematów - Dowiedz się o tworzeniu tematów
Klucze API - Generuj osobiste klucze API
Tokeny dostępu do tematów - Zarządzaj wspólnymi tokenami
Ustawienia użytkownika - Skonfiguruj swoje konto

Potrzebujesz pomocy?

Sprawdź FAQ po częste pytania
Zobacz Rozwiązywanie problemów po rozwiązywanie problemów
Skontaktuj się z obsługą: support@notifer.io