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

# 自動化整合

> 使用 n8n 與 Make 串接帳獸 Webhook，建立自動化工作流與 AI 整合

## 概覽

帳獸提供完整的自動化整合支援，讓你透過 **n8n** 和 **Make** 這兩大自動化平台，將付款通知串接到各種服務。你可以在付款成功時自動發送 LINE 通知、更新 Google Sheet、發送 Email，甚至結合 AI 進行智慧分析。

## Webhook 文件中心

在後台的 **Webhook** > **Webhook 文件** 頁面，你可以：

* 查看完整的 Webhook Payload 欄位說明
* 一鍵複製 JSON 範例
* 瀏覽各事件類型（`order.created`、`order.paid`、`order.refunded`）的 Payload 結構

### Payload 範例

```json theme={null}
{
  "event": "order.paid",
  "timestamp": "2026-02-09T08:00:00Z",
  "data": {
    "id": 123,
    "order_no": "ORD-20260209-001",
    "amount": "1990.00",
    "currency": "TWD",
    "status": "paid",
    "payment_method": "credit_card",
    "customer": {
      "id": 1,
      "email": "wang.xiaoming@example.com",
      "name": "王小明"
    },
    "paid_at": "2026-02-09T08:00:00Z"
  }
}
```

## 工作流範本庫

帳獸提供預建的工作流範本，可直接匯入使用。

### n8n 範本

n8n 範本以 JSON 格式提供，可直接匯入到你的 n8n 實例。

<CardGroup cols={2}>
  <Card title="LINE Notify 通知" icon="bell">
    付款成功時，自動發送 LINE Notify 訊息給團隊。
  </Card>

  <Card title="Email 通知" icon="envelope">
    訂單建立時，自動發送確認 Email 給客戶。
  </Card>

  <Card title="Google Sheet 記帳" icon="table">
    每筆訂單自動寫入 Google Sheet，即時更新帳務表。
  </Card>

  <Card title="Slack 通知" icon="hashtag">
    在 Slack 頻道即時通知訂單與退款事件。
  </Card>
</CardGroup>

<Steps>
  <Step title="下載 n8n 範本">
    在後台的 **Webhook** > **工作流範本庫** 頁面，選擇你需要的 n8n 範本並下載 JSON 檔案。
  </Step>

  <Step title="匯入到 n8n">
    在你的 n8n 介面中，點擊 **Import from File**，選擇下載的 JSON 檔案。
  </Step>

  <Step title="設定憑證">
    在匯入的工作流中，更新各節點的憑證（如 LINE Notify Token、SMTP 設定等）。
  </Step>

  <Step title="設定 Webhook URL">
    將 n8n 工作流的 Webhook URL 填入帳獸後台的 Webhook 設定。
  </Step>

  <Step title="啟用工作流">
    在 n8n 中啟用工作流，開始接收通知。
  </Step>
</Steps>

### Make 範本

Make（原 Integromat）範本以 Blueprint 格式提供，附有 Step-by-step 教學。

<CardGroup cols={2}>
  <Card title="LINE Notify 通知" icon="bell">
    付款成功時，自動發送 LINE Notify 訊息。
  </Card>

  <Card title="Email 通知" icon="envelope">
    訂單建立時，自動發送通知信件。
  </Card>

  <Card title="Google Sheet 記帳" icon="table">
    每筆訂單自動寫入 Google Sheet。
  </Card>

  <Card title="Slack 通知" icon="hashtag">
    在 Slack 頻道即時通知訂單事件。
  </Card>
</CardGroup>

<Steps>
  <Step title="下載 Make Blueprint">
    在後台下載 Make Blueprint 檔案。
  </Step>

  <Step title="匯入到 Make">
    在 Make 中建立新 Scenario，選擇 **Import Blueprint**，上傳下載的檔案。
  </Step>

  <Step title="設定連線">
    依照教學設定各模組的連線與憑證。
  </Step>

  <Step title="設定 Webhook URL">
    將 Make Scenario 的 Webhook URL 填入帳獸後台的 Webhook 設定。
  </Step>

  <Step title="啟用 Scenario">
    在 Make 中啟用 Scenario。
  </Step>
</Steps>

## 整合教學

### 從零開始的完整流程

