メインコンテンツに移動

VOMO

VOMOは、ボランティア参加のためのプラットフォームです。人々はVOMOでプロジェクトに申し込み、キオスクでチェックインし、ボランティア時間を積み上げていきます。ボランティアの予定管理にはVOMOを、人物記録にはB1を使っている場合、Zapierを使って両者の会員情報とチェックイン情報を同期させることができます。そうすれば、どちらか一方だけが古くなることを防げます。

始める前に

  • Zapierに対応したプランのVOMOアカウント(不明な場合はVOMOのサポートに確認してください)
  • Zapierアカウント
  • Edit Settings権限を持つB1Adminユーザー

連携できる内容​

VOMOのZapierアプリには、4つのインスタントトリガーと4つのアクションがあります。多くの教会が求めている連携パターンは次のとおりです。

方向トリガーアクション
VOMO → B1VOMO Membership(作成時)B1: Find Person → Create Person(新規の場合のみ)
VOMO → B1VOMOのキオスクチェックインB1: 「Currently Serving」グループにGroup Memberを追加、または出席として記録
B1 → VOMOB1 person.createdVOMO: メールアドレスでFind Organizerを実行。見つからない場合はカスタムステップ
いずれでもVOMO Participation(申し込み)B1: プロジェクト専用グループにGroup Memberを追加

VOMO側のアクションは、プロジェクトの下書き作成と、既存のオーガナイザーやプロジェクトの検索に限られます。現時点では「この人をVOMOのプロジェクトに追加する」というアクションはありません。そのため、実質的な連携の中心はVOMOからB1への方向になります。

設定​

1. B1のAPIキーを発行する​

Settings → Developer → API Keys → New API Keyの順に進みます。スコープは次のとおりです。

  • people:read、people:write:ボランティアをB1の人物として検索・作成するため
  • groups:write:奉仕チームのグループに追加するため
  • (任意)attendance:write:キオスクのチェックインを出席として扱う場合

2. 会員同期のZapを作成する​

  1. トリガー:VOMO: Membership(イベント = created)
  2. アクション:B1.church: Find Person(メールアドレスで照合)
  3. フィルターまたはパス:見つかったかどうかで分岐します。
    • 見つからない場合:B1.church: Create Personを実行し、その後、適切なボランティアグループにAdd Group Memberを実行します。
    • 見つかった場合:B1.church: Add Group Memberを直接実行します。
  4. 有効にします。これで、VOMOの新しいボランティアが適切なグループ所属の状態でB1に表示されるようになります。

3.(任意)キオスクチェックインのZapを作成する​

  1. トリガー:VOMO: Kiosk
  2. アクション:B1.church: Find Person(メールアドレスで検索)
  3. アクション:用途に応じて選択します。
    • 出席として扱う場合:Webhooks by ZapierからB1の/attendance/visitsエンドポイントにPOSTします。(B1のZapierアプリには、まだ専用のRecord Attendanceアクションがありません。)B1のAPIキーは、Authorization: Bearer cak_…ヘッダーに設定します。
    • グループ所属として扱う場合:「Currently Serving (Today)」グループを対象にB1.church: Add Group Memberを実行します。その日の後半に、スケジュールされたクリーンアップで削除するための2つ目のZapを作成します。

よく使われるレシピ​

プロジェクトごとのグループ同期​

  • トリガー:VOMO: Participation(作成時)
  • アクション:プロジェクトIDでZapierのフィルターを適用し、その後
  • アクション:VOMOのプロジェクト名に対応するB1のグループにB1.church: Add Group Memberを実行します。

VOMOのプロジェクトが終了したら、B1のグループを手動で空にしてください。または、Participation deletedトリガーと組み合わせて、該当者を自動的に削除することもできます。

SMSで「お申し込みありがとうございます」を送る​

同じZapの中で、VOMO Participationの後にClearstream Send TextまたはText In Church Send Messageを連鎖させます。どちらもZapierの専用アクションがあります。詳しくはClearstreamとText In Churchを参照してください。

離脱を検知する​

毎日実行するZapierのScheduleトリガーで、今月奉仕チームに加わったB1の人物のリストについて、VOMOのFind Organizerを呼び出します。VOMOが「見つからない」と返した場合、その人はVOMOを有効化していないため、声をかける必要があります。

制限と注意事項​

  • メールアドレスが結合キーです。 VOMOのペイロードにはユーザーのメールアドレスは含まれますが、B1の人物IDは含まれません。両方のシステムで異なるメールアドレスを使っている人は、重複して作成されます。
  • 現時点でVOMOのZapierアプリに「プロジェクトに追加」アクションはありません。 B1からVOMOのプロジェクトへの登録が必要な場合は、Webhooks by ZapierのステップからVOMOのREST APIにPOSTする必要があります。これはカスタム連携になります。
  • VOMOの無料プランや下位プランでは、Zapierが利用できない場合があります。 連携の開始日を約束する前に、VOMOのサポートに確認してください。

トラブルシューティング​

  • トリガーが発火しない:VOMOのインスタントトリガーには、APIトークンが有効であることが必要です。Zapを再テストし、トークンが再発行されていた場合はVOMOを再接続してください。
  • B1のAdd Group Memberが422で失敗する:アクションのグループIDが存在しません。B1Admin → Groupsを開き、対象のグループをクリックして、URLのID部分をZapのステップにコピーしてください。
  • 1人のVOMOボランティアから、B1に重複した人物が作られる:その人は、B1にすでに登録されているものとは別のメールアドレスで申し込んだ可能性があります。メールアドレスを統一するか、作成前に電話番号でも検索するZapierのPathを追加してください。

関連項目​