# 整合

> 一站式接上通路（WhatsApp、Telegram、Instagram、Messenger、電子郵件）與效率類整合（行事曆、Cal.com、Webhooks、Notion）。

Source: https://waslo.io/zh-TW/docs/integrations · Last updated: 2026-10-16

## 兩種連接

Waslo 的「整合」頁面分成兩大區：

**通路**——*客戶找到你的位置*。每個通路都是 AI 接收與回覆訊息的新入口。

**整合**——*AI 在這條對話裡能做的事*。行事曆預約、CRM 同步、潛客匯入、知識來源。

從側邊欄打開 **Integrations → Marketplace**。

## 通路

| 通路 | 認證方式 | 接入費用 |
|------|----------|----------|
| WhatsApp（QR） | 掃碼 | 免費（含第一個號碼） |
| WhatsApp Cloud API | Meta App + token | 免費 |
| Telegram | 一鍵建立機器人，或連接你自己的帳號 | 免費 |
| Instagram DM | Meta OAuth | 免費 |
| Facebook Messenger | Meta OAuth | 免費 |
| 網站聊天 | 嵌入程式碼片段 | 免費 |
| 電子郵件 — Gmail | Google OAuth | 即將推出 |
| 電子郵件 — Outlook | Microsoft Graph OAuth | 免費 |

**兩種方案都包含所有通路**，無需開通費。在按用付費下，每則回覆仍然消耗點數；Growth 的回覆不設上限。

**WhatsApp Cloud API 或官方 QR。** Cloud API 會讓號碼脫離 WhatsApp 應用程式；**官方 QR** 則保留你的 WhatsApp Business 應用程式，並把同一號碼接入 Meta 官方 API（同樣免費接入）。一個號碼同一時間只能以一種方式連接。自 2026 年 10 月 1 日起，AI 代理透過官方號碼傳送的每則回覆都由 Meta 收費 — 由 Meta 向你的 WhatsApp Business 帳戶計費，Waslo 在帳單頁面顯示。存取權杖會自動續期。請參閱[連接 WhatsApp](/docs/connecting-whatsapp)。

你在 Waslo 之外親自輸入的回覆，可能會暫停該客戶的 AI 代理。什麼算是你親自輸入的回覆，各通路不同——完整表格請見[人工轉接](/docs/human-handoff)。

### 接上通路的步驟

1. 打開 **Integrations → Marketplace**
2. 點選想接的通路卡片
3. 依該通路的流程操作（掃碼 / OAuth / 貼上 bot token 等）
4. 完成後，通路會在 marketplace 與「收件夾」的通路篩選器顯示為 "Connected"

## 整合（效率工具）

所有方案均已包含，無需解鎖：
- **Knowledge Base**——上傳 AI 可引用的文件
- **Notion**——把頁面分享給 Waslo 整合
- **CRM Webhooks**——把每一筆潛客事件即時送到你的 CRM 或 Zapier
- **Inbound Lead API**——從 Facebook 廣告、LeadsBridge 等渠道接收潛客
- **Telegram 通知**——HOT 潛客、轉真人、關鍵字命中時推給管理者
- **Google Calendar**——AI 直接幫你寫進行事曆
- **Cal.com**——以 API key 認證的備選行事曆
- **CSV Lead Import**——批次匯入潛客名單
- **商店同步**——從 Shopify、Salla、Zid 或 ikas 同步你的商品目錄
- **CRM 同步**——把潛客送到 HubSpot

一項付費附加項目：
- **Outbound Campaigns**——批次寄送範本給分群名單。按用付費下一次性 3,000 點，Growth 已包含。

## 不同通路各自設定 AI 個性

接上通路後，從側邊欄點進該通路（例如 **Integrations → Telegram**），會看到一個 **AI behaviour** 面板，可單獨為這個通路設定 prompt 與歡迎訊息。當你希望 Telegram 偏輕鬆、電子郵件偏正式時就用得上。

也可以集中在 **AI Agent → AI Personality → Context Selector** 操作——那裡會把所有通路和 WhatsApp 號碼放在一個清單。

## Telegram 通知（管理者警示）

不要和「Telegram 通路」搞混——這是 Waslo 內發生事件時，把通知推給**你自己的手機**。

1. 在 [@BotFather](https://t.me/BotFather) 建立一支 bot
2. 取得 token 和你自己的 chat ID（透過 [@userinfobot](https://t.me/userinfobot)）
3. 兩者貼進 **Integrations → Telegram Notifications**

之後 HOT 潛客、AI 申請轉真人、自訂關鍵字命中時都會收到提醒。

## CRM Webhooks

把潛客事件送到任意 URL（CRM、Zapier、n8n 等）。在 **Integrations → Webhooks** 設定。

會發送的事件：`lead.created`、`lead.classified`、`lead.handoff`、`message.received`、`message.sent`。`lead.classified` 只在最熱的階段觸發。

每個請求都會帶 `X-Waslo-Signature: sha256=<hex>` 標頭，方便你驗證簽章、確認來源是 Waslo。共享的密鑰會在你建立 webhook 時顯示。

## Inbound Lead API

透過 webhook 接收外部來源的潛客。專屬 URL 可以在 **Integrations → Webhooks → Inbound** 取得。

JSON 範例：
```json
{
  "phone": "+886912345678",
  "name": "林雨欣",
  "source": "facebook_ads",
  "customFields": { "budget": "5000" }
}
```

若你設定了簽章密鑰，會同時跑 HMAC 驗證。

## Google Calendar / Cal.com

接其中一個（或兩個都接），AI 就能直接在對話裡幫忙預約。優先順序：Google Calendar → Cal.com → 無。

接上後 AI 會獲得 4 個工具：`get_availability`、`book_slot`、`list_upcoming_appointments`、`cancel_appointment`。客戶不用離開對話就能完成預約。

## 接下來

- [AI 客服設定](/docs/ai-agent-configuration)
- [潛客管理](/docs/lead-management)
- [帳單與方案](/docs/billing-and-plans)——點數定價詳情