连接其他程序：API、webhook 以及 Slack 或 Teams 提醒

在集成（位于设置下）中，您可以把 Kaam360 与其他程序连接起来。这是 Business 套餐的一部分。只有管理员可以打开。

用 API 密钥读取数据

1. 打开设置并选择集成。
2. 在 API 密钥下输入一个名称（例如 Zapier 或 会计表格），然后按创建 API 密钥。
3. 复制显示的密钥。它只显示一次。持有密钥的人可以读取您组织的全部数据，请妥善保密。
4. 把密钥交给程序。程序在请求头 Authorization: Bearer ... 中发送它。使用 API 部分列出了地址和示例。
5. 密钥只能读取，除非创建时勾选了允许此密钥添加线索，这样它还能添加新线索。它永远不能修改或删除其他内容。按撤销可立即停用密钥。创建密钥的人在用户中被停用后，该密钥也会停止工作；请用另一位管理员的账户创建新密钥。

使用 Zapier 或 Make

Zapier 和 Make 无需编程即可连接程序。您不需要专门的 Kaam360 应用。

1. 按上述方法创建 API 密钥。如果希望表单、广告或表格把线索发送到 Kaam360，请勾选允许此密钥添加线索。
2. 在 Zapier 或 Make 中选择调用网址的步骤（Zapier：Webhooks by Zapier；Make：HTTP）。使用带有密钥的请求头 Authorization: Bearer ...。
3. 读取数据时调用使用 API 中列出的地址（例如 /api/v1/leads 或 /api/v1/deals）。要添加线索，请向 /api/v1/leads 发送 POST，并带上线索的姓或邮箱。
4. 使用 API 也链接到 /api/v1/openapi.json，即完整的 API 说明。包含较新 API（版本 2）的完整开发者指南见 /developers。
5. 若想在事情发生时得到通知，请在 webhook 中使用其他程序（带签名的 JSON）。

在 Slack 或 Microsoft Teams 中接收提醒

1. 在 Slack 或 Teams 中为目标频道创建一个传入 webhook 并复制其网址。
2. 在集成的 Webhook 与聊天提醒下输入名称，选择 一个 Slack 频道或 一个 Microsoft Teams 频道，并粘贴网址。
3. 在在以下情况通知下勾选您想了解的事件。什么都不勾选则通知所有事件。
4. 按添加地址，再按发送测试。频道中应出现一条简短的测试消息。

通知其他程序

1. 选择其他程序（带签名的 JSON）并输入其网址。网址必须以 https:// 开头且位于公共互联网上。
2. 复制显示的签名密钥。它只显示一次。其他程序用它来确认消息确实来自 Kaam360。
3. 每条消息都是 JSON，包含 ID、事件名称、简短摘要和主要信息。完整记录请通过 API 获取。
4. 每条消息都有签名：请求头 X-Kaam360-Signature 包含对发送时间（X-Kaam360-Timestamp）和消息计算的 HMAC-SHA256。接收方应拒绝超过五分钟的消息，以防复制的消息日后被再次发送。开发者指南提供了现成的校验代码。
5. 要修改地址、事件或备注，请按编辑。如果密钥可能已泄露，请按新的签名密钥：旧密钥立即失效，请马上把新密钥交给对方程序。

可以接收哪些通知

添加了客户或线索、商机赢单或丢单、创建或更改了项目、添加/更改/完成了任务、发票被编写/开具（发送）/付款/作废、项目付款进入下一阶段、合同已签署，以及创建了支持工单。

投递日志

投递日志列出最近两周的每条消息：发送时间、发送地址、接收方的响应（状态码和耗时）以及结果。

1. 选择某个地址、结果（已送达、等待重试、已放弃）或事件，只查看这些消息。
2. 按查看发送内容可查看消息以及接收方响应的开头部分。
3. 按再次发送可再次发送已送达或已放弃的消息。它保留相同的 ID，接收方能识别出是重复消息。

出现问题时

• 如果接收方无法访问，Kaam360 会在 1 分钟、5 分钟、30 分钟、2 小时和 12 小时后重试，然后放弃。
• 连续失败 15 次的地址会被关闭，所有可以管理集成的人都会收到邮件。页面上的红色提示会显示发生时间。修复问题后按恢复，再从投递日志重新发送遗漏的消息。
• 不允许使用私有网络内的地址（如 localhost、10.0.0.1 或 192.168.1.5），并且每次发送时都会重新检查。
• 如果看不到集成，可能是您的套餐不包含它，或您的角色没有管理集成权限。