Contents
1. 公式 kintone アプリで利用できる標準アクション
Zapier の公式 kintone アプリは、ノーコードで レコードの作成・取得・更新・削除 を行うための基本的な Action が予め用意されています。以下に代表的なアクションと主な用途を示します。
1‑1. 標準アクション一覧
| アクション名 | 主な用途 |
|---|---|
| Create Record | 新規レコードの登録 |
| Update Record | 既存レコードのフィールド更新 |
| Find Records | 条件検索による複数レコード取得 |
| Get Record | レコード ID 指定で単一取得 |
| Delete Record | レコード削除(有料プラン限定) |
ポイント:これらは Zapier の UI で「App → kintone → Action」だけで設定可能です。認証には API トークン + エンドポイント URL を使用し、通信はすべて HTTPS で暗号化されます(詳細は公式ドキュメントcybozu.dev – REST API)。
1‑2. 標準アクションの制限
| 項目 | 内容 |
|---|---|
| 同時書き込み | サブテーブルへの同時更新は非対応(1 件ずつ) |
| 複雑ロジック | データ変換や条件分岐は Zapier の Code や外部サービスで補完必要 |
| リアルタイム通知 | Webhook が無いため、ポーリングベースのトリガーに限定 |
| レートリミット | kintone は 1 分間あたり最大 60 リクエスト(スロットル)です。大量更新はバッチ API の利用を検討してください【出典: cybozu.dev – Rate Limiting】 |
2. kintone 側の事前準備と Zapier 認証情報設定
kintone と Zapier を安全に接続するには、API トークンの発行と最小権限の付与が必須です。本節では重複を排除し、シンプルな手順だけをまとめました。
2‑1. サブドメイン確認
- kintone にログイン後、ブラウザ URL の
https://{YOUR_SUBDOMAIN}.cybozu.com部分をコピーします。 - エンドポイントは
https://{YOUR_SUB_DOMAIN}.cybozu.com/k/v1/です(REST API のベース URL)。
2‑2. API トークンの発行と権限設定
| 手順 | 操作内容 |
|---|---|
| ① アプリ設定へ | 対象アプリの画面左メニュー → API Token を選択 |
| ② 新規トークン作成 | 「新規作成」ボタンをクリックし、トークン名を入力 |
| ③ 権限チェック | 必要な権限だけにチェック(例:レコード作成のみなら「追加」) |
| ④ トークン取得 | 「生成」ボタンで文字列が表示されるのでコピー。※この文字列は二度と表示できないため、必ず安全な場所に保管してください【参考: i-ssue ガイド – API Token の扱い】 |
ベストプラクティス:最小特権の原則に従い、使用しない権限はすべてオフにします。
2‑3. Zapier に認証情報を登録
- Zapier ダッシュボード左メニュー → My Apps → 「Add new connection」
- アプリ一覧から kintone を選択し、以下の項目を入力
- エンドポイント URL:
https://{YOUR_SUBDOMAIN}.cybozu.com/k/v1/ - API トークン:先ほど取得した文字列
- 「Test Connection」ボタンで接続成功を確認できれば完了です。
接続テストが失敗する場合は、トークンに付与した権限とサブドメインのスペルを再度ご確認ください。
3. Webhook + REST API ハイブリッド構成で拡張連携
公式アプリだけでは実現できない リアルタイム通知 や 高度なデータ加工 を行うには、kintone の Webhook と Zapier の「Webhooks by Zapier」機能を組み合わせます。
3‑1. kintone 側で Webhook を作成する手順
| 手順 | 内容 |
|---|---|
| ① アプリ設定 → Webhook | 左メニューの Webhook を選択 |
| ② 新規作成 | 「新規作成」ボタンをクリック |
| ③ 送信先 URL | Zapier が生成する Catch Hook のエンドポイント(後述) |
| ④ イベント種別 | 「レコード追加」「レコード更新」「レコード削除」から必要なものにチェック |
| ⑤ 認証方式 | 「ヘッダー」に X-Cybozu-API-Token: {YOUR_API_TOKEN} を設定(推奨) |
| ⑥ 保存 & テスト | テスト用レコードを作成し、Zapier 側で受信確認 |
3‑2. Zapier の「Catch Hook」設定
- Zap 作成画面 → Trigger に Webhooks by Zapier → Catch Hook を選択。
- 表示された URL を kintone Webhook の「送信先 URL」に貼り付け、保存。
- 「Test Trigger」を実行し、kintone から送られたサンプルペイロードが取得できれば接続成功です。
3‑3. 受信データを REST API に転送する例
以下は レコード作成 を Zapier 側で再度 kintone に送る最小構成です。
(実際には「Code」ステップで JSON 整形やバリデーションを行うことが多いです)
|
1 2 3 4 5 6 7 8 9 10 11 12 |
POST https://{YOUR_SUBDOMAIN}.cybozu.com/k/v1/record.json Headers: X-Cybozu-API-Token: {{api_token}} Body (JSON): { "app": "{{app_id}}", "record": { "文字列__1行_": { "value": "{{trigger.field_name}}" }, "数値": { "value": "{{trigger.amount}}" } } } |
- PUT →
/record.json(更新) - GET →
/records.json?app={APP_ID}&query=...(検索)
Zapier の「Test Action」で 200 OK が返れば成功です。エラー時は Filter と Path を活用し、失敗通知を Slack などへ送るフローを組み込むと運用が楽になります。
4. 代表的ユースケース 4 パターンと実装例
本節では、業務で頻出するシナリオごとに Zap フローの全体像 と ポイント を解説します。すべて「公式アクション + Webhook/REST API」のハイブリッド構成です。
4‑1. Slack 通知:レコード更新をリアルタイムでチームへ共有
| ステップ | 内容 |
|---|---|
| Trigger | kintone Webhook(レコード更新) → Catch Hook |
| Action 1 | Code (JavaScript) で必要フィールドだけ抽出し、メッセージ本文を整形 |
| Action 2 | Slack の Send Channel Message に #updates チャンネルへ投稿 |
ポイント:Webhook が即時にデータを取得できるため、変更があった瞬間に情報が届きます。Slack 側で Message Attachments を利用すると視認性が向上します。
4‑2. Google スプレッドシートとの双方向同期
| ステップ | 内容 |
|---|---|
| Trigger | kintone Webhook(レコード追加) |
| Action 1 | 「Webhooks by Zapier」→ Custom Request (GET) で新規レコード情報取得 |
| Action 2 | Google Sheets の Create Spreadsheet Row にデータを書き込み |
| Reverse Trigger | Google Sheets の New/Updated Row |
| Reverse Action | 「Webhooks by Zapier」→ Custom Request (PUT) で kintone レコードを更新 |
ポイント:レコード ID をシートの「キー列」に保持し、Zap の Filter で重複実行を防止します。
4‑3. Salesforce と顧客情報を双方向連携
| ステップ | 内容 |
|---|---|
| Trigger | kintone Webhook(レコード更新) |
| Action 1 | Salesforce の Find Record (Contact) で対象顧客検索 |
| Action 2 | 条件が合致すれば Update Record (Salesforce) で情報上書き |
| Reverse Trigger | Salesforce の New/Updated Object |
| Reverse Action | 「Webhooks by Zapier」→ kintone REST API(PUT)で更新 |
ポイント:両システムのレコード ID を相互に保存しておくと、同期ロジックが単純化します。
4‑4. AI 生成コンテンツを kintone に自動格納
| ステップ | 内容 |
|---|---|
| Trigger | kintone Webhook(特定フィールドにキーワード入力) |
| Action 1 | 「Webhooks by Zapier → Custom Request」へ OpenAI / Claude API を呼び出し |
| Action 2 | Code (JavaScript) で生成テキストを整形 |
| Action 3 | kintone REST API(PUT)で同レコードに保存、または Slack/Teams に投稿 |
ポイント:API キーは Zapier の Environment Variables 機能で暗号化管理し、漏洩リスクを低減します。
5. テスト・デバッグ、費用感、運用ベストプラクティス
5‑1. Zap 実行結果の確認方法
| 項目 | 手順 |
|---|---|
| 手動テスト | Zap 編集画面右上の Run ボタンでトリガーを発火させる |
| 入力/出力ログ | 各ステップに表示される「Input Data」「Output」タブで JSON を可視化 |
| 失敗時の再実行 | 「Task History」から対象タスクを選択し、Retry ボタンで手動リトライ可能 |
5‑2. kintone 側ログの活用
- 監査ログ(システム管理 > 監査ログ): Webhook の受信成功/失敗が記録されます。
- API ログ(開発者ツール > API ログ): REST API 呼び出しのステータスコードとエラーメッセージを確認できます。
5‑3. Zapier と kintone のプラン比較
| 項目 | Zapier Free | Zapier Professional |
|---|---|---|
| 月間タスク実行数 | 100 タスク(上限) | 無制限(有料プラン) |
| マルチステップ Zap | 不可(シングルステップのみ) | 可能 |
| カスタムコード (JavaScript) | 利用可(1 ステップまで) | 制限なし |
| サポート | Community フォーラム | Email & Chat (優先対応) |
注記:Zapier Free はシングルステップ Zap が対象です。マルチステップが必要な場合は Professional 以上 のプランをご検討ください(公式情報: Zapier Pricing)。
kintone API コール上限
| プラン | 月間リクエスト上限 | 備考 |
|---|---|---|
| 標準 (Standard) | 100,000 リクエスト/月(※1) | 1 分あたり最大 60 リクエストのレートリミットあり【出典: cybozu.dev – API Limits】 |
| エンタープライズ | 上限はカスタマイズ可能。詳細は担当営業へ問い合わせ | 大量バッチ処理や高頻度トリガーに適合 |
(※1)上記は公式ドキュメントが示す「標準プランの月間上限」です。実際には日次・分次のスロットルも同時に適用されます。
5‑4. トークン管理とエラーハンドリング
- トークンローテーション
-
90 日ごとに新しい API トークンを発行し、Zapier の接続情報を更新。自動化したい場合は Zapier の Schedule → Webhooks (POST) で内部スクリプト(例:Google Apps Script)を呼び出す方法があります。
-
エラー通知
-
各ステップの Filter と Path を設定し、
status != 200時は Slack にアラートを送信。Zapier の「Task History」から失敗詳細が確認でき、手動でリトライ可能です。 -
レートリミット対策
- 1 分間に 60 リクエストを超えそうなケースは、Zapier の Delay アクションでインターバル(例:30 秒)を挟むか、kintone の Batch API (
/records.json) を利用してまとめて更新します。
5‑5. コスト最適化のヒント
| 観点 | 推奨アプローチ |
|---|---|
| タスク数削減 | 同一ロジックは Code ステップで集約し、Zap のステップ数を最小化 |
| API 呼び出し削減 | 必要データだけ取得する query パラメータ を活用し、過剰取得を防止 |
| 監視自動化 | Zapier の Schedule と Webhooks 組み合わせで定期的にエラーログや残タスク数をレポート |
まとめ
- 公式 kintone アプリは CRUD 系の基本操作がシンプルに実装でき、初心者でもすぐに利用可能です。
- Webhook + REST API を組み合わせることで、リアルタイム通知や複雑なデータ加工といった拡張要件にもノーコードで対応できます。
- 正確な API コール上限 と Zapier プラン制限 を把握し、タスク数・レートリミットの管理を徹底すれば、運用コストや失敗リスクを最小化できます。
本ガイドの手順とチェックリストを参考に、まずは「kintone → Slack」や「kintone ↔ Google Sheets」の自動化から始めてみましょう。実際に Zap を作成しながら疑問点が出た場合は、公式ドキュメント(cybozu.dev / Zapier Help Center)を併せて確認することをおすすめします。