Mampu AI Docs/集成/Integrations 概览

Integrations 概览

最后更新
本页内容
本页内容

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

观看教程

你最常用到的几项：

  • AI Providers — 集中管理所有 AI 密钥的页面。Flow 智能体的回复由 Anthropic (Claude) 或 DeepSeek 驱动（若两者都已连接，则优先使用 DeepSeek）。OpenAI 为 AI Knowledge（FAQ 生成与搜索）、语音留言转写、图像理解和文章翻译提供支持 — 这些功能仅在 OpenAI 上运行。参见如何获取你的 OpenAI API 密钥、创建 Claude API 密钥和创建 DeepSeek API 密钥。
  • Google Sheets — 连接你的 Google 账户后，你的 AI 智能体收集到的客户信息会直接进入你自己的电子表格，随时供团队使用。参见连接 Google Sheets。
  • Lark Base — 将同样的信息发送到 Lark（飞书）Base 数据表，每位客户一行并持续更新。参见连接 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、标题、URL 和内容，加上这次点击的点击 ID、最近一次点击时间和点击次数（conversation.ad_click_id、conversation.ad_clicked_at、conversation.ad_click_count）。
  • Chat history — 这段对话中客户、客服和机器人最近的消息，以及用来筛选它们的 Choose role, type and count…。详见下文。
  • Flow answers — 你的 Flow 智能体收集到的每一个答案，每个答案一个占位符。
  • Custom attributes — 你的联系人属性和对话属性。

Insert variable 菜单，滚动到 Chat history 部分

时间以 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。

选择要发送哪些消息

如果只想发送部分消息，或超过 10 条，在 Insert variable 菜单的 Chat history 下选择 Choose role, type and count…。payload 框下方会打开一个面板：

聊天记录选项：Format、Sent by、Message type 和 Number of messages

选项 可以选择的内容
Format JSON list（{{conversation.chat_history}}）或 Plain text（{{conversation.chat_history_text}}）。
Sent by Everyone、Customer、Agent 或 Bot。
Message type All types、Text only（没有附件的消息）、Images、Videos、Audio、Files、Locations 或 Contacts。
Number of messages 1 到 100；不改动时为 10。

点击 Insert。占位符会带上你改动过的选项，例如 {{conversation.chat_history | role: "customer" | type: "text" | limit: 50}} 会发送客户最近的 50 条文字消息，按从旧到新排列。数量在其他选项之后生效，所以你得到的是 50 条客户消息，而不是 50 条消息里只有一部分来自客户。

插入占位符后的 payload

你也可以自己输入或修改这些选项。如果选项拼错或填了编辑器不认识的值，Test send 会显示 Check the variable options: … 并说明问题，且不会发送任何内容。普通的 {{conversation.chat_history}} 和 {{conversation.chat_history_text}} 仍然发送所有人最近的 10 条消息。

请求失败时

如果接收系统没有接受自动化规则发出的 Send Webhook Event 请求，账户管理员会收到一封邮件。第一次失败会开始一个 10 分钟的时间窗口，窗口结束时一封邮件会列出这段时间内所有失败的请求。所以 CRM 出故障时，你只会收到一封邮件，而不是每个潜在客户一封。

一封列出三个失败请求的邮件，包含自动化、潜在客户和原因

每一行显示自动化名称、调用的网站、时间、带会话链接的潜在客户，以及失败原因：

邮件中的说明 需要检查
refused the login Custom headers (optional) 中的令牌或密钥
could not find what was sent URL，以及该记录在对方系统中是否存在
answered with an error 接收系统本身
did not answer in time 接收系统是否正常运行且可以访问
address is not allowed URL

失败的请求不会自动重发，所以接收系统恢复后，请确保列出的潜在客户已送达。邮件最多列出 25 个请求，并说明还有多少个失败。它涵盖自动化规则，包括 Reply SLA 的违规自动化；Test send 则直接在屏幕上显示结果。

相关文章