قالب n8n لخرائط جوجل: استورده وشغّله في عشر دقائق

هناك نسخة من هذا العمل لا تتطلب بناء أي شيء. سير العمل موجود بالفعل، ومنشور في مكتبة قوالب n8n، ويعمل بعد بيانات اعتماد اثنتين ونموذج واحد.

هذا هو الطريق السريع. وإن كنت تفضل فهم كل عقدة وبناءها بنفسك، فإن دليل سير العمل بالاستطلاع الدوري يمشي في المسار نفسه عقدة عقدة، ودليل وكيل الذكاء الاصطناعي يتناول النسخة التي يختار فيها النموذج البحث. هذه المقالة لإنزال قائمة حقيقية في جدول حقيقي اليوم.

ماذا يفعل القالب

Find local businesses without websites from Google Maps with BasedOnBusiness and Google Sheets ثماني عشرة عقدة بالشكل التالي.

نموذج             الفئة، المدينة، رمز الدولة، عدد العملاء
  |
تحقق              ارفض المدخلات الخاطئة قبل إنفاق أي رصيد
  |
ابدأ البحث        POST إلى واجهة BasedOnB
  |
افحص الحالة  ---- انتهى؟ --- لا --> انتظر 15ث --> افحص ثانية
  |
 نعم
  |
اجلب العملاء      حتى 500 صف في الصفحة
  |
Split Out         عنصر واحد لكل نشاط تجاري
  |
Filter            احتفظ بالصفوف بلا موقع فقط
  |
أعد تسمية الحقول  مع رابط مباشر إلى خرائط جوجل
  |
Google Sheets     إضافة

الجزء المفيد هو عقدة Filter. النشاط التجاري بلا موقع إلكتروني في بطاقته على خرائط جوجل هو العميل المحتمل الكلاسيكي لوكالات تصميم المواقع وتحسين محركات البحث المحلي والتسويق. وهو كذلك إشارة لا تُشترى من أي قاعدة بيانات اتصال عامة، لأنها تفسد لحظة أن يبني النشاط موقعًا.

استورده

افتح القالب على n8n.io واستخدم زر الاستيراد، فينزل اللوح كاملًا في نسختك. وإن فضّلت النقل يدويًا، انسخ ملف JSON من صفحة القالب، وافتح سير عمل فارغًا، والصقه على اللوح. كلا الطريقين يعطيك العقد الثماني عشرة نفسها ببيانات اعتماد فارغة.

لا يحتوي القالب على أي مفاتيح. هذا مقصود، ويستحق التحقق منه في كل ما تستورده من مكتبة عامة.

بيانات اعتماد اثنتان

BasedOnB. في n8n أنشئ بيانات اعتماد من نوع Header Auth ترسل Authorization بقيمة Bearer متبوعة بمفتاح API الخاص بك. أنشئ المفتاح من لوحة التحكم تحت قسم API والويب هوك، وامنحه نطاقي القراءة والكتابة للبحث فقط. اختر بيانات الاعتماد تلك في عقد HTTP Request الثلاث جميعها.

Google Sheets. اربط حساب جوجل عبر تدفق OAuth المعتاد في n8n، ثم افتح عقدة Save Leads واختر جدول بيانات وورقة. تستخدم العقدة المطابقة التلقائية للأعمدة، لذا أنشئ الورقة بصف عناوين يطابق أسماء الأعمدة في الجدول أدناه، أو دع التشغيل الأول يكتب في ورقة فارغة ثم صحّح العناوين بعد ذلك.

لا شيء آخر يحتاج ضبطًا.

شغّله

افتح رابط النموذج من عقدة Form. أربعة حقول:

الحقل	مثال	ملاحظة
Business category	dentist	فئة واحدة في كل تشغيل
City	Manchester	اسم بسيط، بالكتابة التي تعتمدها خرائط جوجل
Country code	GB	رمز ISO من حرفين، لا اسم الدولة
Number of leads	25	بين 1 و 500. هذا ما تدفعه.

ترفض عقدة التحقق رمز دولة من ثلاثة أحرف، وفئة فارغة، وعدد عملاء خارج النطاق، وتفعل ذلك قبل بدء البحث، فلا يكلفك الخطأ المطبعي شيئًا.

