دليل إعداد التكامل

واتساب مع HubSpot Service Hub: حوّل المحادثات إلى تذاكر HubSpot

دليل إعداد وسير عمل n8n جاهز للاستيرادآخر تحقق: أكتوبر 2026

هناك طريقتان لتشغيل واتساب مع HubSpot Service Hub. يوفّر HubSpot قناة واتساب خاصة به في صندوق الوارد لديه عبر واتساب Business API، وهذا يعني رقمًا مسجّلًا على API، ورسائل قالب معتمدة للرسائل خارج نافذة الـ 24 ساعة، ورسومًا على كل رسالة. أما الطريقة الأخرى فتُبقي واتساب على الرقم الذي يستخدمه عملاؤك أصلًا، مع Spun بوصفه مساحة عمل واتساب، وتُنشئ تذاكر HubSpot عبر سير عمل في n8n الخاص بك.

تتناول هذه الصفحة الطريقة الثانية، لإنشاء تذاكر HubSpot من واتساب: تصبح كل محادثة فردية تذكرة في مسار التذاكر (pipeline) الذي تختاره، وتُسجَّل كل رسالة على التذكرة وعلى المخطط الزمني لجهة الاتصال، ويرد الموظفون على واتساب من التذكرة. ويعمل ذلك إلى جانب مزامنة جهات الاتصال مع HubSpot CRM في Spun، التي تُبقي جهات الاتصال متطابقة ولا تُنشئ تذاكر.

تذاكر HubSpot من واتساب: ما الذي يفعله سير العمل

  • تصبح كل محادثة واتساب فردية تذكرة في HubSpot ضمن مسار التذاكر والمرحلة اللذين يختارهما المسؤول لديك. وتُتخطّى محادثات المجموعات.
  • تُسجَّل كل رسالة على التذكرة كتواصل (communication) من نوع واتساب، وتظهر أيضًا على المخطط الزمني لجهة الاتصال، مع ذكر اسم المتحدث في النص.
  • تُسجَّل الردود التي يرسلها فريقك من صندوق الوارد في Spun على التذكرة أيضًا، فيمكن الرد من الجانبين.
  • تنقل الأرشفة في Spun التذكرة إلى المرحلة المغلقة، وإلغاء الأرشفة يعيدها إلى المرحلة المفتوحة. ويمكن أن يؤدي الإغلاق في HubSpot إلى أرشفة المحادثة في Spun أيضًا، وهو خيار يبقى معطّلًا حتى تفعّله.
كيف تُسجَّل الرسائل على التذكرة (للتوضيح)
[WhatsApp] Maria Lopez (+15550142233): Hi, my order has not arrived yet
[Sent from Spun] Alex: Sorry about that, checking now.
[Sent from HubSpot] It ships today, here is the tracking link.

الرد من التذكرة عبر حقل «Spun reply»

يرد الموظفون بكتابة الرد في خاصية «Spun reply» على التذكرة ثم الحفظ. وخلال ثوانٍ قليلة يصل النص إلى العميل على واتساب، ويُسجَّل على التذكرة، ويصبح الحقل فارغًا من جديد. وإذا تعذّر إرسال رد، تشرح ملاحظة على التذكرة السبب.

الردود نصية فقط؛ ولا تُمرَّر مرفقات التذكرة. وتبقى ملاحظات HubSpot ورسائل البريد الإلكتروني داخلية. كل ما يُكتب في «Spun reply» يُرسَل أيًا كان كاتبه، لذا أبقِ هذه الخاصية خارج التعديلات الجماعية وعمليات الاستيراد وسير العمل في HubSpot.

العمل إلى جانب مزامنة جهات الاتصال مع HubSpot CRM

تتولى مزامنة جهات الاتصال مع HubSpot CRM في Spun جهاتِ الاتصال، ويتولى سير العمل هذا التذاكر. يستخدم سير العمل مفتاح HubSpot خاصًا به ولا يعدّل أي جهة اتصال أبدًا. ومع ربط مزامنة جهات الاتصال، لا يُنشئ جهة اتصال أيضًا: تُربط تذكرة العميل الجديد كليًا بعد أن ترسل المزامنة جهة الاتصال، وهذا يحدث عند «مزامنة الآن» أو عند تسمية مُعيَّنة في المزامنة، لا مع كل رسالة.

ذات صلة: واتساب + HubSpot CRM: مزامنة جهات الاتصال

الإعداد خطوة بخطوة

