Ir para o conteúdo principal

Encontre sua próxima ferramenta

Documentação/Automação/Integrações com CRM: HubSpot, Salesforce e Zoho
Automação

Integrações com CRM: HubSpot, Salesforce e Zoho

Processe anexos do CRM com o MaxScanner a partir de fluxos de trabalho do HubSpot, Salesforce Flow ou Apex e funções Deluge do Zoho CRM.

Resposta curta

Os CRMs chamam a API do MaxScanner com seus próprios recursos HTTP: um webhook ou uma ação de código personalizado em um fluxo de trabalho do HubSpot, um HTTP Callout do Salesforce Flow ou Apex com uma Named Credential, ou invokeurl do Deluge em uma função de fluxo de trabalho do Zoho CRM. Envie a URL do anexo para /documents/import/ ou /jobs/, guarde o jobId no registro e atualize o registro quando o webhook processing.completed chegar.

O padrão

Mantenha pequena a parte do CRM. O CRM envia uma referência ao arquivo e um ID estável, o MaxScanner faz o trabalho e um handler de webhooks (muitas vezes uma pequena função serverless ou uma ferramenta de automação) grava o resultado de volta. Guarde a chave de API no cofre de segredos do CRM: secrets do HubSpot, uma Named Credential do Salesforce, conexões do Zoho ou variáveis da organização.

  • Use o ID do registro do CRM no Idempotency-Key, por exemplo deal-18273-quote-pdf
  • Salve jobId no registro para poder associar o webhook depois
  • Anexe o resultado baixando output.downloadUrl imediatamente: ele expira em cinco minutos

HubSpot

Os fluxos de trabalho podem chamar APIs externas com a ação "Send a webhook" ou com uma ação de código personalizado nos planos que as incluem (Operations Hub, agora Data Hub, Professional ou Enterprise). Uma ação de código personalizado em Node.js pode chamar /jobs/ e retornar o jobId como saída para as etapas seguintes.

// 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

Crie uma External Credential e uma Named Credential para https://maxscanner.app com um cabeçalho personalizado Authorization: Bearer <key>. Depois chame a API pelo Flow com uma ação HTTP Callout, ou pelo Apex como mostrado abaixo. Callouts não podem rodar na mesma transação que uma DML não confirmada, então dispare-os a partir de um contexto assíncrono, como Queueable Apex ou um caminho agendado.

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

Crie uma conexão ou guarde a chave em uma variável da organização e chame a API a partir de uma função Deluge associada a uma regra de fluxo de trabalho.

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");

Perguntas frequentes

Existe um app nativo do MaxScanner nos marketplaces do HubSpot, Salesforce ou Zoho?

Ainda não. Os padrões deste guia usam os recursos HTTP padrão de cada CRM, então funcionam hoje sem instalar nada.

As URLs de anexos do CRM são públicas?

Muitas vezes não. Se o CRM fornecer um link privado ou que expira, baixe o arquivo na sua função e use o fluxo de upload direto em vez de /documents/import.

Guias relacionados