يستغرق التشغيل ما يستغرقه البحث. وتفحص عقدة Wait كل 15 ثانية بدل إبقاء اتصال مفتوحًا.

ماذا ينزل في الجدول

العمود	المصدر
Business Name	عنوان البطاقة في الخرائط
Phone	رقم الهاتف المدرج
Address	العنوان المدرج
Category	تسمية الفئة في الخرائط
Rating	متوسط التقييم بالنجوم
Reviews	عدد المراجعات
Google Maps URL	يُبنى من معرّف البطاقة ويفتح النشاط نفسه بالضبط
City	منقول من النموذج
Country	منقول من النموذج

لا يوجد عمود للبريد الإلكتروني، وهذا ليس سهوًا. بطاقات خرائط جوجل لا تحتوي حقل بريد، فالبريد لا يأتي إلا من موقع النشاط التجاري. وهؤلاء تحديدًا هم من لا موقع لهم. قناة التواصل هنا هي الهاتف، ولهذا يتلاءم دليل البيع عبر الهاتف مع هذه القائمة أفضل من تلاؤم حملة بريد بارد معها.

أول ثلاثة أشياء تغيّرها

تسمية الفئة. هي الأهم في النموذج كله. في عيّنتنا الخاصة من البطاقات المحلية، تتفاوت نسبة الأنشطة بلا موقع بأكثر من ثمانية أضعاف داخل القطاع الواحد بحسب التسمية التي تبحث بها: مطعم عائلي عند 65.7 بالمئة بلا موقع، ومطعم إيطالي عند 7.9 بالمئة. ابحث بالتسمية البسيطة العامة لا بالتسمية الراقية. دليل الأنشطة بلا موقع يضم جدول الفئات كاملًا.

عدد العملاء. ابدأ من 25 وأنت تتفقد تنسيق الجدول، لا من 500.

الوجهة. عقدة Google Sheets هي أسهل قطعة للاستبدال. احذفها، واربط عقدة Code الأخيرة بـ HubSpot أو Airtable أو عقدة HTTP Request، ويبقى باقي سير العمل كما هو.

قبل التوسع

يُخصم الرصيد عند بدء البحث وبناءً على الرقم الذي كتبته، لا على عدد الصفوف التي تنجو من المرشح. التشغيل الذي يطلب 100 عميل يكلف 100 رصيد حتى لو تبيّن أن 14 منهم فقط بلا موقع. وإلغاء مهمة جارية لا يعيد الرصيد كذلك.

هذه الحقيقة وحدها تحدد كيف ينبغي أن تختبر. شغّل 25، وانظر ماذا عاد، وعدّل الفئة، ثم شغّل دفعة حقيقية. وثمة سقفان آخران يستحقان المعرفة قبل جدولة أي شيء: يمكن للحساب أن يبقي بحثين مفتوحين في وقت واحد، ومجموع أهداف عمليات البحث المفتوحة لا يتجاوز 5000 عميل.

خصوصية تستحق المعرفة

إذا كنت تجمع عملاء في سوق تستخدم أسماء أنشطته حروفًا خارج ASCII، كالتركية أو اليونانية أو السيريلية، فقد تصل بعض الأسماء إلى الجدول بحروف خاطئة. ترسل الواجهة البرمجية الرد بترميز UTF-8 وتعنونه بأنه UTF-8، وتتجاهل عقدة HTTP Request في n8n هذا العنوان وتفك الترميز بصفحة رموز قديمة. هذه مشكلة فك ترميز في n8n لا مشكلة في البيانات، ويمكنك التأكد بجلب المهمة نفسها عبر التصدير من لوحة التحكم أو بأي عميل HTTP آخر، حيث تظهر الأسماء صحيحة.

الأسواق ذات الأبجدية اللاتينية غير متأثرة، فلا يظهر هذا أبدًا في تشغيل بريطاني أو أمريكي. وإن ظهر عندك، فصدّر تلك الدفعة من لوحة التحكم إلى أن تحترم العقدة العنوان.

متى تتوقف عن استخدام القالب

القالب عمدًا بحث واحد ومرشح واحد ووجهة واحدة. وحين تتجاوز ذلك ستحتاج سير عمل خاصًا بك:

