# Zapier ワークフロー

> WayinVideo API と Zapier を接続し、YouTube、Zoom、Google Sheets、AI クリッピング、動画要約、文字起こしのワークフローを自動化します。

## Zapier 動画自動化連携

**Zapier** を使うと、WayinVideo API を Google Sheets、Google Drive、YouTube、Zoom、Slack、Gmail、Airtable、Notion、HubSpot などのアプリと接続できます。

Zapier は、ビジネス上のイベントをきっかけに動画処理を始めたい軽量なノーコードワークフローに向いています。新しい録画の要約、会議の文字起こし、YouTube 動画からのクリップ候補作成、チームへのハイライト共有などを自動化できます。

WayinVideo API と Webhooks by Zapier を組み合わせれば、コンテンツ運用、ポッドキャストの再利用、ウェビナー後のフォローアップ、会議の要約、SNS クリップのレビュー、動画リサーチキュー向けの AI 動画自動化ワークフローを構築できます。

> WayinVideo 専用の Zapier アプリは不要です。WayinVideo API キーを使い、**Webhooks by Zapier** から接続できます。

---

## Zapier で自動化できること

- **YouTube から AI クリップを作成**: チャンネルの新規アップロードを検知し、タイトル、説明文、ハッシュタグ、タイムスタンプ、バイラルスコア付きのクリップ候補を生成します。
- **Zoom 録画の要約**: ウェビナーや会議録画を、構造化された要約とタイムラインハイライトに変換します。
- **Google Sheets の動画キュー**: 動画 URL の行を処理し、結果を同じスプレッドシートへ書き戻します。
- **文字起こしワークフロー**: 動画または音声 URL を [Video Transcription API](https://wayin.ai/ja/api-docs/video-transcription/) に送り、文字起こしを Airtable、Notion、CMS に保存します。
- **クリップレビューのワークフロー**: まずクリップメタデータを生成し、チームが [Clips Export API](https://wayin.ai/ja/api-docs/clips-export/) でエクスポートするクリップを選べるようにします。

---

## 仕組み

多くの Zapier ワークフローは、次の流れになります。

1. **トリガー**: 新しい行、ファイル、フォーム送信、動画、会議録画が Zap を開始します。
2. **送信**: Webhooks by Zapier が WayinVideo API endpoint に HTTP リクエストを送信します。
3. **待機 / ポーリング**: Zapier が result endpoint を確認し、`status` が `SUCCEEDED` または `FAILED` になるまで待ちます。
4. **ルーティング**: Zapier が要約、文字起こし、クリップメタデータ、export link を別のアプリへ送ります。

タスクステータスを確認する場合は、**30 秒**ごとのポーリングをおすすめします。

---

## 例: Google Sheets の動画を要約する

このワークフローでは [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) を使い、スプレッドシート内の動画 URL を構造化された要約とタイムラインハイライトに変換します。

トリガー:
`video_url` 列を含む Google Sheets の新しい行。

手順:
1. Webhooks by Zapier から [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) を呼び出し、`POST /api/v2/summaries` を実行します。
2. 返されたタスク `id` を同じ行に保存します。
3. Delay またはスケジュールされたフォローアップステップを追加します。
4. タスクが `SUCCEEDED` になるまで `GET /api/v2/summaries/results/{id}` を呼び出します。
5. `summary`、`tags`、`highlights` を Google Sheets に書き戻します。

最適な用途:
動画リストをスプレッドシートで管理している編集チーム、コンテンツリサーチャー、マーケター。

### 送信リクエスト

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example"
  }'
```

### ポーリングリクエスト

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

---

## 例: Zoom 録画をチーム向け要約に変換する

このワークフローでは [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) を使い、会議、ウェビナー、顧客通話の録画を、チームでそのまま使える要約に変換します。

トリガー:
新しい Zoom クラウド録画。

手順:
1. 録画 URL を [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) に送信します。
2. `status` が `SUCCEEDED` になるまで result endpoint をポーリングします。
3. 要約とタイムラインハイライトを Slack に送信します。
4. 結果を Notion、Airtable、HubSpot、Google Sheet に保存します。

最適な用途:
ウェビナーの振り返り、顧客通話、社内会議、インタビュー、トレーニングセッション。

---

## 例: 新しい YouTube 動画からクリップ候補を作成する

このワークフローでは [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) を使い、チームがエクスポートや公開を判断する前にショート動画向けのクリップ候補を検出します。

トリガー:
チャンネル内の新しい YouTube 動画。

手順:
1. YouTube URL を [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) に送信します。
2. クリップのタイムスタンプとメタデータだけが必要な場合は、`enable_export` を `false` に設定します。
3. タスクが完了するまで result endpoint をポーリングします。
4. クリップタイトル、説明文、タイムスタンプ、ハッシュタグ、スコアを Airtable または Google Sheets に送り、レビューできるようにします。

最適な用途:
レンダリングや公開の前にレビューキューを作りたいクリエイターや SNS チーム。

### 送信リクエスト

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "enable_export": false
  }'
```

---

## 推奨 API

| ワークフローの目的 | API |
|-------------------|-----|
| 長尺動画をショートクリップに変換 | [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) |
| 自然言語クエリで特定の瞬間を検索 | [Find Moments API](https://wayin.ai/ja/api-docs/find-moments/) |
| 構造化された動画概要とタイムラインハイライトを生成 | [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) |
| タイミングと話者ラベル付きの文字起こしを抽出 | [Video Transcription API](https://wayin.ai/ja/api-docs/video-transcription/) |
| 処理前にローカル動画または音声ファイルをアップロード | [Upload API](https://wayin.ai/ja/api-docs/upload/) |
| 選択したクリップをレンダリングまたは再エクスポート | [Clips Export API](https://wayin.ai/ja/api-docs/clips-export/) |

---

## ベストプラクティス

- API キーは Zapier の接続設定またはシークレットフィールドに保存し、公開 Zap テンプレートには入れないでください。
- 進行中のタスクを見失わないよう、返されたタスク `id` はすぐに保存します。
- Zapier の Delay やスケジュールされたフォローアップステップを使い、ポーリング頻度が高くなりすぎないようにします。
- `SUCCEEDED` と `FAILED` の両方の状態を必ず処理します。
- レビュー用にタイムスタンプとメタデータだけが必要な場合は、`enable_export: false` を使います。選んだクリップは後から [Clips Export API](https://wayin.ai/ja/api-docs/clips-export/) でエクスポートできます。

---

## FAQ

### WayinVideo には Zapier のネイティブアプリがありますか？

WayinVideo API は **Webhooks by Zapier** 経由で Zapier に接続できます。専用の Zapier アプリは不要です。

### Zapier で WayinVideo を使って YouTube 動画を要約できますか？

はい。YouTube トリガー、または YouTube URL を含む Google Sheets の行を使い、[Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) に送信して、生成された要約とハイライトを任意のアプリへ書き戻せます。

### Zapier で長尺動画からショートクリップを作成できますか？

はい。動画 URL を [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) に送信します。レビュー用にクリップメタデータだけを返すことも、エクスポートを有効にしてダウンロード可能なショートクリップをレンダリングすることもできます。

### Zapier はどのくらいの頻度でタスクステータスを確認すべきですか？

タスクステータスは **30 秒**ごとに確認することをおすすめします。各ポーリングステップが正しい結果を取得できるよう、タスク `id` を保存してください。