Aller au contenu principal

Trouvez votre prochain outil

Documentation/Automatisation/Intégrations CRM : HubSpot, Salesforce et Zoho
Automatisation

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.

Guides associés