跳到主要内容

查找下一个工具

文档/自动化/CRM 集成:HubSpot、Salesforce 和 Zoho
自动化

CRM 集成:HubSpot、Salesforce 和 Zoho

通过 HubSpot 工作流、Salesforce Flow 或 Apex,以及 Zoho CRM 的 Deluge 函数,使用 MaxScanner 处理 CRM 附件。

简要回答

各 CRM 使用自身的 HTTP 功能调用 MaxScanner API:HubSpot 工作流的 Webhook 或自定义代码操作,Salesforce Flow 的 HTTP Callout 或配合 Named Credential 使用的 Apex,或者 Zoho CRM 工作流函数中的 Deluge invokeurl。将附件 URL 发送到 /documents/import/ 或 /jobs/,把 jobId 保存在记录上,并在收到 processing.completed Webhook 时更新该记录。

基本模式

让 CRM 端保持精简。CRM 发送文件引用和一个稳定的 ID,MaxScanner 负责处理,再由一个 Webhook 处理程序(通常是一个小型无服务器函数或自动化工具)把结果写回。请将 API 密钥存放在 CRM 的机密存储中:HubSpot secrets、Salesforce Named Credential、Zoho 连接或组织变量。

  • 在 Idempotency-Key 中使用 CRM 记录 ID,例如 deal-18273-quote-pdf
  • 将 jobId 保存在记录上,以便之后与 Webhook 匹配
  • 立即下载 output.downloadUrl 来附加结果,该链接会在五分钟后过期

HubSpot

在包含相应功能的套餐(Operations Hub,现为 Data Hub,Professional 或 Enterprise 版)中,工作流可以通过“Send a webhook”操作或自定义代码操作调用外部 API。用 Node.js 编写的自定义代码操作可以调用 /jobs/,并将 jobId 作为输出返回,供后续步骤使用。

// HubSpot custom code action (Node.js). Add MAXSCANNER_API_KEY under Secrets.
exports.main = async (event, callback) => {
  const res = await fetch('https://maxscanner.app/api/v1/jobs/', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.MAXSCANNER_API_KEY}`,
      'Content-Type': 'application/json',
      'Idempotency-Key': `deal-${event.object.objectId}-quote-pdf`,
    },
    body: JSON.stringify({ url: event.inputFields.quote_url, filename: 'quote.docx', format: 'pdf' }),
  });
  const job = await res.json();
  callback({ outputFields: { maxscanner_job_id: job.jobId } });
};

Salesforce

为 https://maxscanner.app 创建一个 External Credential 和一个 Named Credential,并添加自定义请求头 Authorization: Bearer <key>。然后在 Flow 中通过 HTTP Callout 操作调用 API,或者如下所示从 Apex 调用。Callout 不能与尚未提交的 DML 在同一事务中运行,因此请从异步上下文(例如 Queueable Apex 或计划路径)触发它们。

HttpRequest req = new HttpRequest();
req.setEndpoint('callout:MaxScanner/api/v1/jobs/');
req.setMethod('POST');
req.setHeader('Content-Type', 'application/json');
req.setHeader('Idempotency-Key', 'opp-' + opp.Id + '-pdf');
req.setBody(JSON.serialize(new Map<String, Object>{
  'url' => fileUrl, 'filename' => 'contract.docx', 'format' => 'pdf'
}));
HttpResponse res = new Http().send(req);
Map<String, Object> job = (Map<String, Object>) JSON.deserializeUntyped(res.getBody());
opp.MaxScanner_Job_Id__c = (String) job.get('jobId');

Zoho CRM

创建一个连接,或将密钥存储在组织变量中,然后从附加到工作流规则的 Deluge 函数中调用 API。

headers = Map();
headers.put("Authorization", "Bearer " + zoho.crm.getOrgVariable("maxscanner_api_key"));
headers.put("Idempotency-Key", "lead-" + leadId + "-ocr");
body = {"url": fileUrl, "filename": "scan.png"};
resp = invokeurl
[
  url: "https://maxscanner.app/api/v1/documents/import/"
  type: POST
  parameters: body.toString()
  headers: headers
  content-type: "application/json"
];
info resp.get("documentId");

常见问题

HubSpot、Salesforce 或 Zoho 的应用市场中有原生的 MaxScanner 应用吗?

暂时没有。这里介绍的模式使用的是各 CRM 的标准 HTTP 功能,因此现在无需安装任何东西即可使用。

CRM 附件的 URL 是公开的吗?

通常不是。如果 CRM 提供的是私有链接或会过期的链接,请在你的函数中下载文件,并改用直接上传流程,而不是 /documents/import。

相关指南