Slack и Discord
Шаљите читљива обавештења из B1 директно у Slack или Discord канал: нове особе, донације, пријаве за групе, попуњене обрасце, догађаје из календара и још много тога. Не треба вам налог треће стране и нема Zap-ова за одржавање. B1 сам претвара догађаје у поруке за ћаскање и шаље их на webhook URL канала.
Пре почетка
- Потребна вам је дозвола Edit Settings у B1Admin
- Администратор у вашем Slack радном простору или Discord серверу мора да направи Incoming Webhook за канал
- Одлучите у који канал желите обавештења (можете користити исти канал за више типова догађаја или их поделити на више канала)
Како функционише
B1 има уграђени Connector Type за платформе за ћаскање. Када направите webhook са типом Slack или Discord, webhook механизам и даље ради уобичајено: шаље, понавља покушаје и додаје потписана заглавља. Али тело које се шаље мења се из B1-овог уобичајеног омотача {event,churchId,data} у кратку поруку {text} (Slack) или {content} (Discord), какву ти сервиси очекују.
Ниједан B1 сервер не контактира Slack за сваку цркву посебно, осим кроз постојећи одлазни webhook ток. Ништа ново се не хостује и нема додатних трошкова.
Slack: корак по корак
1. Набавите Slack Incoming Webhook URL
- Отворите api.slack.com/apps у Slack радном простору у који желите обавештења.
- Кликните Create New App → From scratch, дајте апликацији назив попут „B1 Notifications” и изаберите радни простор.
- У левој навигацији изаберите Incoming Webhooks и укључите Activate Incoming Webhooks.
- Кликните Add New Webhook to Workspace, изаберите канал (нпр.
#donations), па Allow. - Slack вас враћа на страницу са новим Webhook URL-ом који изгледа овако:
https://hooks.slack.com/services/T0XXXXXXX/B0YYYYYYY/zzz…. Копирајте га. То је једина информација коју B1 треба.
Третирајте Slack webhook URL као тајну. Свако ко га има може да шаље произвољне поруке у канал. Ако га случајно откријете, регенеришите га на страници Slack апликације. Регенерисање само мења URL, па ажурирајте и B1.
2. Повежите га у B1Admin
- У B1Admin идите на Settings → Developer → Webhooks.
- Кликните New Webhook.
- Попуните поља:
- Name: нешто разумљиво, попут „Донације → #donations”. Види га само ваш тим.
- Connector Type: изаберите Slack.
- Payload URL: налепите Slack URL из корака 1.
- Events: означите догађаје које желите као поруке. За канал за донације довољан је
donation.created. За канал #people пробајтеperson.createdиgroup.member.added.
- Кликните Save. Појавиће се дијалог „Signing Secret”. За Slack га можете занемарити, јер Slack не проверава B1 потписе. Затворите га.
3. Тестирајте
Поново отворите webhook са листе и кликните Send Test Event. За секунду или две порука попут
💝 New donation: $50.00
појавиће се у вашем Slack каналу, а нови ред ће се појавити у табели Recent Deliveries на истом екрану, са статусом succeeded. Готови сте.
Discord: корак по корак
1. Набавите Discord Webhook URL
- На вашем Discord серверу задржите показивач на каналу за обавештења и кликните на ⚙ зупчаник (Edit Channel).
- Отворите Integrations → Webhooks → New Webhook.
- Дајте му назив и, по жељи, аватар, па кликните Copy Webhook URL. URL изгледа овако:
https://discord.com/api/webhooks/123…/abc….
2. Повежите га у B1Admin
Исто је као код Slack тока изнад, с том разликом што Connector Type подешавате на Discord. Налепите Discord URL у Payload URL и сачувајте.
Не морате додавати /slack на крај Discord URL-а. B1 шаље Discord-нативне {content} корисне терете, а не Slack-компатибилне. Само налепите URL који вам је Discord дао.
3. Тестирајте
Користите исто дугме Send Test Event. Discord приказује поруку у изабраном каналу, а дневник испорука прелази на succeeded.
Како изгледају поруке
| Догађај | Пример поруке |
|---|---|
person.created | 👤 Додата нова особа: Jordan Rivera |
person.updated | 👤 Ажурирана особа: Jordan Rivera |
group.created | 👥 Креирана нова група: Уторачка библијска студија |
group.member.added | ➕ Неко је додат у групу |
donation.created | 💝 Нова донација: $50.00 |
donation.updated | 💝 Донација ажурирана: $75.00 |
attendance.recorded | ✅ Присуство забележено |
form.submission.created | 📝 Примљен нови попуњени образац |
event.created | 📅 Нови догађај: Ускршња служба |
Комплетна листа налази се у каталогу webhook догађаја. Сваки догађај из ње може се усмерити ка Slack-у или Discord-у.
Један канал по теми
Не морате све догађаје слати на једно место. Већина цркава подеси неколико webhook-ова:
- Канал #donations који слуша само
donation.created - Канал #new-people за
person.createdиgroup.member.added - Канал #admin-alerts за догађаје мањег обима, попут
form.submission.created
Број webhook-ова по цркви није ограничен. Сваки је независан, па брисање или искључивање једног не утиче на остале.
Преглед испорука
Табела Recent Deliveries у уређивачу webhook-а приказује последњих 50 покушаја. Кликните на ред да видите тачан корисни терет који је послат и одговор који је стигао. За Slack connector корисни терет је {"text":"💝 New donation: $50.00"}, а не необрађени омотач {event,churchId,...}, јер га B1 преобликује пре слања.
Ако је нешто неуспешно (црвена значка failed или exhausted), дијалог приказује HTTP статус и тело одговора, па можете видети тачно шта Slack или Discord није прихватио. Обично је то грешка при копирању и лепљењу URL-а.
Решавање проблема
- Порука се не појављује, а статус испоруке је
400: обично је Connector Type подешен на Standard, а URL је Slack или Discord. Ти сервиси одбијају необрађени омотач. Пребаците падајући мени на Slack или Discord и поново пошаљите тест. - Webhook се аутоматски искључио: after 3 узастопне неуспешне испоруке B1 искључује webhook. Поправите URL (или га регенеришите у Slack-у или Discord-у) и поново укључите Active.
- Порука је стигла, али недостају детаљи: свака платформа за ћаскање ограничава величину поруке. B1-ове поруке су намерно кратке. За богатија обавештења користите Zapier или Make да саставите потпунију Slack поруку помоћу њихових Slack акција.
Промена типа конектора касније
Connector Type можете променити на постојећем webhook-у. Промена важи од следеће испоруке. Ако пређете са Slack на Standard, усмерите URL на свој HTTPS крајњи пункт. Исти потписни кључ (издат при креирању webhook-а) тада почиње да се може проверавати као необрађени омотач.
Погледајте и
- Zapier: за вишекорачне токове који се покрећу B1 догађајима
- Make: визуелни уређивач сценарија
- Webhooks (референца за програмере): пун формат корисног терета и потписа ако икада усмерите webhook на свој сервер