集成

集成让您的智能体从互客鱼数据库之外的数据（Notion、Google Docs）中学习， 并让潜在客户流入您现有的系统（CRM、Slack、webhooks）。打开 /app/integrations 管理它们。

Notion

通过 OAuth 连接一次。互客鱼在 OAuth 流程中请求您选择的工作区的读取访问权限 — 我们永远不会获得全局访问权限。连接后：

• 添加源模态框公开一个 Notion 选择器（页面或数据库）。
• 每个选择的页面成为一个 Notion 源并通过 IngestNotionPageJob 摄取。
• 重新同步是手动的（每个源的重新索引）— 我们不按计划轮询 Notion。
• OAuth 令牌使用 Laravel 的 encrypted 转换在静态时加密。

Google Docs

与 Notion 相同的形状。一次 OAuth，从 Drive 选择器中选择文档，通过 IngestGoogleDocJob 摄取，每个源手动重新同步。令牌静态加密。 随时断开连接 — 断开连接会立即撤销我们的访问权限并阻止进一步同步。

Slack

Slack 用于出站通知：

• 新潜在客户 — 发布到可配置的频道。
• 路由对话 — 当收件箱需要人工时 ping。
• 每日摘要 — 对话量 + 新缺口的选择加入摘要。

通过 OAuth 连接，选择频道，保存。机器人以集成的名义发布，从不以用户名义。

Webhooks（出站）

互客鱼可以在事件发生时 POST 到您的端点。在 /app/integrations/webhooks 下配置。可用事件：

事件	何时触发
lead.captured	小部件潜在客户表单已提交（当前唯一发送的事件）。

您可能在旧路线图中看到的其他事件名称（conversation.started、 conversation.message、conversation.routed、 lead.updated）在路线图上但尚未连接。通过扩展 SignedDispatcher 添加其他事件。

每个 webhook 都有一个签名秘密。互客鱼使用该秘密 HMAC 主体并在 X-hukeyu-Signature 头中发送摘要 — 接收时验证它。 lead-captured 调度器（app/Services/Webhooks/SignedDispatcher.php） 设计为单次尝试（潜在客户已经持久化；失败的 webhook 传递显示在工作流运行日志中， 而不是阻塞访客的提交）。工作流步骤 webhooks（DispatchWebhookJob） 通过 Laravel 的队列重试机制最多重试 3 次。

参见 出站 webhooks 了解负载形状。

HubSpot / Salesforce / Zapier

上面的 webhooks 是通用逃生舱口 — 它们适用于任何可以接收 HTTP POST 的东西。 原生 HubSpot 和 Salesforce 集成在路线图上；同时，将 webhook 指向 Zapier catch-hook 并让 Zapier 路由到您的 CRM。

断开连接

每个集成的行都有一个断开连接按钮。我们：

• 撤销我们与上游提供商（Notion / Google）的 OAuth 令牌。
• 将本地 integration_connection 行标记为非活动。
• 停止同步 — 由集成支持的源进入“孤立”状态并停止刷新，但其已索引的内容保持可用。

重新连接重新运行 OAuth 流程并重新绑定现有源。不会丢失数据。

权限

连接集成需要 integrations.manage 权限，授予所有者和管理员。 成员可以看到哪些集成已连接，但不能更改它们。