Slack и Discord
Публикуйте понятные уведомления из B1 прямо в канал Slack или Discord: новые люди, пожертвования, регистрации в группы, отправки форм, события календаря и многое другое. Не нужна сторонняя учётная запись и не нужно поддерживать Zap: B1 сама преобразует события в сообщения чата и отправляет их на URL веб-хука канала.
Прежде чем начать
- Нужно право Edit Settings в B1Admin
- Администратор вашего рабочего пространства Slack или сервера Discord, который может создать входящий веб-хук канала
- Решите, в какой канал отправлять уведомления (можно использовать один канал для нескольких типов событий или разнести их по разным каналам)
Как это работает
В B1 есть встроенный Connector Type для платформ чата. Когда вы создаёте веб-хук с типом Slack или Discord, механизм веб-хуков по-прежнему выполняет обычную доставку, повторные попытки и подпись заголовков, но тело сообщения преобразуется из стандартного конверта B1 {event,churchId,data} в простое сообщение {text} (Slack) или {content} (Discord), которое ожидают эти сервисы.
B1 не обращается к Slack для каждой церкви отдельно, кроме существующего потока исходящих веб-хуков, — ничего нового размещать и ничем дополнительно платить не нужно.
Slack — пошагово
1. Получите URL входящего веб-хука Slack
- Откройте api.slack.com/apps в рабочем пространстве Slack, куда хотите получать уведомления.
- Нажмите Create New App → From scratch, назовите приложение, например, «B1 Notifications», и выберите рабочее пространство.
- В левом меню выберите Incoming Webhooks и переключите Activate Incoming Webhooks в положение On.
- Нажмите Add New Webhook to Workspace, выберите канал (например,
#donations), затем Allow. - Slack вернёт вас на страницу с новым Webhook URL, который выглядит так:
https://hooks.slack.com/services/T0XXXXXXX/B0YYYYYYY/zzz…. Скопируйте его — это единственное, что нужно B1.
Относитесь к URL веб-хука Slack как к секрету. Любой, у кого он есть, может публиковать произвольные сообщения в канал. Если он случайно раскрыт, перегенерируйте его на странице приложения Slack (перегенерация лишь меняет URL; обновите B1 в соответствии с ним).
2. Подключите его в B1Admin
- В B1Admin перейдите в Settings → Developer → Webhooks.
- Нажмите New Webhook.
- Заполните:
- Name — понятное название, например «Donations → #donations». Видно только вашей команде.
- Connector Type — выберите Slack.
- Payload URL — вставьте URL Slack из шага 1.
- Events — отметьте события, которые хотите получать как сообщения. Для канала пожертвований достаточно
donation.created. Для канала #people попробуйтеperson.createdиgroup.member.added.
- Нажмите Save. Появится диалог «Signing Secret» — для Slack его можно игнорировать (Slack не проверяет подписи B1) и закрыть.
3. Проверьте
Откройте веб-хук из списка снова и нажмите Send Test Event. B1 отправит пример первого отмеченного события, и примерно через секунду-две в канале Slack появится сообщение вида
💝 New donation: $50.00
а в таблице Recent Deliveries на том же экране появится новая строка со статусом succeeded. Готово.
Discord — пошагово
1. Получите URL веб-хука Discord
- На сервере Discord наведите курсор на канал, в который хотите получать уведомления, и нажмите ⚙ шестерёнку (Edit Channel).
- Откройте Integrations → Webhooks → New Webhook.
- Задайте имя и (при желании) аватар, затем нажмите Copy Webhook URL — он выглядит так:
https://discord.com/api/webhooks/123…/abc….
2. Подключите его в B1Admin
Точно так же, как и для Slack выше, только Connector Type укажите Discord. Вставьте URL Discord в Payload URL и сохраните.
Добавлять /slack в конец URL Discord не нужно — B1 отправляет нативные для Discord пакеты {content}, а не совместимые со Slack. Просто вставьте URL, который дал Discord.
3. Проверьте
Та же кнопка Send Test Event — Discord покажет сообщение в выбранном канале, а журнал доставки переключится на succeeded.
Как выглядят сообщения
| Событие | Пример сообщения |
|---|---|
person.created | 👤 New person added: Jordan Rivera |
person.updated | 👤 Person updated: Jordan Rivera |
group.created | 👥 New group created: Tuesday Bible Study |
group.member.added | ➕ Someone was added to a group |
donation.created | 💝 New donation: $50.00 |
donation.updated | 💝 Donation updated: $75.00 |
attendance.recorded | ✅ Attendance recorded |
form.submission.created | 📝 New form submission received |
event.created | 📅 New event: Easter Service |
Полный список находится в каталоге событий веб-хуков — любое событие оттуда можно направить в Slack/Discord.
Один канал на тему
Не обязательно складывать все события в одно место. Большинство церквей настраивают несколько веб-хуков:
- Канал #donations, который слушает только
donation.created - Канал #new-people для
person.createdиgroup.member.added - Канал #admin-alerts для редких событий, например
form.submission.created
Количество веб-хуков для церкви не ограничено. Каждый из них независим: удаление или отключение одного не влияет на остальные.
Просмотр доставок
В таблице Recent Deliveries в редакторе веб-хука показаны последние 50 попыток. Нажмите на строку, чтобы увидеть точный пакет, который был отправлен, и ответ, который пришёл в ответ. Для коннектора Slack пакет выглядит как {"text":"💝 New donation: $50.00"}, а не как исходный конверт {event,churchId,...}, потому что B1 преобразует его перед отправкой.
Если что-то не сработало (жёлтый значок failed, пока B1 ещё повторяет попытки, или красный значок exhausted, когда B1 перестала пытаться), в столбце Response показан HTTP-статус, а в диалоге строки — тело ответа, так что вы видите, что именно не понравилось Slack или Discord, обычно это ошибка копирования URL. Нажмите Redeliver, чтобы отправить доставку повторно.
Устранение неполадок
- Сообщение не появляется, статус доставки
400— обычно тип коннектора установлен Standard, но URL принадлежит Slack/Discord. Slack/Discord отклоняют исходный конверт. Переключите список на Slack или Discord и отправьте тестовое событие снова. - Веб-хук отключился автоматически — B1 повторяет каждую неудачную доставку примерно пять дней. Если три доставки подряд исчерпали повторы, B1 выключает веб-хук (его статус становится Disabled). Исправьте URL (или перегенерируйте его в Slack/Discord), снова включите Active и сохраните.
- Сообщение пришло, но без подробностей — все платформы чата ограничивают размер сообщения. Сообщения B1 намеренно короткие; для более насыщенных уведомлений используйте Zapier или Make, чтобы составить полное сообщение Slack через их действия Slack.
Смена типа коннектора
Тип коннектора у существующего веб-хука можно поменять — изменение вступает в силу при следующей доставке. Если вы переключаетесь с Slack на Standard, укажите URL на свою конечную точку HTTPS; тот же секрет подписи (он был выдан при создании веб-хука) теперь можно проверять по исходному конверту.
См. также
- Zapier — для многошаговых процессов, которые запускаются событиями B1
- Make — визуальный конструктор сценариев
- Веб-хуки (справочник для разработчиков) — полный формат пакета и подписи, если вы когда-нибудь направите веб-хук на собственный сервер