DocSpace 的 Pipedrive 集成

主要功能

• 在 Pipedrive 交易中创建协作空间房间。
• 在 Pipedrive 交易中的协作空间房间内创建和编辑文档、电子表格、演示文稿和 PDF 表单。

支持的格式

• 用于创建、编辑和查看：DOCX、PPTX、XLSX。
• 用于填写表单：PDF。
• 用于查看：CSV、DJVU、DOC、DOCM、DOT、DOTM、DOTX、EPUB、FB2、FODP、FODS、FODT、HTM、HTML、MHT、ODP、ODS、ODT、OTP、OTS、OTT、OXPS、PDF、POT、POTM、POTX、PPS、PPSM、PPSX、PPT、PPTM、RTF、TXT、XLS、XLSM、XLT、XLTM、XLTX、XML、XPS。

版本 1.1.0 的新功能

新增

• 创建时选择房间类型的功能
• 使用 @onlyoffice/docspace-sdk-js

更改

• 支持 DocSpace 3.0
• 使用 DocSpace API 密钥代替系统用户
• 邀请“共享组”到附加到交易的房间，具有“内容创建者”权限
• 邀请交易关注者到附加到交易的房间，具有“内容创建者”权限
• 使用 API 创建带标签的房间
• 默认创建公共房间

完整的更改日志可在此处查看。

要求

• Pipedrive 账户。
• ONLYOFFICE 协作空间 SaaS 或 服务器 版本。
• ONLYOFFICE 协作空间的 Pipedrive 应用。

安装和配置 ONLYOFFICE 协作空间的 Pipedrive 应用

ONLYOFFICE 协作空间应用可以通过 Pipedrive 市场安装。

Pipedrive 管理员可以通过 Pipedrive 中的 市场应用 部分配置应用：工具和应用 -> 市场应用 -> ONLYOFFICE 协作空间应用。

配置您的协作空间

1. 使用位于左下角的 菜单并选择 设置 选项。
2. 切换到 开发者工具 -> API 密钥 部分。
3. 点击 创建新密钥 按钮。
   API 密钥必须由具有协作空间管理员角色的用户创建。
4. 填写表单：
   • 名称 - 指定密钥名称。
   • 权限 - 您可以设置权限为 全部 或选择 限制 选项以设置自己的权限。
     • 全部 - 启用所有部分的读写权限。
     • 限制 - 启用某些部分的读或写权限。勾选必要选项旁的 读 或 写 框。API 密钥的最低权限：房间 - 写，个人资料 - 读，联系人 - 写。
   
5. 点击 生成 按钮。
6. 在新窗口中，复制生成的密钥并点击 完成。

配置您的 Pipedrive

要安装 ONLYOFFICE 协作空间应用：

1. 打开 市场 部分。
2. 使用页面顶部的搜索栏在 应用 部分找到 ONLYOFFICE 协作空间。
3. 在打开的窗口中点击 授权 按钮。
4. 如果您同意授予应用的权限，请点击 允许并安装 按钮。
5. 显示“如何使用 ONLYOFFICE 协作空间”的说明。之后，将打开 连接设置。
6. 在 协作空间服务地址 字段中，指定已安装的 ONLYOFFICE 协作空间 的 URL 或 ONLYOFFICE 协作空间云 的地址，然后按箭头按钮。
7. 在 ONLYOFFICE 协作空间 API 密钥 字段中，指定您生成的密钥。
8. 点击 连接 按钮。

如果连接成功，此页面上将出现两个按钮：

• 更改：可以连接另一个协作空间。当前协作空间中的数据不会被删除。
• 断开连接：完全禁用应用（清除用户授权和钩子）。在这种情况下，Pipedrive 用户组与 Pipedrive 的连接将被移除。我们建议仅在需要完全清除协作空间应用中的数据时使用此选项。

授权设置

一旦配置了 连接设置，此部分即可用。

在此处输入您的协作空间凭据（电子邮件和密码）并点击 登录。

成功授权后，将显示有关使用连接器的说明。

查看说明后（当按下 跳过 或 完成 按钮时），授权页面上将显示授权状态和 注销 按钮。转到交易 按钮也可用，以便您可以切换到所需的 Pipedrive 部分。打开指南 按钮允许您再次打开有关使用连接器的说明。

应用使用

ONLYOFFICE 协作空间的 Pipedrive 应用可以通过 Pipedrive 的交易部分访问：转到相应的交易并找到协作空间框架。

对于每个交易，您可以创建一个单独的协作空间房间，交易参与者可以在其中共同处理办公文档。要创建房间，请点击 创建房间 按钮。在协作空间中将创建一个公共房间。

如果您需要其他房间类型，请点击 创建房间 按钮旁边的箭头并选择适当的选项：

• 公共房间 - 与外部用户和客户共享文件
• 协作房间 – 与您的团队共同编辑文档
• 虚拟数据室（VDR） – 提供高级文件保护
• 表单填写房间 – 在 PDF 表单中收集数据
• 自定义房间 – 根据您的目标工作

在新窗口中确认房间创建。了解更多关于房间类型的信息。

房间名称遵循规则 Pipedrive - 公司名称 - 交易名称。房间还标有“Pipedrive 集成”标签，以便于识别和组织。

在协作空间框架内，交易参与者可以根据其访问权限进行工作。

访问权限

所有登录协作空间应用的 Pipedrive 用户都会被添加到 Pipedrive 用户（公司名称） 组中。如果用户退出协作空间，他们将从组中移除。

交易内房间的访问权限由 Pipedrive 对相应交易的访问权限决定。

• 所有用户：房间对 Pipedrive 用户组开放，并且关注者按名称邀请（仅限那些已安装协作空间应用并已授权的用户）。
• 项目所有者：房间仅对交易所有者和按名称邀请的关注者开放。在这种情况下，交易所有者和关注者必须安装协作空间应用并通过授权。
• 项目所有者的可见性组：仅同步关注者（在 Pipedrive 的付费版本中可用）。
• 项目所有者的可见性组和子组：仅同步关注者（在 Pipedrive 的付费版本中可用）。

重要须知

1. 如果用户在协作空间中手动删除了 Pipedrive 用户组，则首次访问时会自动恢复。
2. 如果用户在协作空间中手动删除了与 Pipedrive 交易关联的房间，可以通过点击应用框架中的 创建房间 按钮再次创建房间。
3. 如果 Pipedrive 用户没有访问交易内房间的权限，他们可以通过点击相应按钮请求访问。此操作将检查用户是否应有权访问房间。如果他们应该，则根据访问权限将用户添加到房间中。如果不应该，则会显示相应通知。
4. 如果 API 密钥失效（由于过期或权限更改），应用将被阻止。点击 转到设置 按钮并检查 API 密钥（参见 配置您的 Pipedrive 小节）。
5. 如果未配置 Webhooks，则需要通过点击相应按钮重新安装插件。