Пријавите се на главни садржај

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​

  1. Отворите api.slack.com/apps у Slack радном простору у који желите обавештења.
  2. Кликните Create New App → From scratch, дајте апликацији назив попут „B1 Notifications” и изаберите радни простор.
  3. У левој навигацији изаберите Incoming Webhooks и укључите Activate Incoming Webhooks.
  4. Кликните Add New Webhook to Workspace, изаберите канал (нпр. #donations), па Allow.
  5. Slack вас враћа на страницу са новим Webhook URL-ом који изгледа овако: https://hooks.slack.com/services/T0XXXXXXX/B0YYYYYYY/zzz…. Копирајте га. То је једина информација коју B1 треба.
опреза

Третирајте Slack webhook URL као тајну. Свако ко га има може да шаље произвољне поруке у канал. Ако га случајно откријете, регенеришите га на страници Slack апликације. Регенерисање само мења URL, па ажурирајте и B1.

2. Повежите га у B1Admin​

  1. У B1Admin идите на Settings → Developer → Webhooks.
  2. Кликните New Webhook.
  3. Попуните поља:
    • Name: нешто разумљиво, попут „Донације → #donations”. Види га само ваш тим.
    • Connector Type: изаберите Slack.
    • Payload URL: налепите Slack URL из корака 1.
    • Events: означите догађаје које желите као поруке. За канал за донације довољан је donation.created. За канал #people пробајте person.created и group.member.added.
  4. Кликните Save. Појавиће се дијалог „Signing Secret”. За Slack га можете занемарити, јер Slack не проверава B1 потписе. Затворите га.

3. Тестирајте​

Поново отворите webhook са листе и кликните Send Test Event. За секунду или две порука попут

💝 New donation: $50.00

појавиће се у вашем Slack каналу, а нови ред ће се појавити у табели Recent Deliveries на истом екрану, са статусом succeeded. Готови сте.

Discord: корак по корак​

1. Набавите Discord Webhook URL​

  1. На вашем Discord серверу задржите показивач на каналу за обавештења и кликните на ⚙ зупчаник (Edit Channel).
  2. Отворите Integrations → Webhooks → New Webhook.
  3. Дајте му назив и, по жељи, аватар, па кликните 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 на свој сервер