تخطي إلى المحتوى الرئيسي

اعثر على أداتك التالية

الوثائق/الأتمتة/تكاملات CRM: HubSpot وSalesforce وZoho
الأتمتة

تكاملات CRM: HubSpot وSalesforce وZoho

عالج مرفقات CRM باستخدام MaxScanner من مسارات العمل في HubSpot، أو Salesforce Flow أو Apex، أو دوال Deluge في Zoho CRM.

إجابة مختصرة

تستدعي أنظمة CRM واجهة MaxScanner API بميزات HTTP المدمجة فيها: خطاف ويب أو إجراء شيفرة مخصصة في مسار عمل HubSpot، أو HTTP Callout في Salesforce Flow أو Apex مع Named Credential، أو invokeurl في Deluge داخل دالة مسار عمل في Zoho CRM. أرسل رابط المرفق إلى /documents/import/ أو /jobs/، واحتفظ بقيمة jobId في السجل، ثم حدّث السجل عند وصول خطاف الويب processing.completed.

النمط

اجعل الجزء الخاص بنظام CRM صغيرًا. يرسل CRM مرجعًا للملف ومعرّفًا ثابتًا، ويتولى MaxScanner العمل، ثم يكتب معالج خطاف الويب (غالبًا دالة صغيرة بدون خادم أو أداة أتمتة) النتيجة في CRM. خزّن مفتاح API في مخزن الأسرار الخاص بنظام CRM: أسرار HubSpot، أو Named Credential في Salesforce، أو الاتصالات أو متغيرات المؤسسة في Zoho.

  • استخدم معرّف سجل CRM في Idempotency-Key، مثل deal-18273-quote-pdf
  • احفظ jobId في السجل لتتمكن من مطابقة خطاف الويب لاحقًا
  • أرفق النتيجة بتنزيل output.downloadUrl فورًا، فصلاحيته تنتهي بعد خمس دقائق

HubSpot

يمكن لمسارات العمل استدعاء واجهات API خارجية بالإجراء "Send a webhook" أو بإجراء شيفرة مخصصة في الخطط التي تتضمنهما (Operations Hub، الذي أصبح الآن Data Hub، بإصدار Professional أو Enterprise). ويمكن لإجراء شيفرة مخصصة مكتوب بـ Node.js استدعاء /jobs/ وإرجاع jobId كمخرج تستخدمه الخطوات اللاحقة.

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

أنشئ External Credential وNamed Credential للعنوان https://maxscanner.app مع ترويسة مخصصة Authorization: Bearer <key>. ثم استدعِ API من Flow بإجراء HTTP Callout، أو من Apex كما في المثال أدناه. لا يمكن تشغيل الاستدعاءات الخارجية (callouts) في المعاملة نفسها مع عمليات DML غير المُثبَّتة، لذا شغّلها من سياق غير متزامن مثل Queueable Apex أو مسار مجدول.

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

أنشئ اتصالًا (connection) أو خزّن المفتاح في متغير على مستوى المؤسسة، ثم استدعِ API من دالة Deluge مرتبطة بقاعدة مسار عمل.

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

الأسئلة الشائعة

هل يوجد تطبيق MaxScanner أصلي في متاجر تطبيقات HubSpot أو Salesforce أو Zoho؟

ليس بعد. تستخدم الأنماط الموضحة هنا ميزات HTTP القياسية في كل نظام CRM، لذا تعمل اليوم دون تثبيت أي شيء.

هل روابط مرفقات CRM عامة؟

غالبًا لا. إذا قدّم نظام CRM رابطًا خاصًا أو مؤقت الصلاحية، فنزّل الملف داخل دالتك واستخدم مسار الرفع المباشر بدلًا من /documents/import.

أدلة ذات صلة