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.
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
Przejdź do Slack API - Twoje aplikacje
Otwórz api.slack.com/apps i zaloguj się do Slack. Kliknij Create New App.
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.
Włącz Incoming Webhooks
W menu po lewej wybierz Incoming Webhooks. Przełącz przełącznik Activate Incoming Webhooks na On.
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... 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-alertyzamiast 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ł.