Zoho SalesIQ n8n integration

ساعدني في بناء سير عملي
1

Hi,
I’m building a lead profiling workflow for a client:
Pull leads from Zoho CRM
Enrich each lead with their website behaviour from Zoho SalesIQ
Build a complete lead profile per contact
The missing piece is a Zoho SalesIQ integration. What’s the best way to connect to the SalesIQ API (EU datacenter) within n8n — is there a community node, or is an HTTP Request node with custom OAuth2 the recommended approach? And if HTTP Request is the way to go, how would you set that up correctly?

4

hi @LNH good morning!
nowadays there’s no node for zoho, the best approach is to go with the http request node with a custom oauth api credential. one thing to note, zoho lists https://accounts.zoho.eu as the OAuth server for Europe.

إعجاب واحد (1)
5

Hi LNH. I can help with the Zoho SalesIQ side as a bounded paid integration slice.

For this I would not start by guessing a whole architecture. I would first verify the EU OAuth/API path, build one SalesIQ → lead profile enrichment route in n8n, map the result back to the target Zoho CRM fields, and add error logging plus short handoff notes.

That first slice would be $450-$650 depending on how much of the SalesIQ API response and CRM mapping is already known. I would use redacted sample contacts/screenshots first, then only touch live credentials after the exact flow is agreed.

One question: do you already have the SalesIQ API endpoint / sample response for website behaviour, or is the first step to discover the correct endpoint and OAuth scopes?

6

نعم، لا توجد عقدة لـ SalesIQ — استخدام HTTP Request مع بيانات اعتماد OAuth2 عامة هو الحل الأمثل. هناك شيئان يربكان الناس على مركز البيانات الأوروبي:
مضيف المصادقة ومضيف API مختلفان: نقطة الرمز (token endpoint) هي accounts.zoho.eu، لكن استدعاءات SalesIQ الفعلية تذهب إلى نطاق .eu، وليس .com. خلط الاثنين هو السبب المعتاد للأخطاء الصامتة 401.
نطاقات الأذونات حساسة لحالة الأحرف وخاصة بالمنتج. احصل على سلسلة نطاق SalesIQ الدقيقة من وحدة تحكم Zoho API بدلاً من التخمين — نطاق CRM واسع جداً لن يغطي بيانات زوار SalesIQ.
بمجرد تحديث الرمز بنجاح، الباقي هو مجرد طلب GET ضد نقاط نهاية تتبع الزوار. اختبر الاستدعاء الخام في Postman أولاً حتى تعرف أنها مشكلة بيانات اعتماد n8n وليست المنطقة.

7

مرحباً @LNH،

بما أنه لا توجد عقدة محلية مخصصة لـ SalesIQ، فإن استخدام عقدة HTTP Request مع بيانات اعتماد OAuth2 مخصصة هو الأسلوب القياسي. إليك التفصيل التقني للحصول على تكامل مركز البيانات الأوروبي الخاص بك في العمل:

1. إعداد بيانات اعتماد OAuth2

أنشئ بيانات اعتماد API OAuth2 جديدة في n8n. نقاط نهاية المصادقة الأوروبية في Zoho محددة، لذا قم بتكوينها كما يلي:

  • عنوان URL للترخيص: https://accounts.zoho.eu/oauth/v2/auth

  • عنوان URL لرمز الوصول: https://accounts.zoho.eu/oauth/v2/token

  • النطاق: ستحتاج إلى نطاقات محددة لـ SalesIQ (على سبيل المثال، ZohoSalesIQ.visitors.READ، ZohoSalesIQ.reports.READ). تحقق من وحدة تحكم Zoho API للتأكد من أنك اخترت الخيارات الصحيحة.

2. استراتيجية نقطة نهاية API

لبيانات الزوار/السلوك، أنت لا تضرب مجرد نقطة نهاية واحدة.

  • عنوان URL الأساسي: تأكد من استهدافك لقاعدة API الخاصة بالاتحاد الأوروبي: https://salesiq.zoho.eu/api/v2/

  • التعيين: نظراً لأنك تقوم ببناء ملف تعريف العميل المتوقع، فأعط الأولوية لنقاط نهاية /visitors أو /chats. استخدم zoho_crm_lead_id (إذا تم تمريره كمعامل مخصص في نص تتبع زوار SalesIQ) لإجراء الربط في مسار عملك.

3. تدفق التنفيذ

  1. محفز Zoho CRM: اسحب قائمة العملاء المحتملين الخاصة بك.

  2. طلب HTTP (GET): استعلم عن SalesIQ باستخدام معرّف العميل المحتمل.

  3. تعيين/تحرير الحقول: نظراً لأن استجابات SalesIQ غالباً ما تكون بصيغة JSON متداخلة، استخدم عقدة Set أو Edit Fields لتسطيح بيانات السلوك في بنية زوج مفتاح-قيمة تطابق كائن العميل المحتمل في CRM الخاص بك.

  4. Zoho CRM (PATCH/UPDATE): ادفع الملف الشخصي المثري إلى CRM.

قبل بناء مسار العمل الكامل، استخدم مجموعة Postman أو أمر curl بسيط للوصول إلى نقطة النهاية /visitors والتحقق من أن رمز OAuth2 الخاص بك يعيد الحمولة المتوقعة. إذا حصلت على خطأ 403، فتحقق مرة أخرى من أذونات النطاق في وحدة تحكم Zoho API؛ إنه دائماً ما يكون عدم تطابق بين النطاق المطلوب والرمز الذي تم إنشاؤه.