メインコンテンツへ移動

次に使うツールを探す

ドキュメント/自動化/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 コールアウトまたは指定ログイン情報(Named Credential)を使った Apex、Zoho CRM ではワークフロー関数内の Deluge の invokeurl を使います。添付ファイルの URL を /documents/import/ または /jobs/ に送信して jobId をレコードに保存しておき、processing.completed Webhook が届いたらレコードを更新します。

基本パターン

CRM 側の処理は小さく保ちます。CRM がファイルの参照と安定した ID を送信し、MaxScanner が処理を行い、Webhook ハンドラー(多くの場合、小さなサーバーレス関数や自動化ツール)が結果を書き戻します。API キーは CRM のシークレットストアに保存してください。HubSpot のシークレット、Salesforce の指定ログイン情報(Named Credential)、Zoho の接続や組織変数などです。

  • Idempotency-Key には CRM のレコード ID を使います(例:deal-18273-quote-pdf)
  • 後で Webhook と照合できるよう、jobId をレコードに保存します
  • output.downloadUrl をすぐにダウンロードして結果を添付します。リンクは 5 分で期限切れになります

HubSpot

ワークフローから外部 API を呼び出すには、"Send a webhook" アクションか、カスタムコードアクションを使います。これらは対応するプラン(Operations Hub(現在の Data Hub)の Professional または Enterprise)で利用できます。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 コールアウトアクションから、または以下のように Apex から API を呼び出します。コールアウトは未コミットの 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 ではなく直接アップロードのフローを使ってください。

関連ガイド