CRM-Integrationen: HubSpot, Salesforce und Zoho
Verarbeiten Sie CRM-Anhänge mit MaxScanner aus HubSpot-Workflows, Salesforce Flow oder Apex und Deluge-Funktionen in Zoho CRM.
Kurze Antwort
CRMs rufen die MaxScanner-API mit ihren eigenen HTTP-Funktionen auf: einem Webhook oder einer Custom-Code-Aktion in einem HubSpot-Workflow, einem HTTP Callout in Salesforce Flow oder Apex mit einer Named Credential, oder Deluge-invokeurl in einer Workflow-Funktion von Zoho CRM. Senden Sie die URL des Anhangs an /documents/import/ oder /jobs/, speichern Sie die jobId am Datensatz und aktualisieren Sie den Datensatz, wenn der Webhook processing.completed eintrifft.
Das Muster
Halten Sie den CRM-Teil schlank. Das CRM sendet eine Dateireferenz und eine stabile ID, MaxScanner erledigt die Arbeit, und ein Webhook-Handler (oft eine kleine Serverless-Funktion oder ein Automatisierungstool) schreibt das Ergebnis zurück. Speichern Sie den API-Schlüssel im Secret Store des CRM: HubSpot-Secrets, eine Salesforce Named Credential, Zoho-Verbindungen oder Organisationsvariablen.
- Verwenden Sie die CRM-Datensatz-ID im Idempotency-Key, z. B. deal-18273-quote-pdf
- Speichern Sie die jobId am Datensatz, damit Sie den Webhook später zuordnen können
- Hängen Sie das Ergebnis an, indem Sie output.downloadUrl sofort herunterladen – der Link läuft nach fünf Minuten ab
HubSpot
Workflows können externe APIs mit der Aktion „Webhook senden“ (Send a webhook) oder einer Custom-Code-Aktion aufrufen, sofern der Tarif diese enthält (Operations Hub, inzwischen Data Hub, Professional oder Enterprise). Eine Custom-Code-Aktion in Node.js kann /jobs/ aufrufen und die jobId als Ausgabe für spätere Schritte zurückgeben.
// 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
Erstellen Sie eine External Credential und eine Named Credential für https://maxscanner.app mit einem benutzerdefinierten Header Authorization: Bearer <key>. Rufen Sie die API dann aus Flow mit der Aktion HTTP Callout oder aus Apex wie unten gezeigt auf. Callouts können nicht in derselben Transaktion wie nicht festgeschriebene DML-Operationen laufen; lösen Sie sie daher aus einem asynchronen Kontext aus, etwa Queueable Apex oder einem geplanten Pfad.
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
Erstellen Sie eine Verbindung oder speichern Sie den Schlüssel in einer Organisationsvariablen und rufen Sie die API dann aus einer Deluge-Funktion auf, die an eine Workflow-Regel gekoppelt ist.
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");Häufige Fragen
Gibt es eine native MaxScanner-App im HubSpot-, Salesforce- oder Zoho-Marketplace?
Noch nicht. Die hier beschriebenen Muster nutzen die Standard-HTTP-Funktionen des jeweiligen CRM und funktionieren daher schon heute, ohne dass Sie etwas installieren müssen.
Sind URLs von CRM-Anhängen öffentlich?
Oft nicht. Wenn das CRM einen privaten oder ablaufenden Link liefert, laden Sie die Datei in Ihrer Funktion herunter und verwenden Sie statt /documents/import den Direkt-Upload.