Dokumentacja
Połączenie ze Slack przez przychodzący webhook
Utwórz w Slack przychodzący webhook dla kanału, dodaj go w AutoPSEO, wyślij wiadomość testową i napraw błędy, które Slack zwraca, gdy wysyłka się nie powiedzie.
AutoPSEO publikuje wiadomości w Slack za pomocą przychodzących webhooków. Slack daje Ci adres URL, który zapisuje wiadomości do jednego kanału. Wklejasz go w AutoPSEO i od tej chwili trafiają tam raporty oraz alerty. Sam AutoPSEO niczego nie instaluje w Twoim workspace: nie może czytać wiadomości, wyświetlać listy kanałów ani publikować w miejscach, na które nie wskazuje webhook. Dla każdego kanału, w którym chcesz otrzymywać wiadomości, dodaj osobny wpis.
Utwórz webhook w Slack
Slack wystawia przychodzące webhooki za pośrednictwem aplikacji Slack. Zgodnie z przewodnikiem Slack po przychodzących webhookach:
- Utwórz aplikację Slack dla swojego workspace albo otwórz taką, której już używasz do powiadomień. Wybierz nazwę zrozumiałą dla zespołu, na przykład Raporty SEO.
- W ustawieniach aplikacji otwórz Incoming Webhooks i włącz Activate Incoming Webhooks.
- Kliknij Add New Webhook to Workspace, wybierz kanał i zatwierdź. Jeśli to kanał prywatny, musisz najpierw do niego należeć.
- Skopiuj nowy adres URL z sekcji Webhook URLs for Your Workspace. Zaczyna się od
https://hooks.slack.com/services/.
Powtórz kroki 3 i 4 dla każdego kolejnego kanału; jedna aplikacja może mieć wiele webhooków. Adres URL utworzony w starszych, niestandardowych integracjach Slack również nadal działa, choć Slack zaleca przeniesienie ich do aplikacji.
Slack traktuje ten adres URL jak sekret: każdy, kto go ma, może pisać na kanale. Wklej go w AutoPSEO i nie umieszczaj w zgłoszeniach, wiki ani zrzutach ekranu.
Dodaj go w AutoPSEO
- Na stronie Slack, Teams & Webhooks znajdź sekcję Slack - Connected workspaces i kliknij Add to Slack. Otworzy się formularz New channel z wybranym już Slack jako miejscem docelowym.
- Name: etykieta widoczna na listach w AutoPSEO, w historii dostaw i w wiadomości testowej, na przykład
#seo-alerts. - Webhook URL: wklej adres URL ze Slack. Dla wpisu Slack AutoPSEO akceptuje wyłącznie adresy
httpsw domenie slack.com i od razu informuje, jeśli adres do tego nie pasuje. - Kliknij Add channel, a potem Send test w nowym wierszu. W ciągu kilku sekund w Slack powinna pojawić się krótka wiadomość z nazwą wpisu, a AutoPSEO poda, jak długo Slack odpowiadał.
Adres URL jest przechowywany w postaci zaszyfrowanej (AES-GCM). Później lista pokazuje tylko jego host i ostatnie znaki, dlatego wybieraj nazwy, z których jasno wynika, do którego kanału Slack prowadzi dany wpis.
Następnie ustaw, co ma być tam publikowane: raport cykliczny lub alert. Tabela Slack - Subscriptions pod listą pokazuje wtedy dla każdego kanału Slack wszystkie reguły, które tam publikują, ich harmonogram oraz to, czy są aktywne, czy wstrzymane.
Wiele kanałów i workspace'ów
Adres URL webhooka należy do jednego kanału w jednym workspace, a Slack nie pozwala, by wiadomość zmieniła kanał, dla którego webhook został utworzony. Dzięki temu całość jest przewidywalna:
- Jeden kanał Slack to jeden wpis. Aby rozdzielić klientów między
#client-ai#client-b, utwórz webhook dla każdego z nich i dodaj oba. - Wiele workspace'ów działa tak samo, ponieważ każdy webhook należy do workspace'u, w którym został utworzony.
- Jeden wpis może obsługiwać wiele reguł. Możesz wysyłać tygodniowy raport i alert o spadku ruchu do tego samego wpisu albo trzymać alerty w osobnym, bardziej ruchliwym kanale.
Dlaczego wiadomość nie dotarła
Send test od razu pokazuje przyczynę. W przypadku wiadomości cyklicznych otwórz Delivery history, gdzie zapisana jest odpowiedź Slack dla każdej nieudanej próby.
| Co pokazuje AutoPSEO | Co to oznacza | Co zrobić |
|---|---|---|
| Slack odrzucił adres URL (no_service) | Webhook został usunięty lub wyłączony w Slack albo adres URL zawiera literówkę | Utwórz nowy webhook, dodaj go, a potem usuń stary wpis |
| Kanał Slack już nie istnieje lub jest zarchiwizowany | Slack odpowiedział channel_not_found lub channel_is_archived | Utwórz webhook dla kanału, który jest nadal używany |
| Slack ogranicza liczbę żądań | Slack odpowiedział kodem HTTP 429 | Chwilę poczekaj, a potem użyj Send now lub Test rule |
| Przekroczono limit czasu 10 sekund | Slack nie odpowiedział na czas | Spróbuj ponownie później |
| Twój okres próbny dobiegł końca | Brak aktywnego planu lub okresu próbnego | Wybierz plan; wysyłki cykliczne zostaną wznowione |
Nieudany raport cykliczny nie jest ponawiany w tym samym okresie, więc po usunięciu przyczyny użyj Send now. Alert, którego nie udało się opublikować, zostanie oceniony ponownie przy następnym sprawdzeniu (kiedy uruchamiane są alerty).
Usuwanie kanału Slack
Delete w wierszu wpisu usuwa zapisany adres URL oraz, po potwierdzeniu z informacją o ich liczbie, wszystkie reguły, które tam publikują. AutoPSEO niczego nie zmienia w Slack: webhook działa dalej, dopóki ktoś nie usunie go w aplikacji Slack, więc jeśli adres URL mogły zobaczyć inne osoby, usuń go także tam.