تحتاج إلى HubSpot Service Hub، ومستخدم يمكنه إنشاء الخصائص والمفاتيح واشتراكات Webhook، ونسخة n8n يمكن لـ HubSpot وSpun الوصول إليها عبر HTTPS، وتطبيق يحمل Webhook الرد: إما تطبيق خاص قديم (legacy private app)، أنشئه قبل 26 أكتوبر 2026، حين يتوقف HubSpot عن إتاحة إنشاء تطبيقات جديدة منه للحسابات الحالية، وإما تطبيق قائم على المشاريع (project-based app)، يُبنى باستخدام HubSpot CLI ويحتاج إلى مطوّر.

  1. 1

    أنشئ خاصيتين للتذاكر

    «Spun chat id» (نص من سطر واحد) و«Spun reply» (نص متعدد الأسطر). وأضف «Spun reply» إلى الشريط الجانبي للتذكرة حتى يراها الموظفون.

  2. 2

    أنشئ مفتاحًا لاستدعاءات API

    مفتاح خدمة (service key) أو رمز الوصول (access token) الخاص بتطبيقك الخاص القديم، مع صلاحيات التذاكر وجهات الاتصال المذكورة في دليل الإعداد، ويُحفظ في n8n كبيانات اعتماد من نوع «Header Auth».

  3. 3

    استورد سير العمل

    شغّل أداة الإعداد المساعدة فيه مرة واحدة لعرض مسارات التذاكر ومراحلها لديك، وانسخ المعرّفات إلى عقدة «Settings».

  4. 4

    أخبره بمزامنة جهات الاتصال

    أبقِ إعداد مزامنة جهات الاتصال مفعّلًا إذا كانت مزامنة جهات الاتصال مع HubSpot في Spun مربوطة، أو إذا لم تكن متأكدًا.

  5. 5

    اجعل التطبيق يشترك في تغييرات التذاكر

    وجّه Webhook التطبيق إلى رابط الرد الخاص بسير العمل مع اشتراك على خاصية «Spun reply»، والصق سر العميل (client secret) الخاص بالتطبيق في سير العمل.

  6. 6

    أنشئ مفتاح API في Spun

    «الإعدادات»، ثم «الويب هوكس»، ثم «إدارة مفاتيح API»، مع صلاحية «Send Messages». وحدّد أيضًا «إغلاق وإعادة فتح المحادثات» إذا كان الإغلاق في HubSpot يجب أن يؤرشف المحادثة في Spun.

  7. 7

    وجّه أحداث Spun إلى سير العمل

    أضف Webhook لأحداث «رسالة واردة» و«رسالة صادرة» و«تم إغلاق المحادثة» و«تم إعادة فتح المحادثة»، مع ضبط «تنسيق الحمولة» على «خام (افتراضي)»، ثم الصق سر التوقيع الخاص به في سير العمل.

  8. 8

    أرسل رسالة تجريبية

    راسل الرقم من هاتف آخر. ستظهر تذكرة في HubSpot؛ اكتب ردًا في «Spun reply» واحفظ، وسيصل الرد إلى الهاتف.

ذات صلة: الوثائق: HubSpot Service Hub عبر n8n، دليل الإعداد الكامل · واتساب + n8n: واجهة API والـ Webhooks التي يقوم عليها

ما يجب معرفته قبل البناء

  • طلبات Webhook التي يرسلها HubSpot موقّعة، ويتحقق سير العمل من التوقيع. أما أحداث Spun نفسها فموقّعة بـ HMAC.
  • تصل الوسائط إلى التذكرة كرابط صالح لمدة 24 ساعة، لا كملف في HubSpot.
  • تنطبق حدود API في HubSpot على كل مفتاح (100 أو 190 طلبًا كل 10 ثوانٍ، إضافة إلى حد يومي لكل حساب). تستهلك المحادثة الجديدة أربعة أو خمسة استدعاءات، والرسالة اللاحقة استدعاءين.
  • يستهلك كل حدث يتم تسليمه رموز ذكاء اصطناعي من خطتك في Spun. ولا تزال طريقة احتساب ذلك لاستخدام مكتب المساعدة قيد المراجعة.

ذات صلة: كل تكاملات واتساب مع مكاتب المساعدة · واتساب كمكتب مساعدة بحد ذاته

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

هل يمكن لـ HubSpot Service Hub إنشاء تذاكر من واتساب؟

نعم. مع Spun وسير عمل n8n، تصبح كل محادثة واتساب فردية تذكرة في مسار التذاكر والمرحلة اللذين تختارهما، وتُسجَّل كل رسالة على التذكرة وعلى المخطط الزمني لجهة الاتصال.

كيف يرد الموظفون على واتساب من تذكرة HubSpot؟

يكتبون الرد في خاصية «Spun reply» على التذكرة ثم يحفظون. يُرسَل النص إلى العميل على واتساب من رقمك الخاص، ويُسجَّل على التذكرة، ويُفرَّغ الحقل.

ما الفرق بين هذا ومزامنة جهات الاتصال مع HubSpot CRM؟

تُبقي مزامنة جهات الاتصال جهاتِ الاتصال متطابقة بين Spun وHubSpot ولا تُنشئ تذاكر. أما سير العمل هذا فيُنشئ التذاكر ويحدّثها ولا يعدّل أي جهة اتصال أبدًا. ويعمل الاثنان جنبًا إلى جنب.

ماذا أحتاج في جانب HubSpot؟

تحتاج إلى Service Hub، وخاصيتين مخصصتين للتذاكر، ومفتاح لاستدعاءات API، وتطبيق لـ Webhook الرد: إما تطبيق خاص قديم أُنشئ قبل 26 أكتوبر 2026، وإما تطبيق قائم على المشاريع يُبنى باستخدام HubSpot CLI ويحتاج إلى مطوّر.

هل هذا تطبيق من سوق تطبيقات HubSpot؟

لا. إنه سير عمل n8n تستورده إلى n8n الخاص بك، السحابي أو المستضاف ذاتيًا، مع دليل إعداد في وثائق Spun.

محادثات واتساب كتذاكر في HubSpot

يحوّل Spun رقم واتساب الحالي لديك إلى صندوق وارد مشترك للفريق، مع التسميات والإسناد والملخصات بالذكاء الاصطناعي، إضافة إلى مزامنة جهات الاتصال مع HubSpot والـ Webhooks وواجهة API التي يستخدمها سير العمل هذا. تجربة مجانية.

ابدأ مجانًا: 7 أيام من كل الميزات

عرض كل التكاملات