CRM 연동: HubSpot, Salesforce, Zoho
HubSpot 워크플로, Salesforce Flow 또는 Apex, Zoho CRM Deluge 함수에서 MaxScanner로 CRM 첨부 파일을 처리합니다.
핵심 답변
CRM은 자체 HTTP 기능으로 MaxScanner API를 호출합니다. HubSpot은 워크플로 웹훅 또는 사용자 지정 코드 작업, Salesforce는 Flow HTTP 콜아웃 또는 명명된 자격 증명(Named Credential)을 사용하는 Apex, Zoho CRM은 워크플로 함수의 Deluge invokeurl을 사용합니다. 첨부 파일의 URL을 /documents/import/ 또는 /jobs/ 로 보내고, jobId를 레코드에 보관했다가 processing.completed 웹훅이 도착하면 레코드를 업데이트합니다.
기본 패턴
CRM 쪽은 작게 유지합니다. CRM은 파일 참조와 안정적인 ID를 보내고, MaxScanner가 처리를 수행하며, 웹훅 핸들러(대개 작은 서버리스 함수나 자동화 도구)가 결과를 다시 기록합니다. API 키는 CRM의 시크릿 저장소에 보관하십시오. HubSpot 시크릿, Salesforce 명명된 자격 증명(Named Credential), Zoho 연결 또는 조직 변수가 이에 해당합니다.
- Idempotency-Key에 CRM 레코드 ID를 사용합니다(예: deal-18273-quote-pdf)
- 나중에 웹훅과 대조할 수 있도록 jobId를 레코드에 저장합니다
- output.downloadUrl을 즉시 다운로드해 결과를 첨부합니다. 링크는 5분 후 만료됩니다
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 콜아웃 작업이나 아래와 같이 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 대신 직접 업로드 흐름을 사용하십시오.