Prejsť na hlavný obsah

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​

  1. Otvorte api.slack.com/apps v pracovnom priestore Slack, v ktorom chcete upozornenia.
  2. Kliknite na Create New App → From scratch, pomenujte ju napríklad „B1 Notifications“ a vyberte pracovný priestor.
  3. V ľavej navigácii zvoľte Incoming Webhooks a prepnite Activate Incoming Webhooks na On.
  4. Kliknite na Add New Webhook to Workspace, vyberte kanál (napr. #donations) a potvrďte Allow.
  5. 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.
opatrnosť

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​

  1. V B1Admin prejdite na Settings → Developer → Webhooks.
  2. Kliknite na New Webhook.
  3. 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úste person.created a group.member.added.
  4. 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​

  1. Na vašom serveri Discord prejdite myšou na kanál, do ktorého chcete upozornenia, a kliknite na ⚙ ozubené koleso (Edit Channel).
  2. Otvorte Integrations → Webhooks → New Webhook.
  3. 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.

tip

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.created a group.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