跳至主要內容

尋找下一個工具

說明文件/自動化/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。將附件網址傳送到 /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 附件的網址是公開的嗎?

通常不是。如果 CRM 提供的是私人連結或會過期的連結,請在你的函式中下載檔案,並改用直接上傳流程,而不是 /documents/import。

相關指南