دليل إعداد تكامل HubSpot مع واتساب

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

يستغرق الإعداد نحو خمس دقائق، ولا يتطلب أي برمجة. هذه الصفحة عامة ولا تحتاج إلى تسجيل دخول.

١. المتطلبات قبل البدء

حساب في لتس بوت. يمكنك البدء بتجربة مجانية مدتها 14 يومًا دون بطاقة ائتمان.
رقم واتساب بزنس مربوط داخل لتس بوت، لأن الرسائل تُرسل عبر واتساب بزنس API الرسمي.
حساب HubSpot لديك فيه صلاحية تثبيت التطبيقات (مسؤول عن الحساب).
أرقام هواتف صحيحة بصيغة دولية على جهات الاتصال في HubSpot، ليتمكّن التطبيق من تحديد المستلم.

٢. تثبيت التطبيق وربط HubSpot

يتم الربط عبر OAuth من HubSpot مباشرةً. لا يُطلب منك نسخ أي مفتاح API أو لصقه.

1 سجّل الدخول إلى لوحة لتس بوت. letsbot.net/login

2 افتح قسم التكاملات، ثم اختر HubSpot.

3 اضغط زر «Connect HubSpot». ستنتقل إلى شاشة تفويض OAuth الخاصة بـ HubSpot.

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

5 ستعود تلقائيًا إلى لوحة لتس بوت وقد اكتمل الربط، وتكون المحفّزات الأساسية مفعّلة مسبقًا وجاهزة للتخصيص.

ابدأ الربط الآن

٣. الأذونات المطلوبة ولماذا

يطلب التطبيق الحد الأدنى من الأذونات التي تحتاجها وظائفه فعليًا. هذه قائمتها الكاملة:

الإذن	سبب الطلب
`crm.objects.contacts.read`	قراءة بيانات جهة الاتصال (الاسم ورقم الهاتف والبريد) لتحديد المستلم وتعبئة متغيّرات الرسالة.
`crm.objects.contacts.write`	إنشاء جهة اتصال عند ورود رسالة واتساب من رقم غير مسجَّل، وتسجيل الردود كملاحظات على الجدول الزمني لجهة الاتصال.
`crm.objects.deals.read`	قراءة بيانات الصفقة (الاسم والمرحلة والقيمة وتاريخ الإغلاق) وجهة الاتصال المرتبطة بها، لتشغيل محفّزات الصفقات.
`tickets`	قراءة بيانات التذكرة (الموضوع والمحتوى) وجهة الاتصال المرتبطة بها، لتشغيل محفّز التذاكر.

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

٤. اختيار الحدث المُشغِّل

كل حدث مستقل بذاته: تفعّل ما تحتاجه فقط، وتُعطّل الباقي في أي وقت. لا تُرسَل أي رسالة عن حدث لم تُفعّله بنفسك.

الحدث	المعرّف في HubSpot	ماذا يحدث
إنشاء جهة اتصال	`contact.creation`	تُرسل رسالة ترحيب فور إضافة جهة اتصال جديدة في HubSpot.
تغيّر مرحلة دورة حياة جهة الاتصال	`contact.propertyChange`	تُرسل رسالة عند انتقال جهة الاتصال إلى مرحلة جديدة (مثل: عميل محتمل مؤهَّل).
إنشاء صفقة	`deal.creation`	تُرسل رسالة إلى العميل المرتبط بالصفقة فور إنشائها.
تغيّر مرحلة الصفقة	`deal.propertyChange`	تُرسل تحديثًا عند انتقال الصفقة إلى مرحلة أخرى في مسار البيع.
إنشاء تذكرة دعم	`ticket.creation`	تُشعر العميل عبر واتساب بأن تذكرته وصلت وقيد المعالجة.

٥. كتابة الرسالة أو اختيار قالب

لكل حدث يمكنك كتابة رسالة نصية سريعة، أو اختيار قالب واتساب غني يدعم الأزرار والقوائم والوسائط. تُدرَج بيانات HubSpot داخل الرسالة عبر المتغيّرات التالية:

المتغيّر	القيمة
`{CONTACT_FIRSTNAME}`	الاسم الأول لجهة الاتصال
`{DEAL_NAME}`	اسم الصفقة
`{DEAL_STAGE}`	مرحلة الصفقة
`{DEAL_AMOUNT}`	قيمة الصفقة
`{TICKET_SUBJECT}`	موضوع التذكرة
`{TICKET_CONTENT}`	محتوى التذكرة

تدعم الرسائل العربية والإنجليزية معًا. إذا كانت لغة جهة الاتصال محدّدة في لتس بوت فسيُرسَل الإصدار المطابق لها، وإلا فسيُستخدم الإصدار الإنجليزي افتراضيًا.

٦. التفعيل والاختبار

1 فعّل مفتاح التشغيل بجوار الحدث الذي أعددته، ثم احفظ.

2 في HubSpot، أنشئ سجلًا حقيقيًا من نوع الحدث — مثلًا جهة اتصال جديدة — واجعل رقم هاتفها رقمك أنت.

3 ستصلك رسالة واتساب خلال ثوانٍ. يمكنك متابعة حالة الإرسال من سجل الرسائل داخل لتس بوت.

٧. تسجيل ردود العملاء في HubSpot

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

٨. حل المشكلات الشائعة

لم تصل الرسالة

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

محفّزات الصفقات أو التذاكر لا تعمل

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

انقطع الربط فجأة

يحدث هذا إذا أُلغي تثبيت التطبيق من داخل HubSpot أو سُحب التفويض. أعد الربط من لوحة لتس بوت بالضغط على «Connect HubSpot» مرة أخرى.

٩. إلغاء الربط وحذف التطبيق

يمكنك إلغاء الربط في أي وقت من لوحة لتس بوت عبر زر إلغاء الربط، أو بإزالة التطبيق من إعدادات التطبيقات المتصلة في حساب HubSpot. بمجرد إلغاء الربط تتوقف جميع الرسائل التلقائية فورًا، ولا يعود للتطبيق أي وصول إلى بياناتك.

١٠. البيانات والخصوصية

تُنقل جميع البيانات عبر اتصال مشفَّر، وتُخزَّن رموز الوصول مشفّرة. يقرأ لتس بوت من HubSpot فقط الحقول اللازمة لتخصيص الرسالة وتحديد المستلم، ولا تُشارك بياناتك مع أي طرف ثالث.

سياسة الخصوصية · شروط الاستخدام · تواصل مع الدعم

هل تحتاج مساعدة في الإعداد؟ فريق الدعم متاح بالعربية والإنجليزية ويساعدك على إتمام الربط وإرسال أول رسالة.

العودة إلى صفحة تكامل HubSpot