Integraciones con CRM: HubSpot, Salesforce y Zoho
Procesa adjuntos del CRM con MaxScanner desde flujos de trabajo de HubSpot, Salesforce Flow o Apex, y funciones Deluge de Zoho CRM.
Respuesta breve
Los CRM llaman a la API de MaxScanner con sus propias funciones HTTP: un webhook o una acción de código personalizado en un flujo de trabajo de HubSpot, un HTTP Callout de Salesforce Flow o Apex con una Named Credential, o invokeurl de Deluge en una función de flujo de trabajo de Zoho CRM. Envía la URL del adjunto a /documents/import/ o /jobs/, guarda el jobId en el registro y actualiza el registro cuando llegue el webhook processing.completed.
El patrón
Mantén pequeña la parte del CRM. El CRM envía una referencia al archivo y un ID estable, MaxScanner hace el trabajo y un controlador de webhooks (a menudo una pequeña función serverless o una herramienta de automatización) escribe el resultado de vuelta. Guarda la clave de API en el almacén de secretos del CRM: secretos de HubSpot, una Named Credential de Salesforce, conexiones de Zoho o variables de organización.
- Usa el ID del registro del CRM en el Idempotency-Key; p. ej., deal-18273-quote-pdf
- Guarda jobId en el registro para poder asociarle el webhook más tarde
- Adjunta el resultado descargando output.downloadUrl de inmediato: caduca en cinco minutos
HubSpot
Los flujos de trabajo pueden llamar a API externas con la acción "Send a webhook" o con una acción de código personalizado en los planes que las incluyen (Operations Hub, ahora Data Hub, Professional o Enterprise). Una acción de código personalizado en Node.js puede llamar a /jobs/ y devolver el jobId como salida para los pasos posteriores.
// 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 y una Named Credential para https://maxscanner.app con un encabezado personalizado Authorization: Bearer <key>. Después llama a la API desde Flow con una acción HTTP Callout, o desde Apex como se muestra a continuación. Los callouts no pueden ejecutarse en la misma transacción que un DML sin confirmar, así que lánzalos desde un contexto asíncrono, como Queueable Apex o una ruta programada.
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 conexión o guarda la clave en una variable de organización y llama a la API desde una función Deluge asociada a una regla de flujo de trabajo.
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");Preguntas frecuentes
¿Hay una app nativa de MaxScanner en los marketplaces de HubSpot, Salesforce o Zoho?
Todavía no. Los patrones de esta guía usan las funciones HTTP estándar de cada CRM, así que funcionan hoy sin instalar nada.
¿Las URL de los adjuntos del CRM son públicas?
A menudo no. Si el CRM da un enlace privado o que caduca, descarga el archivo en tu función y usa el flujo de subida directa en lugar de /documents/import.