• أكثر من مدينة في التشغيل الواحد، وهذا يحتاج حلقة وضبط تكرار على معرّف البطاقة.
• الكتابة في نظام إدارة علاقات عملاء يجب ألا تتكرر فيه الشركات، وهذا يحتاج upsert لا مجرد إضافة.
• تشغيلات مجدولة، وهذه تحتاج فروع أخطاء وتنبيهًا حين تعود مهمة ملغاة.
• أكثر من 500 نتيجة، وهذا يحتاج ترقيم صفحات بالمؤشر.

الأربعة جميعًا مشروحة في دليل سير العمل بالاستطلاع الدوري. القالب أقصر طريق إلى قائمة أولى، وليس السقف.

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

أين أجد قالب n8n؟

هو منشور في مكتبة قوالب n8n بعنوان Find local businesses without websites from Google Maps with BasedOnBusiness and Google Sheets. افتحه على n8n.io واستخدم زر الاستيراد، أو انسخ ملف JSON والصقه على لوحة فارغة في نسختك الخاصة.

هل أحتاج إلى كتابة أي شيفرة لاستخدامه؟

لا. يأتي القالب بعقد Code مكتوبة بالفعل. أنت تضيف بيانات اعتماد اثنتين، وتختار جدول بيانات، وتملأ نموذجًا. عقد Code تتحقق فقط من مدخلات النموذج وتعيد تسمية الحقول قبل وصول الصفوف إلى الجدول.

هل يعمل القالب على نسخة n8n مستضافة ذاتيًا؟

نعم. يستخدم عقدًا أساسية إضافة إلى عقدة Google Sheets، لذا تتصرف n8n Cloud والنسخة المستضافة ذاتيًا بالطريقة نفسها. تحتاج النسخة المستضافة ذاتيًا إلى وصول HTTPS صادر نحو الواجهة البرمجية.

كم رصيدًا يكلف التشغيل الواحد؟

بالضبط عدد العملاء الذي تكتبه في النموذج، ويُخصم عند بدء البحث. طلب 25 عميلًا يكلف 25 رصيدًا حتى لو ترك مرشح الموقع الإلكتروني 9 صفوف فقط. اختبر بأرقام صغيرة أولًا.

لماذا يحتوي الجدول على صفوف أقل مما طلبت؟

يحتفظ القالب فقط بالأنشطة التي لا تذكر موقعًا إلكترونيًا في بطاقتها على خرائط جوجل. وكل نشاط لديه موقع يُستبعد قبل الجدول. الفارق بين الرقمين هو نسبة انتشار المواقع في تلك الفئة وتلك المدينة، وهي تتفاوت كثيرًا بحسب الفئة.

هل يمكنني إرسال العملاء إلى نظام إدارة علاقات العملاء بدل Google Sheets؟

نعم. احذف عقدة Google Sheets واربط عقدة Code الأخيرة بـ HubSpot أو Pipedrive أو Airtable أو عقدة HTTP Request. كل ما قبلها يبقى كما هو. استخدم مفتاحًا ثابتًا لضبط التكرار إذا كان سير العمل سيُشغَّل أكثر من مرة.

هل أستطيع تغيير المرشح إلى شيء غير غياب الموقع؟

نعم. تقرأ عقدة Filter حقلًا واحدًا في كل نتيجة. وجّهها إلى rating أو reviews_count أو category بدلًا من ذلك، أو أزلها للاحتفاظ بكل الصفوف. تحمل النتائج أيضًا الهاتف والعنوان وحسابات التواصل والتقنية المكتشفة على الموقع.

شغّل بحثًا صغيرًا

استورد القالب، وأضف بيانات الاعتماد الاثنتين، وابحث عن فئة تعرفها جيدًا في مدينة تعرفها جيدًا. ستدرك فورًا ما إذا كانت القائمة جيدة، وهذه أسرع طريقة لضبط تسمية الفئة قبل إنفاق حجم حقيقي.

الحساب الجديد في BasedOnB يأتي بـ 50 رصيد تصدير لمرة واحدة وبلا بطاقة، وهو ما يغطي تشغيلين تجريبيين صغيرين للقالب مع فائض.