连接 Bling ERP 并同步客户、产品、订单与发票
通过 OAuth 将你的 Bling 账号（一款巴西 ERP）连接到 CRM，并双向同步客户、产品、销售订单和发票，且不会产生重复数据。
你可以将 Bling 账号连接到 CRM。连接后，CRM 会从 Bling 拉取客户（作为联系人或公司）、产品、销售订单和发票，并通过 Bling 的 ID 保持所有数据关联。重新同步不会产生重复数据：它会更新已存在的记录。
该模式为“自带账号”（BYO）：你使用自己的 Bling 账号和 OAuth 应用。我们绝不会看到你的凭据，也不会产生任何费用。集成初始状态为静默：在你配置凭据并启用之前，不会发生任何操作。
前提条件
- 拥有可访问 API v3 的 Bling 账号。
- 在 Bling（开发者区域）创建的应用，你可以从中获取 Client ID 和 Client Secret，并授权它以获得 OAuth refresh token。
- 在 Sellio 中是管理员（具备“管理设置”权限），以便在“设置 → 集成”下保存凭据。
第一步：在 Bling 中创建应用
- 在 Bling 中打开应用/开发者区域，使用 API v3 创建一个新应用。
- 复制该应用的 Client ID 和 Client Secret。
- 为你的账号运行该应用的 OAuth 授权流程，并保存生成的 refresh token。CRM 会使用该 refresh token 自行续期访问权限。
第二步：将凭据粘贴到 CRM 中
- 打开“设置 → 集成”，找到“Bling ERP”卡片。
- 粘贴 Client ID、Client Secret 和 refresh token。凭据会被加密存储，且不会再次显示。
- 在“实体与方向”中，为客户、产品、订单和发票选择同步方式：从 Bling 拉取、推送到 Bling、双向同步，或不同步。
- 点击“保存连接”，然后点击“启用”。
第三步：同步并接收更新
- 点击“立即同步”以立即从 Bling 拉取数据。系统每天也会自动运行一次同步。
- 若要近乎实时地接收变更，请将 Bling 的通知（webhook）指向卡片上显示的 URL。该 URL 包含一个密钥令牌，请妥善保密。
- 我们强烈建议在卡片上填写“Webhook 密钥”，并在 Bling 中使用相同的值。由于该 webhook 会向你的 CRM 中写入记录（联系人、订单、发票），密钥可通过签名（HMAC）保证每次调用的真实性。
个人客户会成为“联系人”，公司客户会成为“公司”。每个产品会成为一个“产品”，每个销售订单会成为一个“销售订单”（与客户关联），每张发票会成为一条包含编号、金额和 DANFE 链接的活动记录。
安全与隐私
Client Secret 和 refresh token 均加密存储且不会再次显示。访问令牌到期时会自动续期，无需重新授权。连接初始状态为静默，只有在配置并启用后才会开始同步。
💡 安全建议：设置“Webhook 密钥”。Bling 的 webhook 会向你的 CRM 写入记录（联系人、订单、发票），因此应将其视为数据写入入口。设置密钥后，每次调用都会通过签名进行校验，只有知道密钥的一方才能通过。如果没有设置，唯一的保护就是 URL 中的令牌：一旦该令牌泄露，任何人都可能向你的账号注入数据。这不是强制要求，但强烈建议设置。
Example: 在 Bling 中注册的 Webhook URL：https://app.yourcompany.com/api/inbound/bling/YOUR-TOKEN（复制卡片上显示的确切值）。
如何测试
- 保存并启用后，点击“立即同步”并等待确认。
- 打开“联系人”“产品”和“销售订单”列表，检查 Bling 的记录是否已出现。
- 在卡片上观察“各实体的关联数量”随数据同步而增长。
故障排查
- 没有任何同步发生：确认集成状态为“已启用”，且至少有一个实体设置为“从 Bling 拉取”或“双向同步”。
- 同步时出现凭据错误：重新输入 Client ID、Client Secret 和 refresh token（Secret 和 token 不会从服务器回传，因此需要完整粘贴）。
- 记录没有出现：确认你的账号中存在“联系人”“公司”“产品”和“销售订单”对象（它们是标准对象）。
- Webhook 没有收到数据：检查在 Bling 中注册的 URL 是否与卡片上显示的一致；如果使用了 Webhook 密钥，请确认双方设置的值相同。