---
title: WeTransact HubSpot 应用安装指南
slug: zh/wetransact-hubspot
icon: {"faIcon":"fa-brands fa-wordpress"}
createdAt: 2026-03-16T20:45:24.193Z
---

:::hint{type="danger"}
本指南适用于负责设置 WeTransact HubSpot 集成的 HubSpot 管理员或技术用户。如果您是希望创建 Co-Sell 交易或 Private Offers 的销售或市场用户，请参阅[HubSpot - 创建联合销售交易和私有报价](https://docs.wetransact.io/zh/hubspot)
:::

## 适用于 HubSpot 的 WeTransact：设置指南

适用于 HubSpot 的 WeTransact 应用允许您的销售团队直接从他们当前正在处理的 HubSpot 交易记录中注册 Microsoft private offers 和 co-sell 交易。销售代表提交的所有内容都会发送到 WeTransact，并进一步发送到 Microsoft Partner Center。不会有任何内容写回 HubSpot，并且该应用不请求写入权限。

设置大约需要十五分钟，共分为三个部分：连接并安装、将卡片添加到您的交易视图，以及验证。

## 开始之前

您需要：

- 一个已连接 Microsoft Partner Center 的 WeTransact 租户，以及该租户的**管理员**登录账号。
- 该租户中至少有一个已发布并标记为可用作模板的计划，以及至少一个已发布的解决方案。Private Offer 向导会列出计划；Co-Sell 向导会列出解决方案。
- 一个正在使用 Deals 的 HubSpot 账户，以及一个在该账户中拥有**超级管理员**权限的用户。安装应用和编辑交易记录视图都需要此权限。
- 在同一个浏览器中同时登录 WeTransact 和 HubSpot。

一个 WeTransact 租户只能连接一个 HubSpot 账户。如果您的组织拥有多个 HubSpot 账户，请先确定您的销售团队使用的是哪一个。

## 1. 将 HubSpot 连接到 WeTransact

请从 WeTransact 开始，而不是从 HubSpot Marketplace 开始。WeTransact 端会将您的 HubSpot 账户绑定到您的租户，以便卡片知道应使用哪个目录和 Partner Center。同一步骤也会安装该应用。

1. 以管理员身份登录 WeTransact，然后前往 **设置 → 集成**。
2. 点击 **连接 HubSpot**。您会被重定向到 HubSpot。如果您属于多个 HubSpot 账户，请选择您的销售团队使用的那个。
3. 查看请求的访问权限。该应用会请求对交易、联系人和公司的读取权限，以及可选的您账户货币设置访问权限。它不请求任何写入权限。请授予访问权限。
4. 随后您将返回 WeTransact。HubSpot 现在会显示为已连接，并显示其绑定的 HubSpot portal ID。请保留该 ID；它会显示在卡片上，也是支持团队会向您索取的信息。
5. 在 HubSpot 中，**设置 → 集成 → 已连接的应用** 现在会列出 **WeTransact HubSpot 应用**。无需在那里进行任何配置。

:::BlockQuote
**先从 Marketplace 安装了吗？** 该应用已经安装，但尚未绑定到租户，因此卡片会显示 *WeTransact 未连接* 以及您的 portal ID。请完成上面的第 1 到第 4 步。现有安装将被复用。
:::

## 2. 将卡片添加到交易记录

该应用为交易记录提供了两个卡片：**WeTransact 私人报价** 和 **WeTransact 联合销售**。HubSpot 不会自动放置应用卡片；Super Admin 需要将它们添加到交易视图一次，之后该视图的所有用户都将看到这些卡片。

1. 在 HubSpot 中前往 **设置 → 对象 → 交易 → 记录自定义**，然后打开您的团队使用的视图，通常是默认视图。
2. 在右侧边栏部分中，添加一个卡片，按 WeTransact 应用进行筛选，然后添加 **WeTransact 私人报价** 和 **WeTransact 联合销售**。将它们拖到靠近顶部的位置，以便销售代表无需滚动页面。
3. 保存该视图。如果您的团队使用不同的交易视图，请对每个需要这些卡片的视图重复此操作。

打开任意交易。两个卡片都会显示在右侧边栏中，首先显示 *正在检查您的 WeTransact 连接…*，然后显示其按钮：

- **开放 WeTransact 用户界面** 会在新标签页中打开您的 WeTransact 仪表板。
- **重新加载** 会在加载失败时刷新该链接。
- **开始私人优惠** / **开始联合销售** 会打开向导。

## 3. 验证

1. **连接。** 打开一个交易。每个卡片都会在几秒钟内显示其按钮。如果显示 *WeTransact 未连接*，请返回第 1 部分。
2. **仪表板链接。** 点击**开放 WeTransact 用户界面**。您的 WeTransact 仪表板将打开，并已登录到您连接的租户。
3. **目录。** 点击**开始私人优惠**。在第 1 步中，Products 列表会显示您已发布的计划。点击**取消**并确认；不会创建任何内容。
4. **预填充。** 在具有名称、金额和主要联系人的交易上，再次启动 Private Offer：Offer Name 和第一个订阅者电子邮件会被预填充。再次取消。
5. **真实运行，仅限沙盒。** 如果您的 Partner Center 连接是沙盒，请将向导运行到结束。否则请在此停止：已完成的 Private Offer 是发布到 Microsoft 的真实报价。

您的销售代表现在可以使用这两个向导。请将他们引导至 User Manual。

## 卡片的作用

### 从交易注册私人报价

在交易上点击**开始私人优惠**。共有五个步骤；交易中已有答案的字段会被预填充，并且可以更改。

1. **报价详情和产品。** Offer Name（来自交易名称）、Billing ID、Prepared By（您的电子邮件）、报价开始和结束月份或接受时开始、Offer Valid Until Date、Publisher Location，以及此报价所基于的产品和已发布计划。最多十个计划。
2. **订阅者。** 接收报价的客户联系人的电子邮件地址。交易的主要联系人会被预填充。最多五个，每次添加一个。
3. **每个计划的定价。** 对于每个选定的计划：合同期限、计费间隔、货币和价格，这些内容会从计划模板中预填充。还可选择次要货币、带日期的计费计划、包含数量和超额价格的自定义维度，以及计划允许时的最小或最大用户数。
4. **自定义条款和条件。** 粘贴您的条款 URL，或上传 PDF 并粘贴系统提供给您的 URL。可选。
5. **准备发布。** 勾选**准备发布**，然后点击**完成**。该报价将在 WeTransact 中创建并发布到 Microsoft。

之后可通过**开放 WeTransact 用户界面**在 WeTransact 中管理该报价。

### 从交易注册联合销售交易

在交易上点击**开始联合销售**。共有六个步骤，然后是确认。

1. **查找 Microsoft 客户。** 客户名称和国家/地区会从交易关联的公司中预填充。**下一步**会获取所有匹配的 Microsoft 客户。
2. **选择客户。** 从列表中选择一个。筛选在本地进行。
3. **交易详情。** Deal Name、Estimated Value、Currency 和 Estimated Closing Date（从交易中预填充）、Your CRM ID（预填充为指向此 HubSpot 交易的链接）、Your Campaign ID、Organization、Solution Area、Conversation 和 Notes。
4. **团队成员。** 选择现有团队成员，或添加包含姓名、电话和电子邮件的新成员。至少一个。
5. **解决方案。** 至少选择一个您已发布的解决方案。
6. **Microsoft 参与和提交。** 选择 Microsoft 的参与级别，填写主要客户联系人，然后点击**提交**。
7. **确认。** *交易已提交*确认 Microsoft 已接受该注册。

## 卡片从 HubSpot 读取的内容

每个卡片都会从其打开的交易中读取一组固定属性，仅用于预填充向导。不会存储任何内容，也不会写入任何内容。

| 读取来源     | 属性              | 用途                                   |
| -------- | --------------- | ------------------------------------ |
| 交易       | 交易名称、金额、货币、关闭日期 | Offer 名称；联合销售 Deal 名称、预估价值、货币、预估关闭日期 |
| 交易的主要联系人 | 电子邮件            | 第一个私有 offer 订阅者                      |
| 交易关联的公司  | 名称、国家/地区        | 联合销售客户搜索                             |
| 账户       | 默认货币（可选范围）      | 当交易没有货币时使用的联合销售货币                    |
| 您        | 您的 HubSpot 用户   | 私有 offer 中的 Prepared By              |

## 权限

该应用使用 HubSpot OAuth 并请求：

- `crm.objects.deals.read`, `crm.objects.contacts.read`, `crm.objects.companies.read`：读取交易、其主要联系人和关联公司以进行预填充。
- `settings.currencies.read`（可选）：您的账户默认货币，用作联合销售交易的后备货币。

无写入 scope。销售代表输入的数据会通过 HTTPS 发送到 WeTransact 的 CRM 连接器 `crmproxy.wetransact.io`，该连接器会使用您租户自己的凭据在 Microsoft Partner Center 上执行操作。HubSpot 会对来自卡片的每个请求进行签名，以便连接器验证请求来自哪个账户。

## 故障排除

| 您看到                           | 原因                                  | 修复方法                                                                            |
| ----------------------------- | ----------------------------------- | ------------------------------------------------------------------------------- |
| *WeTransact 未连接*              | 此 HubSpot 账户未绑定到 WeTransact tenant。 | WeTransact 管理员在 Settings → Integrations 下点击 Connect HubSpot。然后在卡片上点击 **再检查一次**。 |
| *无法访问 WeTransact*             | 这是网络或服务问题，而不是设置问题。                  | 点击 **重试**。如果问题持续存在，请联系支持团队，并提供卡片上显示的 portal ID。                                 |
| 交易中缺少卡片                       | 应用卡片不会自动放置，或者用户当前处于其他视图。            | 请参阅上文第 2 部分。                                                                    |
| 联系人或公司中缺少卡片                   | 这是设计使然；卡片仅适用于交易。                    | 打开交易。                                                                           |
| 产品或解决方案列表为空                   | 已连接 tenant 中没有可用的已发布计划或解决方案。        | 在 WeTransact 中发布该计划并将其启用为模板，或发布一个解决方案。                                          |
| **开放 WeTransact 用户界面** 保持禁用状态 | 仪表板链接加载失败。                          | 点击 **重新加载**。                                                                    |

## 断开连接或卸载

这是两个独立的操作；请同时执行这两个操作以彻底移除集成。

1. 在 WeTransact 中，前往 **设置 → 集成**，移除 HubSpot 连接。卡片会立即显示 *WeTransact 未连接*。
2. 在 HubSpot 中，前往 **设置 → 集成 → 已连接的应用**，打开 WeTransact HubSpot App 并卸载。这将撤销访问权限，并从所有视图中移除卡片。

已创建的报价和注册信息仍会保留在 WeTransact 和 Microsoft Partner Center 中。

## 支持

[support@wetransact.io](mailto\:support@wetransact.io)。请附上卡片上显示的 HubSpot portal ID。
