# 集成

> 一站式接入渠道（WhatsApp、Telegram、Instagram、Messenger、邮件）以及效率类集成（日历、Cal.com、Webhooks、Notion）。

Source: https://waslo.io/zh-CN/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** 里拿到。

POST 的 JSON 示例：
```json
{
  "phone": "+861380013800",
  "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)——积分定价的详细说明