<Steps>
  <Step title="註冊帳獸帳號">
    前往 [帳獸官網](https://zangsho.com) 註冊帳號並建立商家。
  </Step>

  <Step title="取得 API Token">
    在後台的 **金鑰管理** 頁面建立 API Token。
  </Step>

  <Step title="設定 Webhook">
    在 **Webhook 設定** 頁面輸入你的自動化平台 Webhook URL。
  </Step>

  <Step title="匯入工作流範本">
    從範本庫下載並匯入適合的工作流。
  </Step>

  <Step title="測試整合">
    使用帳獸的 **發送測試** 功能驗證工作流是否正常運作。
  </Step>

  <Step title="上線啟用">
    確認測試通過後，啟用 Webhook 與工作流。
  </Step>
</Steps>

## 除錯指南

<AccordionGroup>
  <Accordion title="Webhook 通知未觸發">
    **可能原因：**

    * Webhook 開關未啟用
    * 事件訂閱未勾選對應事件
    * 使用了批次匯入 API（批次匯入不觸發 Webhook）

    **解決方案：**

    1. 確認 Webhook 設定頁面的啟用開關已開啟
    2. 檢查事件訂閱是否勾選了你需要的事件
    3. 改用單筆建立 API 來觸發 Webhook
  </Accordion>

  <Accordion title="簽章驗證失敗">
    **可能原因：**

    * Webhook Secret 不正確
    * Payload 解析方式有誤

    **解決方案：**

    1. 在後台確認 Webhook Secret 是否正確
    2. 確保使用原始 request body 進行簽章驗證
    3. 參考 [Webhook 設定指南](/guides/webhooks) 的簽章驗證範例程式碼
  </Accordion>

  <Accordion title="Payload 解析錯誤">
    **可能原因：**

    * Content-Type 設定不正確
    * JSON 解析失敗

    **解決方案：**

    1. 確保你的端點接受 `Content-Type: application/json`
    2. 使用 JSON parser 解析 request body
    3. 在 n8n/Make 中確認 Webhook 節點的設定為 JSON 格式
  </Accordion>

  <Accordion title="網路連線問題">
    **可能原因：**

    * 接收端點無法從外部存取
    * SSL 憑證問題
    * 防火牆阻擋

    **解決方案：**

    1. 確認端點 URL 使用 HTTPS 且從外部可存取
    2. 確認 SSL 憑證有效且未過期
    3. 確認防火牆未阻擋帳獸的請求
    4. 使用帳獸的**發送測試**功能檢查連線
  </Accordion>
</AccordionGroup>

## AI 整合指南

結合 AI 服務，你可以打造更智慧的自動化工作流。

### 應用場景

<CardGroup cols={2}>
  <Card title="AI 感謝信" icon="wand-magic-sparkles">
    付款成功後，使用 AI 根據訂單內容自動生成個人化感謝信，透過 Email 發送給客戶。
  </Card>

  <Card title="異常金額偵測" icon="triangle-exclamation">
    新訂單建立時，使用 AI 分析金額是否異常，自動發出警示通知。
  </Card>
</CardGroup>

### 支援的 AI 服務

| AI 服務            | 整合方式                         |
| ---------------- | ---------------------------- |
| OpenAI (GPT)     | n8n OpenAI 節點 / Make HTTP 模組 |
| Anthropic Claude | n8n HTTP 節點 / Make HTTP 模組   |
| Google Gemini    | n8n HTTP 節點 / Make HTTP 模組   |
| Azure OpenAI     | n8n HTTP 節點 / Make HTTP 模組   |

### Prompt 範本

以下是一個「付款成功感謝信」的 Prompt 範本：

```text theme={null}
你是一位友善的客服人員。請根據以下訂單資訊，生成一封簡短的中文感謝信。

客戶姓名：{{customer.name}}
訂單編號：{{order_no}}
付款金額：NT$ {{amount}}
付款時間：{{paid_at}}

要求：
- 使用繁體中文
- 語氣親切專業
- 100 字以內
- 包含訂單編號供客戶參考
```

### Payload 變數映射

將帳獸的 Webhook Payload 欄位映射到 AI Prompt 變數：

| Prompt 變數            | Payload 路徑            | 範例值                                                           |
| -------------------- | --------------------- | ------------------------------------------------------------- |
| `{{customer.name}}`  | `data.customer.name`  | 王小明                                                           |
| `{{customer.email}}` | `data.customer.email` | [wang.xiaoming@example.com](mailto:wang.xiaoming@example.com) |
| `{{order_no}}`       | `data.order_no`       | ORD-20260209-001                                              |
| `{{amount}}`         | `data.amount`         | 1990.00                                                       |
| `{{paid_at}}`        | `data.paid_at`        | 2026-02-09T08:00:00Z                                          |

### n8n AI 工作流範本

帳獸提供預建的 n8n AI 工作流範本，包含：

* Webhook 接收 → OpenAI 生成文字 → Email 發送
* Webhook 接收 → Claude 分析異常 → Slack 警示

你可以在後台的 **Webhook** > **工作流範本庫** 頁面下載 AI 相關範本。

## 下一步

<CardGroup cols={2}>
  <Card title="Webhook 設定" icon="webhook" href="/guides/webhooks">
    了解 Webhook 的完整設定流程。
  </Card>

  <Card title="藍新金流" icon="credit-card" href="/integrations/newebpay">
    串接藍新金流自動接收付款通知。
  </Card>
</CardGroup>