> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapierで本人確認（KYC）を自動化

> DiditのZapierアプリで本人確認ワークフローを自動化できます。6,000+のアプリから認証をトリガーし、結果を受け取れます。従量課金制です。

Zapierを通じて、Diditを**6,000+ のアプリ**と連携できます。コードは不要です。認証セッションの自動作成、ステータス変更への対応、結果をCRM・データベース・コミュニケーションツールと同期を自動化できます。

> [card] [ZapierでDiditを開く](https://zapier.com/apps/didit/integrations)
>
> Zapierマーケットプレイスでトリガー、アクション、すぐに使えるテンプレートを確認できます。

[DiditのZapier連携](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1)

***

## できること

> [card] セッションの作成
>
> フォームの送信、CRMのイベント、またはZapierに接続した任意のアプリから認証セッションをトリガーできます。

> [card] リアルタイムのWebhook
>
> ステータスの更新(承認済み、却下、レビュー中など)をZapierのトリガーとして即座に受け取れます。

> [card] 結果の取得
>
> 本人確認データ、ライブネススコア、AMLのヒットなど、セッションの詳細を必要に応じて取得できます。

***

## 前提条件

| 必要なもの | 入手方法 |
| - | - |
| **Diditアカウント** | [business.didit.me](https://business.didit.me)で登録します。テストには無料のKYCプランで十分です。 |
| **APIキー** | コンソール → **API & Webhooks** → 本番環境のキーをコピーします。Zapierアプリはすべてのアクションでこのキーを使って認証します。 |
| **ワークフローID** | コンソール → **Workflows** → 起動したいワークフローを選択します(または[新規作成](https://docs.didit.me/ja/console/workflows.md)します)。 |
| **Zapierアカウント** | 無料または有料の[Zapierアカウント](https://zapier.com)を利用できます。無料プランでは月100タスクまで処理でき、小規模なパイロットには十分です。 |

***

## 仕組み

**1. DiditをZapierに接続する**

Zapierのアプリディレクトリで**Didit**を検索し(または[マーケットプレイスのページ](https://zapier.com/apps/didit/integrations)を直接開き)、コンソール → **API & Webhooks**で取得した**APIキー**を使ってアカウントを接続します。

> [!TIP]
>
> APIキーは、Zapier上のすべてのDiditアクションの認証に使われます。接続は一度だけで済み、すべてのZapが同じ接続を共有します。コンソールでキーをローテーションすると、再接続するまでZapierの接続は無効になります。

**2. トリガーを設定する**

Zapを開始するきっかけを選択します。**Diditのトリガー**でも、他の任意のアプリでもかまいません。

| トリガーの発生元 | 例 |
| - | - |
| **DiditのWebhook** | セッションのステータスが「Approved」に変わる |
| **Google Forms** | 新しいフォームの送信 → 認証セッションを作成 |
| **HubSpot** | 新しいコンタクトの作成 → KYCをトリガー |
| **Stripe** | 新しい顧客 → 支払いの前に本人確認 |
| **Typeform** | オンボーディングフォームの完了 → 認証を開始 |

**3. Diditのアクションを追加する**

利用可能なDiditのアクションのいずれかを使います(名称は[Zapierマーケットプレイスのページ](https://zapier.com/apps/didit/integrations)と同じです)。

**Create Verification Session**: `POST /v3/session/`をラップします

* 実行する認証フローの**ワークフロー ID**を指定します。
* 必要に応じて、認証後のリダイレクト先となる**コールバックURL**を設定します。
* **ベンダーデータ**(ユーザーのメールアドレスや社内IDなど)を渡して、セッションを自社のレコードに紐付けます。
* アクションは新しい`session_id`、ユーザー向けの`url`、初期の`status`を返します。`url`を使ってユーザーを認証フローに誘導します。

**Retrieve Verification Session**: `GET /v3/session/{sessionId}/decision/`をラップします

* `session_id`を渡して、認証結果の全体を取得します。
* 本人確認データ、ライブネススコア、AMLの結果、最終的な`status`、アップロードされたメディアのURLにアクセスできます。

**4. 結果に応じて処理する**

認証結果に基づいて後続のアクションを追加します。

| ステータス | 推奨アクション |
| - | - |
| `"Approved"` | CRMを更新し、プラットフォームへのアクセスを付与し、ウェルカムメールを送信 |
| `"Declined"` | データベースでフラグを立て、コンプライアンス部門に通知し、却下のメールを送信 |
| `"In Review"` | コンプライアンスチーム向けのタスクを作成し、Slackで通知 |
| `"Abandoned"` | 新しい認証リンクを記載したリマインダーメールを送信 |

![ZapierのアクションステップからDiditの本人確認セッションを作成する画面](https://mintcdn.com/didit-0f962782/DSfxHq_ggIpqiQSG/images/zapier-create-session.png?fit=max\&auto=format\&n=DSfxHq_ggIpqiQSG\&q=85\&s=f847a30aa1e0b600543ae4dec6229cdd)

ZapierのアクションからDiditの認証セッションを作成する画面。

***

## よく使われるZapテンプレート

> [card] Google Forms → Didit → Gmail
>
> ユーザーがオンボーディングフォームに入力 → 認証セッションを作成 → 結果をユーザーと管理者にメールで送信。

> [card] HubSpot → Didit → HubSpot
>
> 新しいコンタクト → KYCをトリガー → 認証ステータスと本人確認データでコンタクトのプロパティを更新。

> [card] Stripe → Didit → Slack
>
> 新しい顧客 → 本人確認 → 結果をSlackでチームに通知。

> [card] Webhook → Didit → Airtable
>
> カスタムトリガー → ユーザーの本人確認 → コンプライアンス記録としてセッションの結果をAirtableに記録。

***

## 利用可能なトリガーとアクション

以下の名称は、[マーケットプレイス](https://zapier.com/apps/didit/integrations)にある現在のDidit Zapierアプリと同じです。Zapier上で表示されるラベルがわずかに異なる場合は、ZapierのUIを優先してください。内部の動作は同じです。

### トリガー (Zapを開始する)

| トリガー | 対応するイベント | 説明 |
| - | - | - |
| **Session Status Updated** | [`status.updated` webhook](https://docs.didit.me/ja/integration/webhooks) | 認証セッションのステータスが変わるたびに発火します(`Approved`、`Declined`、`In Review`、`Resubmitted`、`Abandoned`、`Kyc Expired`など)。 |

### アクション (処理を実行する)

| アクション | 対応するエンドポイント | 説明 |
| - | - | - |
| **Create Verification Session** | `POST /v3/session/` | ワークフロー、任意のコールバックURL、`vendor_data`を指定して新しいセッションを開始します。ユーザーと共有するセッションURLを返します。 |
| **Retrieve Verification Session** | `GET /v3/session/{sessionId}/decision/` | 指定した`session_id`について、本人確認データ、ライブネス、AMLのヒット、最終ステータスを含む判定ペイロード全体を取得します。 |

***

## 留意事項

> [!WARNING]
>
> DiditのZapierアプリは、意図的に**主要な自動化機能**、つまりセッションの開始とステータス更新への対応に絞っています。以下は現在Zapierでは提供されておらず、APIを直接呼び出す必要があります。
>
> * Zapのステップから書類の画像、動画、または住所証明のファイルをアップロードすること。
> * [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/ja/sessions-api/update-status)による判定の上書き。
> * KYB専用のエンドポイント(法人登記、主要人物)。
> * セッション単位のステータス変更以外のWebhookイベントタイプ(例: `transaction.status.updated`、`user.status.updated`)。
>
> これらをノーコードツールから利用する必要がある場合は、Zapierの**Webhooks by Zapier**ステップでAPIキーを使い、[Sessions API](https://docs.didit.me/ja/sessions-api/create-session.md)を直接呼び出してください。

***

## ヒントとベストプラクティス

> [accordion] ベンダーデータでセッションを紐付ける
>
> セッションを作成する際は、必ず**Vendor Data**フィールドに一意の識別子(メールアドレス、ユーザーID、またはUUID)を渡してください。これにより、認証結果を自社システム内の正しいユーザーに紐付けることができます。

> [accordion] すべてのステータス結果に対応する
>
> ZapierのPaths機能を使ってZapの分岐を作成し、ステータスごとに異なる処理を行いましょう。承認済み、却下、レビュー中、再提出、放棄、期限切れのそれぞれに、適切な対応を用意する必要があります。

> [accordion] フィルターでノイズを減らす
>
> ZapierのFiltersを追加して、特定のステータスの場合にのみ後続のアクションをトリガーします。たとえば、ステータスが`"Approved"`の場合にのみウェルカムメールを送信します。

> [accordion] 本番運用前にテストする
>
> 実際のユーザーを対象に処理を行う前に、Zapierのテスト機能とDiditの**Try Webhook**ボタン(Console → API & Webhooks)を併用して、Zapをエンドツーエンドで検証してください。

***

## 次のステップ

> [card] [クイックスタートガイド](https://docs.didit.me/ja/getting-started/quick-start.md)
>
> Diditアカウントを設定し、ワークフローを作成して、APIキーを取得します。

> [card] [Webhook](https://docs.didit.me/ja/integration/webhooks.md)
>
> サーバーサイド連携向けのWebhookペイロードと署名検証について説明します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.