Integrazioni CRM: HubSpot, Salesforce e Zoho
Elabora gli allegati del CRM con MaxScanner dai workflow di HubSpot, da Salesforce Flow o Apex e dalle funzioni Deluge di Zoho CRM.
Risposta breve
I CRM chiamano l'API di MaxScanner con le proprie funzionalità HTTP: un webhook o un'azione di codice personalizzato in un workflow HubSpot, un HTTP Callout di Salesforce Flow o Apex con una Named Credential, oppure invokeurl di Deluge in una funzione di workflow di Zoho CRM. Invia l'URL dell'allegato a /documents/import/ o /jobs/, salva il jobId sul record e aggiorna il record quando arriva il webhook processing.completed.
Lo schema
Mantieni leggera la parte CRM. Il CRM invia un riferimento al file e un ID stabile, MaxScanner esegue il lavoro e un gestore webhook (spesso una piccola funzione serverless o uno strumento di automazione) riscrive il risultato nel CRM. Conserva la chiave API nell'archivio dei segreti del CRM: i secrets di HubSpot, una Named Credential di Salesforce, le connessioni o le variabili dell'organizzazione di Zoho.
- Usa l'ID del record CRM nell'Idempotency-Key, ad es. deal-18273-quote-pdf
- Salva il jobId sul record per poter abbinare il webhook in seguito
- Allega il risultato scaricando subito output.downloadUrl: scade dopo cinque minuti
HubSpot
I workflow possono chiamare API esterne con l'azione "Send a webhook" o con un'azione di codice personalizzato, nei piani che le includono (Operations Hub, ora Data Hub, Professional o Enterprise). Un'azione di codice personalizzato in Node.js può chiamare /jobs/ e restituire il jobId come output per i passaggi successivi.
// 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
Crea una External Credential e una Named Credential per https://maxscanner.app con un header personalizzato Authorization: Bearer <key>. Poi chiama l'API da Flow con un'azione HTTP Callout, oppure da Apex come nell'esempio qui sotto. I callout non possono essere eseguiti nella stessa transazione di operazioni DML non ancora confermate, quindi avviali da un contesto asincrono come Queueable Apex o un percorso pianificato.
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
Crea una connessione o salva la chiave in una variabile dell'organizzazione, poi chiama l'API da una funzione Deluge associata a una regola di workflow.
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");Domande frequenti
Esiste un'app MaxScanner nativa nei marketplace di HubSpot, Salesforce o Zoho?
Non ancora. Gli schemi descritti qui usano le funzionalità HTTP standard di ciascun CRM, quindi funzionano già oggi senza installare nulla.
Gli URL degli allegati del CRM sono pubblici?
Spesso no. Se il CRM fornisce un link privato o con scadenza, scarica il file nella tua funzione e usa il flusso di caricamento diretto invece di /documents/import.