Slack a Discord
Posielajte čitateľné upozornenia z B1 priamo do kanála Slack alebo Discord — nové osoby, dary, registrácie do skupín, odoslané formuláre, udalosti v kalendári a ďalšie. Nepotrebujete účet tretej strany ani Zap, ktorý by bolo treba udržiavať: B1 udalosti preformátuje do správ pre chat a sám ich odošle na webhook URL daného kanála.
Než začnete
- Potrebujete oprávnenie Edit Settings v B1Admin
- Správcu vo vašom pracovnom priestore Slack alebo na serveri Discord, ktorý vytvorí Incoming Webhook pre kanál
- Rozhodnite sa, do ktorého kanála chcete upozornenia posielať (môžete použiť rovnaký kanál pre viacero typov udalostí alebo ich rozdeliť do viacerých kanálov)
Ako to funguje
B1 má zabudovaný Connector Type pre chatové platformy. Keď vytvoríte webhook s typom Slack alebo Discord, webhook engine stále vykonáva obvyklé doručovanie, opakovanie a podpisové hlavičky, no telo správy sa prepíše z bežnej obálky B1 {event,churchId,data} na krátku správu {text} (Slack) alebo {content} (Discord), ktorú tieto služby očakávajú.
Okrem existujúceho odchádzajúceho toku webhookov žiadne servery B1 nekontaktujú Slack pre jednotlivé cirkvi — nič nové sa nehostuje a nič navyše sa neplatí.
Slack — krok za krokom
1. Získajte Incoming Webhook URL pre Slack
- Otvorte api.slack.com/apps v pracovnom priestore Slack, v ktorom chcete upozornenia.
- Kliknite na Create New App → From scratch, pomenujte ju napríklad „B1 Notifications“ a vyberte pracovný priestor.
- V ľavej navigácii zvoľte Incoming Webhooks a prepnite Activate Incoming Webhooks na On.
- Kliknite na Add New Webhook to Workspace, vyberte kanál (napr.
#donations) a potvrďte Allow. - Slack vás vráti na stránku s novou Webhook URL, ktorá vyzerá takto:
https://hooks.slack.com/services/T0XXXXXXX/B0YYYYYYY/zzz…. Skopírujte ju — je to jediný údaj, ktorý B1 potrebuje.
Webhook URL pre Slack berte ako tajomstvo. Ktokoľvek ju má, môže do kanála posielať ľubovoľné správy. Ak ju náhodou niekde zverejníte, vygenerujte ju znova na stránke aplikácie v Slacku (regenerácia iba zmení URL; v B1 ju potom aktualizujte).
2. Pripojte ju v B1Admin
- V B1Admin prejdite na Settings → Developer → Webhooks.
- Kliknite na New Webhook.
- Vyplňte:
- Name — niečo čitateľné, napríklad „Dary → #donations“. Vidí to iba váš tím.
- Connector Type — vyberte Slack.
- Payload URL — vložte Slack URL z kroku 1.
- Events — označte udalosti, ktoré chcete ako správy. Pre kanál darov stačí
donation.created. Pre kanál #people skústeperson.createdagroup.member.added.
- Kliknite na Save. Zobrazí sa dialóg „Signing Secret“ — pre Slack ho môžete ignorovať (Slack overovanie podpisov B1 nevykonáva) a zavrieť.
3. Otestujte to
Znova otvorte webhook zo zoznamu a kliknite na Send Test Event. Do jednej či dvoch sekúnd sa vo vašom kanáli Slack objaví správa podobná tejto
💝 New donation: $50.00
a v tabuľke Recent Deliveries na tej istej obrazovke sa objaví nový riadok so stavom succeeded. Hotovo.
Discord — krok za krokom
1. Získajte webhook URL pre Discord
- Na vašom serveri Discord prejdite myšou na kanál, do ktorého chcete upozornenia, a kliknite na ⚙ ozubené koleso (Edit Channel).
- Otvorte Integrations → Webhooks → New Webhook.
- Pomenujte ho a voliteľne mu nastavte avatar, potom kliknite na Copy Webhook URL — vyzerá napríklad takto:
https://discord.com/api/webhooks/123…/abc….
2. Pripojte ju v B1Admin
Postup je rovnaký ako pre Slack, až na to, že Connector Type nastavíte na Discord. Discord URL vložte do Payload URL a uložte.
Na koniec Discord URL nemusíte pridávať /slack — B1 posiela natívne payloady {content} pre Discord, nie payloady kompatibilné so Slackom. Stačí vložiť URL, ktorú vám Discord poskytol.
3. Otestujte to
Rovnaké tlačidlo Send Test Event — Discord zobrazí správu vo zvolenom kanáli a záznam o doručení sa zmení na succeeded.
Ako vyzerajú správy
| Udalosť | Príklad správy |
|---|---|
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 |
Úplný zoznam sa nachádza v katalógu webhook udalostí — ktorúkoľvek tam uvedenú udalosť možno smerovať do Slacku/Discordu.
Jeden kanál na tému
Nemusíte všetky udalosti dávať na jedno miesto. Väčšina cirkví nastaví niekoľko webhookov:
- Kanál #donations, ktorý počúva iba
donation.created - Kanál #new-people pre
person.createdagroup.member.added - Kanál #admin-alerts pre menej časté veci, ako je
form.submission.created
Počet webhookov na cirkev nie je obmedzený. Každý z nich je nezávislý — vymazanie alebo vypnutie jedného neovplyvní ostatné.
Kontrola doručení
Tabuľka Recent Deliveries v editore webhookov zobrazuje posledných 50 pokusov. Kliknutím na riadok zobrazíte presný odoslaný payload a odpoveď, ktorá prišla späť. Pri konektore Slack je payload {"text":"💝 New donation: $50.00"} — nie surová obálka {event,churchId,...} — pretože B1 ho pred doručením preformátuje.
Ak niečo zlyhalo (červený odznak failed alebo exhausted), dialóg zobrazí HTTP stav a telo odpovede, aby ste presne videli, čo Slack alebo Discord neprijal — zvyčajne ide o chybu pri kopírovaní URL.
Riešenie problémov
- Správa sa neobjaví + stav doručenia
400— zvyčajne je Connector Type nastavený na Standard, ale URL je zo Slacku alebo Discordu. Slack a Discord surovú obálku odmietnu. Prepnite rozbaľovací zoznam na Slack alebo Discord a znova odošlite testovaciu udalosť. - Webhook sa automaticky vypol — po 3 po sebe idúcich neúspešných doručeniach B1 webhook vypne. Opravte URL (alebo ju v Slacku/Discorde vygenerujte znova) a znova zapnite Active.
- Správa dorazila, ale chýbajú v nej podrobnosti — každá chatová platforma obmedzuje veľkosť správy. Správy B1 sú zámerne jednoriadkové; pre bohatšie upozornenia použite Zapier alebo Make, ktorý zloží väčšiu správu pre Slack pomocou ich Slack akcií.
Neskoršia zmena typu konektora
Typ konektora môžete zmeniť aj na existujúcom webhooku — prejaví sa pri ďalšom doručení. Ak prepnete zo Slacku na Standard, nasmerujte URL na svoj vlastný HTTPS endpoint; rovnaký podpisový kľúč (vydaný pri vytvorení webhooku) sa potom začne overovať pri surovej obálke.
Pozri tiež
- Zapier — pre viackrokové pracovné postupy spúšťané udalosťami B1
- Make — vizuálny zostavovač scenárov
- Webhooks (developer reference) — úplný formát payloadu a podpisu, ak niekedy nasmerujete webhook na svoj server