Subsplash
教会アプリ、献金、フォームに Subsplash を使っているものの、人物と献金の記録の正本(システム・オブ・レコード)として B1 を使いたい場合は、Subsplash の Zapier アプリで献金、新しいプロフィール、フォームの回答をリアルタイムで B1 に送信できます。ただし、Subsplash の Zapier アプリは現在 トリガーのみ に対応しており、連携は一方向(Subsplash → B1)であることにご注意ください。
始める前に
- API + Zapier へのアクセスを含むプランの Subsplash アカウント(これらはプランによって制限されています。利用可能かどうかは Subsplash の Client Success Manager にご確認ください)
- Zapier のアカウント
- Edit Settings 権限を持つ B1Admin のユーザー
連携できる内容
以下のトリガーはすべて Subsplash のものです。アクションは B1 のものです。
| Subsplash のトリガー | B1 のアクション |
|---|---|
| New Donation | Find Person → Add Donation(人物が存在しない場合は Create Person) |
| New Pledge | Add Donation(notes = "Pledge: …" を指定) |
| New Person Created | Create Person |
| Person Updated Profile | (直接の B1 アクションはありません。手動で確認できるよう Google スプレッドシートに記録してください) |
| New Form Response | Create Person +(任意で)フォームの内容に基づいて Add Group Member |
現在、Subsplash のアプリがサポートしている方向は Subsplash → B1 のみです。
セットアップ
1. B1 API キーを作成する
B1Admin で Settings → Developer → API Keys → New API Key を開きます。スコープは次のとおりです。
people:read:メールアドレスで寄付者を検索するためpeople:write:寄付者が存在しない場合に作成するためdonations:write:献金を記録するため- (
settings:writeは不要です。この連携ではトリガーを B1 ではなく Subsplash が管理しています)
2. Subsplash を Zapier に接続する
Subsplash の Zapier 連携ガイドに従ってください。Subsplash ダッシュボード内で API トークンが発行され、Zapier はこれを使ってトリガー側の認証を行います。
3. 「献金を記録する」Zap を作成する
- Trigger:Subsplash: New Donation
- Action:B1.church: Find Person(メールアドレスで検索)
- Filter / Path:「person found」によって分岐します
- 見つかった場合: B1.church: Add Donation。金額、日付、ファンド、方法(= "Online")、メモ(notes = Subsplash のトランザクション ID)を対応付けます。
- 見つからなかった場合: B1.church: Create Person → B1.church: Add Donation(新しく作成した人物の ID を使用)。
Zap をオンにします。これ以降、Subsplash の献金は数秒以内に B1Admin → Donations に反映されます。
よくあるレシピ
初めての献金があったときにお礼を送る
- Trigger:Subsplash: New Donation
- Action:Filter by Zapier:寄付者の初回の献金である場合にのみ続行します(過去の献金者の一覧を含む Google スプレッドシートに対して Donor Email で Lookup Table を使うか、寄付者の作成日に基づいて Zapier の Paths ステップを使います)
- Action:Mailchimp / SMTP / SendGrid:初回献金へのお礼メッセージを送信
- Action:B1.church: Add Donation(通常どおり)
確約献金を通常の献金の流れから分ける
- Trigger:Subsplash: New Pledge
- Action:B1.church: Add Donation で
notes = "Pledge — Subsplash"を指定し、運営用のファンドとは別のPledgesというファンドを使います。こうすることで、B1Admin → Donations → Summary で確約献金を個別に集計できます。
新しいアプリ利用者を B1 の人物として同期する
- Trigger:Subsplash: New Person Created
- Action:B1.church: Create Person。名前、メールアドレス、電話番号を入力します。また、"Subsplash App Users" のようなグループに新しい人物を追加して、B1 でタグ付けします。
制限事項と注意点
- Subsplash の Zapier アプリはトリガーのみです。 B1 側の変更を Subsplash にも反映させたい場合(例:B1 に新しく追加された人物を Subsplash にも登録する場合)は、B1 の Zapier アプリのトリガーから、カスタムの Webhooks by Zapier — POST アクションを使って Subsplash の REST API を呼び出すブリッジを構築する必要があります。これはレシピではなく、カスタム連携です。
- API アクセスはプランによって制限されています。 Zapier の接続が
403 Forbiddenで失敗する場合、お使いの Subsplash プランには API アクセスが含まれていない可能性が高いです。Client Success Manager にお問い合わせください。 - ファンドの対応付けは手動です。 Subsplash はキャンペーン名またはカテゴリ名を渡しますが、B1 には数値のファンド ID が必要です。Zap にファンドを直接記述するか、Subsplash のキャンペーンと B1 のファンドを対応付ける Zapier の Lookup Table を管理してください。
トラブルシューティング
- 献金後にトリガーが発動しない:Subsplash の Zapier ダッシュボードで、接続が引き続き Connected と表示されているか確認してください。Subsplash 側で API トークンが再発行されている場合、Zap は何の通知もなく停止します。その場合は再接続してください。
- B1 の Add Donation が 422 で失敗する:多くの場合、
fundIdが未入力か、認識されていないことが原因です。B1Admin → Donations → Funds でファンドの一覧を開き、正確な ID を Zap のステップにコピーしてください。 - 初回の献金で同じトリガーが2回発動する:Zapier が確認応答を受け取れなかった場合、Subsplash がトリガーを再送することがあります。重複を除外するために、献金 ID(Subsplash がペイロードに含めて送信します)に対して Filter by Zapier を追加してください。
関連項目
- Donorbox:レシピの形式は同じですが、別の献金プラットフォームです
- Zapier(概要):すべての Zapier レシピの B1 側の説明
- Subsplash の Zapier 連携ガイド(Subsplash のドキュメント)