RankVoyager
Docs

Integracja ze Slack

Integracja Slack dostępna jest w planie Voyager Pro. Alerty wysyłane są jako sformatowane wiadomości Slack z ikonami statusu, kolorowym paskiem bocznym i przyciskiem link do dashboardu - bezpośrednio na wybrany kanał Slack Twojego workspace.

ℹ️ Integracja Slack wymaga planu Voyager Pro. Użytkownicy planu Basic mogą korzystać z alertów Discord i Email.

Metoda: Incoming Webhooks

Używamy Slack Incoming Webhooks - najprostszej i najbezpieczniejszej metody integracji. Nie wymaga instalowania aplikacji Slack ani OAuth - wystarczy URL Webhook.

Krok po kroku: konfiguracja Slack

1

Przejdź do Slack API - Twoje aplikacje

Otwórz api.slack.com/apps i zaloguj się do Slack. Kliknij Create New App.

2

Utwórz aplikację "From scratch"

Wybierz From scratch, nadaj aplikacji nazwę (np. "RankVoyager") i wybierz workspace, do którego chcesz ją dodać. Kliknij Create App.

3

Włącz Incoming Webhooks

W menu po lewej wybierz Incoming Webhooks. Przełącz przełącznik Activate Incoming Webhooks na On.

4

Dodaj Webhook do Workspace

Przewiń w dół i kliknij Add New Webhook to Workspace. Wybierz kanał (np. #monitoring) i kliknij Allow.

Slack wygeneruje URL Webhook. Skopiuj go - wygląda tak:

https://hooks.slack.com/services/T00000000/B00000000/XXXX...
5

Wklej URL w RankVoyager

W RankVoyager: Ustawienia domeny → Powiadomienia → Slack → Dodaj Webhook. Wklej URL i kliknij Zapisz i przetestuj. Sprawdź czy testowa wiadomość pojawiła się na kanale Slack.

Wskazówki dla zespołów

  • Dedykowany kanał alertów - utwórz kanał #rankvoyager-alerty zamiast używać głównego kanału firmy. Łatwiej zarządzać i przeglądać historię.
  • Różne kanały per domena - jeśli zarządzasz wieloma klientami, każdy może mieć swój kanał Slack i swój Webhook URL.
  • @mentions - w przyszłości planujemy obsługę tagowania konkretnych osób (np. @devops) w alertach o krytycznych incydentach.

Rozwiązywanie problemów

Testowa wiadomość nie dotarła

Sprawdź czy URL jest kompletny i nie został obcięty. Sprawdź czy aplikacja Slack jest aktywna w workspace (api.slack.com/apps → Twoja aplikacja → status).

Błąd "channel_not_found"

Kanał wybrany podczas tworzenia Webhook mógł zostać usunięty lub zmieniona jego nazwa. Utwórz nowy Webhook wskazujący na istniejący kanał.