Intégrations CRM : HubSpot, Salesforce et Zoho
Traitez les pièces jointes de votre CRM avec MaxScanner depuis les workflows HubSpot, Salesforce Flow ou Apex, et les fonctions Deluge de Zoho CRM.
Réponse courte
Les CRM appellent l’API MaxScanner avec leurs propres fonctionnalités HTTP : un webhook ou une action de code personnalisé dans un workflow HubSpot, un HTTP Callout dans Salesforce Flow ou du code Apex avec une Named Credential, ou invokeurl en Deluge dans une fonction de workflow Zoho CRM. Envoyez l’URL de la pièce jointe à /documents/import/ ou /jobs/, conservez le jobId dans l’enregistrement et mettez celui-ci à jour à l’arrivée du webhook processing.completed.
Le principe
Limitez au minimum la partie CRM. Le CRM envoie une référence de fichier et un ID stable, MaxScanner effectue le traitement, et un gestionnaire de webhook (souvent une petite fonction serverless ou un outil d’automatisation) réécrit le résultat dans le CRM. Stockez la clé API dans le coffre de secrets du CRM : secrets HubSpot, Named Credential Salesforce, connexions ou variables d’organisation Zoho.
- Utilisez l’ID d’enregistrement du CRM dans l’en-tête Idempotency-Key, par exemple deal-18273-quote-pdf
- Stockez le jobId dans l’enregistrement afin de pouvoir y rattacher le webhook plus tard
- Joignez le résultat en téléchargeant output.downloadUrl immédiatement — le lien expire au bout de cinq minutes
HubSpot
Les workflows peuvent appeler des API externes avec l’action « Envoyer un webhook » (Send a webhook) ou une action de code personnalisé, sur les abonnements qui les incluent (Operations Hub, désormais Data Hub, Professional ou Enterprise). Une action de code personnalisé en Node.js peut appeler /jobs/ et renvoyer le jobId comme sortie pour les étapes suivantes.
// 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
Créez une External Credential et une Named Credential pour https://maxscanner.app avec un en-tête personnalisé Authorization: Bearer <key>. Appelez ensuite l’API depuis Flow avec une action HTTP Callout, ou depuis Apex comme ci-dessous. Les callouts ne peuvent pas s’exécuter dans la même transaction qu’un DML non validé : déclenchez-les donc depuis un contexte asynchrone, par exemple Queueable Apex ou un chemin planifié.
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
Créez une connexion ou stockez la clé dans une variable d’organisation, puis appelez l’API depuis une fonction Deluge associée à une règle de 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");Questions fréquentes
Existe-t-il une application MaxScanner native sur les marketplaces HubSpot, Salesforce ou Zoho ?
Pas encore. Les modèles présentés ici utilisent les fonctionnalités HTTP standard de chaque CRM : ils fonctionnent dès aujourd’hui, sans rien installer.
Les URL des pièces jointes du CRM sont-elles publiques ?
Souvent non. Si le CRM fournit un lien privé ou à durée limitée, téléchargez le fichier dans votre fonction et utilisez le flux d’envoi direct au lieu de /documents/import.