Документація
Підключення Slack через вхідний вебхук
Створіть вхідний вебхук Slack для каналу, додайте його в AutoPSEO, надішліть тестове повідомлення та виправте помилки, які повертає Slack, коли публікація не вдається.
AutoPSEO публікує повідомлення в Slack через вхідні вебхуки. Slack видає URL, який записує повідомлення в один канал. Ви вставляєте цей URL в AutoPSEO, і звіти та сповіщення починають надходити туди. Сам AutoPSEO нічого не встановлює у вашому робочому просторі: він не може читати повідомлення, переглядати список ваших каналів або публікувати кудись, куди не вказує вебхук. Додайте окремий запис для кожного каналу, в який потрібно надсилати повідомлення.
Створення вебхука в Slack
Slack видає вхідні вебхуки через застосунок Slack. Дотримуйтеся посібника Slack про вхідні вебхуки:
- Створіть застосунок Slack для свого робочого простору або відкрийте той, який уже використовуєте для сповіщень. Виберіть назву, яку впізнає ваша команда, наприклад SEO-звіти.
- У налаштуваннях застосунку відкрийте Incoming Webhooks і ввімкніть Activate Incoming Webhooks.
- Натисніть Add New Webhook to Workspace, виберіть канал і підтвердьте. Для приватного каналу спершу потрібно бути його учасником.
- Скопіюйте новий URL із розділу Webhook URLs for Your Workspace. Він починається з
https://hooks.slack.com/services/.
Повторіть кроки 3 і 4 для кожного наступного каналу: один застосунок може містити кілька вебхуків. URL, створений через старіші користувацькі інтеграції Slack, також працює, хоча Slack радить перейти з них на застосунок.
Slack вважає URL секретом: будь-хто, хто його має, може публікувати повідомлення в канал. Вставте його в AutoPSEO і не зберігайте в тікетах, вікі та скриншотах.
Додавання в AutoPSEO
- На сторінці Slack, Teams & Webhooks знайдіть Slack - Connected workspaces і натисніть Add to Slack. Відкриється форма New channel, у якій Slack уже вибрано як місце призначення.
- Name: назва для списків AutoPSEO, історії доставки й тестового повідомлення, наприклад
#seo-alerts. - Webhook URL: вставте URL зі Slack. Для запису Slack AutoPSEO приймає лише адреси
httpsна slack.com і одразу повідомляє, якщо URL не підходить. - Натисніть Add channel, а потім Send test у новому рядку. Коротке повідомлення з назвою запису має з'явитися в Slack протягом кількох секунд, а AutoPSEO покаже, скільки часу Slack відповідав.
URL зберігається в зашифрованому вигляді (AES-GCM). Надалі в списку відображаються лише його хост і останні символи, тож давайте записам такі назви, щоб було зрозуміло, який канал Slack кожен із них обслуговує.
Далі додайте те, що публікуватиметься: звіт за розкладом або сповіщення. Після цього таблиця Slack - Subscriptions під списком показуватиме для кожного каналу Slack усі правила, які публікують у ньому повідомлення, їхній розклад і те, чи вони активні, чи призупинені.
Кілька каналів і робочих просторів
Вебхук-URL належить одному каналу в одному робочому просторі, а Slack не дозволяє повідомленню змінити канал, для якого вебхук було створено. Це робить поведінку передбачуваною:
- Один канал Slack, один запис. Щоб розділити клієнтів між
#client-aі#client-b, створіть вебхук для кожного та додайте обидва. - Кілька робочих просторів працюють так само, бо кожен вебхук існує в тому просторі, де його створено.
- Один запис може обслуговувати багато правил. Надсилайте тижневий звіт і сповіщення про падіння трафіку в один запис або виділіть сповіщенням окремий, жвавіший канал.
Чому повідомлення не надійшло
Send test одразу показує причину. Для повідомлень за розкладом відкрийте Delivery history: там зберігається відповідь Slack для кожної невдалої спроби.
| Що показує AutoPSEO | Що це означає | Що робити |
|---|---|---|
| Slack rejected the URL (no_service) | Вебхук видалено або вимкнено в Slack, або URL введено з помилкою | Створіть новий вебхук, додайте його, а потім видаліть старий запис |
| The Slack channel no longer exists, or is archived | Slack відповів channel_not_found або channel_is_archived | Створіть вебхук для каналу, який ще використовується |
| Slack is rate limiting us | Slack відповів HTTP 429 | Зачекайте трохи, а потім скористайтеся Send now або Test rule |
| Timed out after 10 seconds | Slack не відповів вчасно | Спробуйте пізніше |
| Your trial has ended | Немає активного тарифу або пробного періоду | Виберіть тариф; доставка за розкладом відновиться разом із ним |
Невдалий звіт за розкладом не надсилається повторно в тому самому періоді, тож після усунення причини скористайтеся Send now. Сповіщення, яке не вдалося опублікувати, перевіряється знову під час наступної перевірки (коли запускаються сповіщення).
Видалення каналу Slack
Delete у рядку запису видаляє збережений URL і, після підтвердження з указанням кількості, усі правила, які публікують у цей канал. AutoPSEO нічого не змінює в Slack: вебхук продовжує працювати, доки хтось не видалить його в застосунку Slack, тож зробіть це також, якщо URL могли побачити сторонні.