# 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 很適合輕量的 no-code 工作流程：當某個業務事件發生時，自動觸發影片處理任務，例如摘要新的錄影、轉錄會議、從 YouTube 影片產生片段候選，或把重點傳給團隊。

透過 WayinVideo API 與 Webhooks by Zapier，你可以為內容營運、Podcast 再利用、網路研討會後續跟進、會議摘要、社群短片審核、影片研究佇列建立 AI 影片自動化流程。

> WayinVideo 不需要專屬的 Zapier app。你可以使用 WayinVideo API key，透過 **Webhooks by Zapier** 連線。

---

## Zapier 可以自動化什麼

- **YouTube 轉 AI 短片**：偵測頻道新上傳影片，產生含標題、描述、主題標籤、時間戳與 viral score 的片段候選。
- **Zoom 錄影摘要**：將網路研討會或會議錄影轉成結構化摘要與時間軸重點。
- **Google Sheets 影片佇列**：處理每一列影片 URL，並把結果寫回同一份試算表。
- **轉錄工作流程**：將影片或音訊 URL 傳送到 [Video Transcription API](https://wayin.ai/zh-tw/api-docs/video-transcription/)，並把逐字稿存到 Airtable、Notion 或 CMS。
- **片段審核工作流程**：先產生片段 metadata，再讓團隊決定哪些片段要透過 [Clips Export API](https://wayin.ai/zh-tw/api-docs/clips-export/) 匯出。

---

## 運作方式

多數 Zapier 工作流程會遵循以下模式：

1. **觸發**：新的資料列、檔案、表單提交、影片或會議錄影會啟動 Zap。
2. **提交**：Webhooks by Zapier 將 HTTP request 傳送到 WayinVideo API endpoint。
3. **等待 / 輪詢**：Zapier 檢查 result endpoint，直到 `status` 變成 `SUCCEEDED` 或 `FAILED`。
4. **路由**：Zapier 將摘要、逐字稿、片段 metadata 或 export link 傳送到另一個 app。

檢查任務狀態時，建議每 **30 秒**輪詢一次。

---

## 範例：摘要 Google Sheets 中的影片

這個工作流程使用 [Video Summarization API](https://wayin.ai/zh-tw/api-docs/video-summarization/)，將試算表中的影片 URL 轉成結構化摘要與時間軸重點。

觸發：
Google Sheets 中含有 `video_url` 欄位的新資料列。

步驟：
1. 使用 Webhooks by Zapier 呼叫 [Video Summarization API](https://wayin.ai/zh-tw/api-docs/video-summarization/)，執行 `POST /api/v2/summaries`
2. 將回傳的任務 `id` 存在同一列
3. 加入延遲或排程後續步驟
4. 呼叫 `GET /api/v2/summaries/results/{id}`，直到任務達到 `SUCCEEDED`
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/zh-tw/api-docs/video-summarization/)，將會議、網路研討會或客戶通話錄影轉成可直接分享給團隊的摘要。

觸發：
新的 Zoom 雲端錄影。

步驟：
1. 將錄影 URL 傳送到 [Video Summarization API](https://wayin.ai/zh-tw/api-docs/video-summarization/)
2. 輪詢 result endpoint，直到 `status` 變成 `SUCCEEDED`
3. 將摘要與時間軸重點傳送到 Slack
4. 將結果儲存到 Notion、Airtable、HubSpot 或 Google Sheet

適合：
網路研討會回顧、客戶通話、內部會議、訪談與訓練課程。

---

## 範例：從新的 YouTube 影片建立片段候選

這個工作流程使用 [AI Clipping API](https://wayin.ai/zh-tw/api-docs/ai-clipping/)，在團隊決定匯出或發布前，先偵測適合短影音的片段候選。

觸發：
頻道中的新 YouTube 影片。

步驟：
1. 將 YouTube URL 傳送到 [AI Clipping API](https://wayin.ai/zh-tw/api-docs/ai-clipping/)
2. 如果只需要片段時間戳與 metadata，將 `enable_export` 設為 `false`
3. 輪詢 result endpoint，直到任務完成
4. 將片段標題、描述、時間戳、主題標籤與分數傳送到 Airtable 或 Google Sheets 進行審核

適合：
希望在算圖或發布前建立審核佇列的創作者與社群團隊。

### 提交請求

```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/zh-tw/api-docs/ai-clipping/) |
| 用自然語言查詢找出特定時刻 | [Find Moments API](https://wayin.ai/zh-tw/api-docs/find-moments/) |
| 產生結構化影片概覽與時間軸重點 | [Video Summarization API](https://wayin.ai/zh-tw/api-docs/video-summarization/) |
| 擷取含時間與說話者標籤的逐字稿 | [Video Transcription API](https://wayin.ai/zh-tw/api-docs/video-transcription/) |
| 處理前上傳本機影片或音訊檔 | [Upload API](https://wayin.ai/zh-tw/api-docs/upload/) |
| 算圖或重新匯出選定片段 | [Clips Export API](https://wayin.ai/zh-tw/api-docs/clips-export/) |

---

## 最佳實務

- 將 API key 存在 Zapier 的 connection 或 secret fields，不要放進公開 Zap 範本。
- 立即儲存回傳的任務 `id`，避免 retry 時遺失進行中的任務。
- 使用 Zapier delay 或排程後續步驟，避免過於頻繁地輪詢。
- 一定要處理 `SUCCEEDED` 與 `FAILED` 兩種狀態。
- 當團隊只需要時間戳與 metadata 進行審核時，使用 `enable_export: false`。選定片段可稍後透過 [Clips Export API](https://wayin.ai/zh-tw/api-docs/clips-export/) 匯出。

---

## FAQ

### WayinVideo 有原生 Zapier app 嗎？

你可以透過 **Webhooks by Zapier** 將 WayinVideo API 連接到 Zapier，不需要專屬的 Zapier app。

### Zapier 可以用 WayinVideo 摘要 YouTube 影片嗎？

可以。使用 YouTube trigger，或包含 YouTube URL 的 Google Sheets 資料列，將影片送到 [Video Summarization API](https://wayin.ai/zh-tw/api-docs/video-summarization/)，再把產生的摘要與重點寫回你選擇的 app。

### Zapier 可以從長影片建立短片嗎？

可以。將影片 URL 傳送到 [AI Clipping API](https://wayin.ai/zh-tw/api-docs/ai-clipping/)。你可以只回傳片段 metadata 供審核，也可以啟用匯出來算出可下載的短片。

### Zapier 應該多常檢查任務狀態？

建議每 **30 秒**檢查一次任務狀態。請儲存任務 `id`，讓每個輪詢步驟都能取得正確結果。