Slack と Discord
B1 から新しい人の登録、寄付、グループへの参加、フォームの送信、カレンダーのイベントなどの通知を、Slack または Discord のチャンネルに直接投稿できます。サードパーティのアカウントも、保守が必要な Zap も必要ありません。B1 がイベントをチャットメッセージの形式に整えて、チャンネルの Webhook URL に直接送信します。
始める前に
- B1Admin で 設定の編集 権限が必要です
- チャンネルの Incoming Webhook を作成するために、Slack ワークスペースまたは Discord サーバーの管理者の協力が必要です
- 通知を受け取るチャンネルを決めてください(複数のイベントを同じチャンネルにまとめることも、チャンネルを分けることもできます)
仕組み
B1 には、チャットプラットフォーム向けの組み込みの コネクタータイプ があります。タイプが Slack または Discord の Webhook を作成すると、Webhook エンジンは通常どおり配信、再試行、署名付きヘッダーの処理を行います。ただし、送信される本文は B1 の通常の {event,churchId,data} 形式から、各サービスが期待する小さな {text}(Slack)または {content}(Discord)のメッセージ形式に変換されます。
既存の送信 Webhook の仕組み以外で、B1 のサーバーが教会ごとに Slack へアクセスすることはありません。新しく用意するものや、追加の費用もありません。
Slack の手順
1. Slack の Incoming Webhook URL を取得する
- 通知を受け取りたい Slack ワークスペースで api.slack.com/apps を開きます。
- Create New App → From scratch をクリックし、「B1 Notifications」などの名前を付けて、ワークスペースを選択します。
- 左側のメニューで Incoming Webhooks を選び、Activate Incoming Webhooks を On に切り替えます。
- Add New Webhook to Workspace をクリックし、チャンネル(例:
#donations)を選んでから Allow をクリックします。 - Slack の画面に戻ると、
https://hooks.slack.com/services/T0XXXXXXX/B0YYYYYYY/zzz…のような新しい Webhook URL が表示されます。これをコピーしてください。B1 に必要なのはこの情報だけです。
Slack の Webhook URL は秘密情報として扱ってください。この URL を知っている人は、誰でもチャンネルに任意のメッセージを投稿できます。誤って公開してしまった場合は、Slack のアプリページで URL を再生成してください(再生成すると URL が変わるだけなので、B1 側の URL も更新してください)。
2. B1Admin で接続する
- B1Admin で 設定 → 開発者 → Webhook に移動します。
- 新しい Webhook をクリックします。
- 次の項目を入力します。
- 名前:「寄付 → #donations」のような、分かりやすい名前。この名前はチームのメンバーだけに表示されます。
- コネクタータイプ:Slack を選びます。
- ペイロード URL:手順 1 でコピーした Slack の URL を貼り付けます。
- イベント:メッセージとして受け取りたいイベントにチェックを入れます。寄付用のチャンネルなら
donation.createdだけで十分です。#people チャンネルならperson.createdとgroup.member.addedを試してみてください。
- 保存 をクリックします。「Signing Secret」のダイアログが表示されますが、Slack では署名を検証しないため無視して閉じて構いません。
3. テストする
一覧から Webhook を開き直し、テストイベントを送信 をクリックします。1〜2 秒以内に、次のようなメッセージが Slack チャンネルに表示されます。
💝 新しい寄付: $50.00
同じ画面の 最近の配信 の表に新しい行が追加され、ステータスが succeeded と表示されれば完了です。
Discord の手順
1. Discord の Webhook URL を取得する
- Discord サーバーで、通知を受け取りたいチャンネルにカーソルを合わせ、⚙ 歯車(チャンネルを編集)をクリックします。
- 連携 → Webhook → 新しい Webhook を開きます。
- 名前を付け、必要に応じてアバターを設定してから、Webhook URL をコピー をクリックします。
https://discord.com/api/webhooks/123…/abc…のような形式の URL です。
2. B1Admin で接続する
コネクタータイプ を Discord に設定する以外は、上記の Slack の手順と同じです。Discord の URL を ペイロード URL に貼り付けて保存してください。
Discord の URL の末尾に /slack を追加する 必要はありません。B1 は Slack 互換の形式ではなく、Discord ネイティブの {content} 形式のペイロードを送信します。Discord が発行した URL をそのまま貼り付けてください。
3. テストする
同じ テストイベントを送信 ボタンを使います。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 に振り分けられます。
トピックごとにチャンネルを分ける
すべてのイベントを 1 か所にまとめる必要はありません。多くの教会では、いくつかの Webhook を設定しています。
- #donations チャンネル:
donation.createdだけを受け取る - #new-people チャンネル:
person.createdとgroup.member.addedを受け取る - #admin-alerts チャンネル:
form.submission.createdなど、件数の少ない通知を受け取る
教会ごとの Webhook の数に上限はありません。それぞれの Webhook は独立しているため、ある Webhook を削除したり無効にしたりしても、他の Webhook には影響しません。
配信の確認
Webhook 編集画面の 最近の配信 の表には、直近 50 件の送信履歴が表示されます。行をクリックすると、実際に送信されたペイロードと、返ってきたレスポンスを確認できます。Slack のコネクタの場合、ペイロードは {"text":"💝 New donation: $50.00"} のようになります。B1 は配信前に変換するため、元の {event,churchId,...} 形式のデータにはなりません。
配信が失敗した場合(赤色の failed または exhausted バッジ)、ダイアログには HTTP ステータスとレスポンス本文が表示されます。これを見れば、Slack や Discord がどこを受け付けなかったのか正確に分かります。多くの場合、URL のコピーミスが原因です。
トラブルシューティング
- メッセージが表示されず、配信ステータスが
400— 通常、コネクタータイプが Standard のままで、URL が Slack または Discord のものになっています。Slack と Discord は元の形式のデータを受け付けません。ドロップダウンを Slack または Discord に切り替えて、テストを再送信してください。 - Webhook が自動的に無効になった — 配信が 3 回連続で失敗すると、B1 は Webhook を停止します。URL を修正し(Slack や Discord で URL を再生成した場合も含む)、有効 を再度オンにしてください。
- メッセージは届いたが詳細が不足している — どのチャットプラットフォームにもメッセージサイズの上限があります。B1 のメッセージは意図的に 1 行の簡潔なものになっています。より詳しい通知が必要な場合は、Zapier または Make を使い、Slack のアクションで詳細なメッセージを作成してください。
後からコネクタータイプを変更する
既存の Webhook のコネクタータイプは変更できます。変更内容は次回の配信から反映されます。Slack から Standard に切り替える場合は、URL を自社の HTTPS エンドポイントに変更してください。Webhook の作成時に発行された同じ署名シークレットを使って、元の形式のデータを検証できるようになります。
関連項目
- Zapier — B1 のイベントをきっかけに、複数のステップからなるワークフローを実行したい場合
- Make — ビジュアルなシナリオビルダー
- Webhook(開発者向けリファレンス) — 独自のサーバーに Webhook を向ける場合の、ペイロードと署名形式の詳細