# Integrations 概览

**Integrations**（集成）用于将你的账户与你所使用的其他工具连接起来。打开 **Settings → Integrations**，选择一个服务，然后按步骤完成连接。

## 观看教程

{% embed url="https://youtu.be/KXNlnAwSEc8" %}

你最常用到的几项：

* **AI Providers** — 集中管理所有 AI 密钥的页面。Flow 智能体的回复由 **Anthropic (Claude)** 或 **DeepSeek** 驱动（若两者都已连接，则优先使用 DeepSeek）。**OpenAI** 为 AI Knowledge（FAQ 生成与搜索）、语音留言转写、图像理解和文章翻译提供支持 — 这些功能仅在 OpenAI 上运行。参见[如何获取你的 OpenAI API 密钥](/settings/how-to-get-your-openai-api-key)、[创建 Claude API 密钥](/settings/creating-a-claude-api-key-and-checking-usage-limits)和[创建 DeepSeek API 密钥](/settings/creating-a-deepseek-api-key)。
* **Google Sheets** — 连接你的 Google 账户后，你的 AI 智能体收集到的客户信息会直接进入你自己的电子表格，随时供团队使用。参见[连接 Google Sheets](/settings/connecting-google-sheets)。
* **Lark Base** — 将同样的信息发送到 Lark（飞书）Base 数据表，每位客户一行并持续更新。参见[连接 Lark Base](/settings/connecting-lark-base)。
* **Slack** — 在 Slack 频道中接收会话并直接回复，无需切换应用。
* **Webhooks** — 将会话事件实时推送到你自己的系统。
* **Dashboard apps** — 将你自己的工具直接嵌入会话视图中。
* **Google Translate** 和 **Dialogflow** 也可用于翻译和机器人工作流程。

部分功能（例如 AI Knowledge）需要先连接相应的服务商密钥。

## Webhooks

Webhook 会把你账户中发生的事件 — 新会话、消息、联系人变更等 — 实时发送到你自己的 URL。

1. 打开 **Settings → Integrations**，选择 **Webhooks**。
2. 点击 **Add new webhook**。
3. 输入 **Webhook Name** 和你的 **Webhook URL**。
4. 在 **Events** 下勾选你想接收的事件。
5. 点击 **Create webhook**。

创建 Webhook 后，系统会显示它的 **Secret**，你的系统可以用它来确认推送确实来自你的账户。请当场复制 — 之后也可以在该 Webhook 的编辑表单中找到。

### 发送 Flow 智能体收集的答案

勾选 **Flow submission created or updated**，即可把 Flow 智能体收集到的答案发送到 CRM、电子表格或任何接受 Webhook 的自动化工具。

何时发送：

* 客户的某个答案被收集或更改时。
* Flow 结束时。
* 某一轮对话没有收集到任何新内容时，不会发送。

每次推送包含：

* 目前为止收集到的所有答案，因此在 Flow 结束之前你的记录也能保持最新。
* 该提交是已完成还是仍在进行中。
* 联系人的姓名、电子邮件和电话号码、Flow 智能体的名称、会话编号以及收件箱名称。

## Send Webhook Event 操作

自动化规则也可以调用 Webhook。**Send Webhook Event** 操作会在规则每次运行时把会话详情发送到你的 URL — 包括那些需要在请求头中携带令牌、或需要 POST 以外请求方法的 CRM 和 API。

1. 打开 **Settings → Automation**，创建或编辑一条规则，并添加 **Send Webhook Event** 操作。
2. 输入 URL，并在旁边选择请求方法：POST、GET、PUT、PATCH 或 DELETE。
3. 对于 POST、PUT 和 PATCH，你可以在 **Custom payload (optional)** 中输入自己的 JSON，并用 **Insert variable** 插入会话详情。留空则发送标准内容。
4. 在 **Custom headers (optional)** 下点击 **Add header**，输入请求头名称和值 — 例如 `Authorization` 和 `Bearer your-token`。
5. 点击 **Test send** 检查端点是否接受该请求，然后保存规则。

须知：

* 每个操作最多 10 个请求头。请求头名称不能包含空格，值必须为单行，且不能设置 **Host**、**Content-Length**、**Transfer-Encoding** 和 **Connection**。
* GET 和 DELETE 请求不带请求体，因此请把参数放在 URL 中。
* **Test send** 使用相同的请求方法和请求头，并用你某个会话的数据填充。你的账户中至少需要有一个会话才能测试。
* **Macros** 和 **Inbound Webhooks** 中的 **Send Webhook Event** 操作，以及 Reply SLA 的违规自动化，也提供同样的选项。

## 可以插入到 payload 的内容

点击 payload 输入框上方的 **Insert variable**，即可在光标位置插入占位符。菜单按类别分组，也可以搜索：

* **Contact** — ID、姓名、名字和姓氏、邮箱、电话、Facebook 和 Instagram ID、公司名称、城市、国家，以及该联系人第一次和你聊天的时间。
* **Inbox** — ID、名称、渠道类型，以及接收这段对话的商家电话号码（WhatsApp、SMS 和 Twilio 收件箱）。
* **Assignment** — 被分配客服的姓名和邮箱、所属团队，以及负责这段对话的 Flow 智能体。
* **Conversation** — ID、链接、状态、优先级、标签（以逗号分隔）、开始时间和最后活动时间，以及客户从 Meta Click-to-Message 广告或帖子进来时的广告 ID。
* **Chat history (last 10 messages)** — 这段对话中客户、客服和机器人最近的消息。详见下文。
* **Flow answers** — 你的 Flow 智能体收集到的每一个答案，每个答案一个占位符。
* **Custom attributes** — 你的联系人属性和对话属性。

时间以 ISO 8601 格式发送，并带有时区偏移，例如 `2026-09-29T10:02:00+08:00`。

### 发送聊天记录

发送最近 10 条消息有两种方式。两种都按从旧到新排列，并且不包含内部备注和分配记录等活动消息：

* `{{conversation.chat_history}}` 以列表形式发送消息。每条消息包含 `role`（`customer`、`agent` 或 `bot`）、`sender`、`content`、`attachments` 和 `created_at`。放置时**不要**加引号，例如 `"history": {{conversation.chat_history}}`。
* `{{conversation.chat_history_text}}` 把同样的消息作为一段文字发送，每条消息一行，例如 `[2026-09-29 10:02] Customer (Aisyah): Is the 3-bedroom unit available?`。放置时**要**加引号。适合 CRM 的备注或描述字段。

如果你把 `{{conversation.chat_history}}` 放在引号里，编辑器会显示 **Chat history is a list: remove its quotes, or use {{conversation.chat_history_text}} for text.**，并且在修正之前无法使用 **Test send**。

## 相关文章

* [标签、属性与自动化](/settings/labels-attributes-and-automation)
* [Inbound Webhooks](/settings/inbound-webhooks)
* [Reply SLA](/settings/reply-sla)
* [连接 Google Sheets](/settings/connecting-google-sheets)
* [连接 Lark Base](/settings/connecting-lark-base)

---
Source: https://help.mampuai.com/zh/settings/integrations