Zapier Zap Templates (jpcite)

更新日: 2026-05-12 (Wave 26)

jpcite を Zapier 上で trigger / action として組み合わせるための公式 Zap テンプレート。 3 trigger × 3 action = 9 combination を網羅する。

1. Trigger (jpcite → Zapier)

ID	jpcite event	webhook payload
T1	program.amended — 補助金改正	{kind, program_id, title, summary, url}
T2	enforcement.added — 行政処分追加	{kind, case_id, agency, summary, url}
T3	tax_ruleset.amended — 税制 (法令) 改正	{kind, ruleset_id, title, effective_at, url}

すべての trigger は jpcite 側 customer_webhooks (paid 必須) として登録し、 Zapier 側 Webhooks by Zapier の Catch Hook を action 起点として使う:

Zapier "Catch Hook" → コピーされた URL
  ↓ jpcite に POST /v1/me/webhooks で登録
{ "target_url": "<Zapier catch URL>",
  "event_types": ["program.amended"],
  "format": "json" }

2. Action (Zapier → jpcite or 外部 SaaS)

ID	行先	内容
A1	Slack	chat.postMessage で 3 セクション (block_kit)
A2	Notion	pages.create で program/enforcement row を作成
A3	Email (Outlook / Gmail)	テキスト summary を送信

3. 9 Combination (公式 template)

#	Trigger	Action	想定ユース
1	T1 (補助金改正)	A1 (Slack)	補助金担当 channel に即時通知
2	T1 (補助金改正)	A2 (Notion)	補助金 DB に新行 (期限管理に転用)
3	T1 (補助金改正)	A3 (Email)	部署内一斉メール
4	T2 (行政処分)	A1 (Slack)	監査 / 法務 channel に通知
5	T2 (行政処分)	A2 (Notion)	顧客リスク台帳に行追加
6	T2 (行政処分)	A3 (Email)	顧問先に通知
7	T3 (税制改正)	A1 (Slack)	税務 channel に通知
8	T3 (税制改正)	A2 (Notion)	税務 knowledge base に格納
9	T3 (税制改正)	A3 (Email)	顧客向け一斉メール (Postmark 経由)

4. テンプレート JSON (Zap import)

Zap の export JSON は以下のフォーマット。Zapier の "Create from JSON" ベータ機能で読み込める。代表 1 件 (T1 → A1) を例示:

{
  "name": "jpcite 補助金改正 → Slack #subsidy",
  "trigger": {
    "app": "WebhookByZapier",
    "event": "CatchHook",
    "subscribe_url": "<auto-generated>"
  },
  "action": {
    "app": "Slack",
    "event": "ChannelMessage",
    "config": {
      "channel": "subsidy",
      "text": "*{{title}}*\n{{summary}}\n<{{url}}|jpcite>"
    }
  },
  "metadata": {
    "source": "jpcite",
    "version": "wave26"
  }
}

5. 構築手順 (顧客側)

1. Zapier で空の Zap を作成。Trigger = "Webhooks by Zapier / Catch Hook"。
2. Zapier が払い出した URL をコピー。
3. jpcite で POST /v1/me/webhooks を叩く (上記 1.)。
4. jpcite 側で POST /v1/me/webhooks/{id}/test を実行し、 Zapier 側 "Test trigger" でサンプル payload を取得。
5. Action 側を Slack / Notion / Email から選び、 step 内で {{title}}, {{summary}}, {{url}} を mapping。
6. Publish。

6. 課金

• jpcite 側: webhook 1 通 = ¥3 (customer_webhooks の既存ルール)。
• Zapier 側: Zapier の plan に従う (jpcite はノータッチ)。
• 失敗時の retry は jpcite 側 backoff (1m / 5m / 30m / 6h / 24h) + Zapier 側 backoff の両方が走る。重複配信になり得るため、 Zap 内 step で data.event_id を deduplicate key として使うことを推奨。

7. 注意

• 旧 brand (税務会計AI / AutonoMath / zeimu-kaikei.ai) は payload に含めない。
• §52 disclaimer は Slack / Notion / Email すべてに 1 行付与 ({{_disclaimer}} placeholder)。
• LLM API 呼び出しは Zap 内では一切行わない (feedback_no_operator_llm_api)。
• 「Phase / MVP / Free tier」 という言葉も Zap 説明に含めない (feedback_no_priority_question)。