الانتقال إلى المحتوى الرئيسي
يسجّل Flowella نشاط WhatsApp على سجل جهة الاتصال في HubSpot بوصفه أنشطة على المخطط الزمني، تحمل التسمية Flowella: WhatsApp Forms Integration. يرى فريقك التفاعل عبر WhatsApp بجانب البريد الإلكتروني والمكالمات والاجتماعات. كل نوع نشاط هو أيضًا مشغّل لسير العمل من Flowella، ويعمل مع خطوة Delay until event في HubSpot لإيقاف سير العمل مؤقتًا حتى تقوم جهة الاتصال بإجراء ما على WhatsApp. تحتاج هذه الأنشطة إلى إمكانية Contact activity events (message sent, read, replies, forms). راجع تحقق من إتاحة أحداث نشاط جهة الاتصال.

الأنشطة المتتبَّعة لجهة الاتصال

يحمل كل نشاط الاسم نفسه الذي يحمله مشغّل سير العمل المقابل له، ويمكنك استخدام كل منها في خطوة Delay until event. لا تسجّل الصور والملاحظات الصوتية ومقاطع الفيديو والمستندات الواردة من جهة الاتصال نشاط Text Reply، لذا لا تطلق مشغّل Text Reply.
إذا أنشأت تقارير أو تكاملات باستخدام API الخاص بـ HubSpot، فإن أسماء الأحداث هي flowella-form-completed وflowella-message-sent وflowella-message-seen وflowella-reply. أما في HubSpot نفسه فلا ترى سوى التسميات أعلاه.

خصائص الأحداث للتصفية

يحمل كل حدث من Flowella الخصائص أدناه. يمكنك استخدامها بوصفها شروط تصفية في مشغّلات سير عمل HubSpot والقوائم النشطة والتقارير للحدث المطابق. messageType هي قائمة قيم (enum) في حدث Message Read تتضمن القيم TEXT وIMAGE وAUDIO وVIDEO وDOCUMENT وTEMPLATE وSYSTEM وOTHER. وتصف الرسالة الصادرة التي قُرئت. مرشّحات شائعة:
  • formName = Get Started في Form Completed للتشغيل فقط عند إرسال نموذج WhatsApp Flow محدد.
  • messageType = TEMPLATE في Message Read لعزل إشعارات قراءة القوالب التي أرسلتها.
  • templateName = flowella_form_reminder في Message Sent لتقسيم جهات الاتصال التي أُرسل إليها قالب محدد.
تجنب التصفية حسب Message في حدث Text Reply. يقيّم HubSpot مرشّحات الأحداث مقابل كل أحداث Text Reply السابقة على جهة الاتصال، لذا فإن جهة الاتصال التي ردت بـ “cancel” قبل أشهر ستظل تطابق المرشّح Message contains "cancel" إلى الأبد. تفرّع بناءً على خاصية جهة الاتصال Last WhatsApp reply message بدلًا من ذلك. فهي لا تحتوي إلا على أحدث رد.
لا توجد خاصية للاتجاه. يتعلق Message Sent وMessage Read دائمًا بالرسائل التي أرسلتها، ويمثل Text Reply دائمًا رسالة من جهة الاتصال. صفِّ حسب الحدث نفسه.
تُضبط هذه الخصائص على حدث المخطط الزمني. في مشغّلات سير العمل، تظهر بوصفها حقولًا قابلة للتصفية ضمن حدث Flowella، وفي القوائم النشطة في HubSpot يمكنك الإشارة إليها عبر مرشّح حدث المخطط الزمني لنوع الحدث المطابق.

خصائص جهة الاتصال Last WhatsApp reply

إلى جانب أحداث المخطط الزمني، يحتفظ Flowella بخاصيتين لجهة الاتصال تحتويان دائمًا على أحدث رد وارد عبر WhatsApp من جهة الاتصال: توجد الخاصيتان في مجموعة Flowella Properties على سجل جهة الاتصال. ينشئ Flowella المجموعة والخاصيتين عند ربط HubSpot أو إعادة ربطه، إذا كانت CRM contacts (auto-create on new WhatsApp chat) متاحة في Settings → HubSpot. إذا كانتا مفقودتين، ينشئهما Flowella في المرة التالية التي يسجّل فيها ردًا. يستبدل Flowella قيمتي الخاصيتين في كل مرة يسجّل فيها نشاط Text Reply: للرسائل النصية، والنقر على الأزرار، والاختيار من القوائم، وإرسال Flows. بالنسبة إلى إرسال Flow، تحتوي Last WhatsApp reply message على ملخص من سطر واحد للإرسال. يحدّث Flowella الخاصيتين قبل تسجيل النشاط. عندما يُطلق مشغّل Text Reply، تكون Last WhatsApp reply message محتوية بالفعل على الرسالة التي أطلقته، لذا يمكن لسير العمل التفرع بناءً على الخاصية فورًا. إذا استمر HubSpot في رفض التحديث، يسجّل Flowella النشاط على أي حال. تُقتطع الردود التي يتجاوز طولها 4,096 حرفًا إلى أول 4,096 حرفًا.

التفرع بناءً على الخاصية، لا على رسالة الحدث

يقيّم HubSpot مرشّحات الأحداث مثل Text Reply → Message contains مقابل كل أحداث Text Reply السابقة على جهة الاتصال، وليس أحدثها فقط. بمجرد أن ترسل جهة الاتصال ردًا مطابقًا في أي وقت، يطابق المرشّح إلى الأبد. تتجنب خاصية جهة الاتصال ذلك لأنها لا تحتوي إلا على أحدث رد. النمط الموصى به هو:
  1. سجّل جهة الاتصال في سير العمل عند حدث Text Reply ليُطلق عند وصول رسالة واردة جديدة.
  2. تفرّع بناءً على خاصية جهة الاتصال Last WhatsApp reply message. استخدم المساواة التامة للخيارات الثابتة مثل Yes / No، أو “contains any of” للتوجيه بالكلمات المفتاحية.
إذا كانت لديك سير عمل حالية تصفّي حسب Text Reply → Message، فأعد بناءها لتتفرع بناءً على خاصية جهة الاتصال Last WhatsApp reply message. يطابق مرشّح Message على مستوى الحدث سجل الردود بالكامل ويمكن أن يسجّل جهات اتصال بناءً على ردود قديمة.
يحتفظ HubSpot بسجل تغييرات الخصائص، لذا تظل القيم السابقة لـ Last WhatsApp reply message مرئية في سجل الخاصية على سجل جهة الاتصال. أدرج الخاصية في أي عملية للاحتفاظ بالبيانات أو حذفها تشمل محتوى الرسائل.

ما يسجّله كل نشاط

Form Completed

يُسجَّل عندما تكمل جهة اتصال نموذج WhatsApp Flow. يسجّل النشاط:
  • اسم النموذج: اسم النموذج المكتمل، مثل Get Started
  • المصدر: دائمًا WhatsApp Flow
  • الروابط: View submission، View in Flowella
انقر على View submission لفتح نافذة على سجل جهة الاتصال تعرض الأسئلة وإجابات جهة الاتصال، من دون مغادرة HubSpot. راجع نافذتا View submission وView template.

Message Sent

يُسجَّل عندما تؤكد Meta أنها أرسلت رسالة WhatsApp من Flowella إلى جهة الاتصال. يسجّل النشاط:
  • الهاتف: رقم هاتف جهة الاتصال بتنسيق E.164
  • الحالة: Sent
  • القالب: اسم القالب، مثل flowella_form_reminder (فقط عندما تكون الرسالة قالبًا)
  • الروابط: View template، Open in Inbox، View in Flowella
تكون الحالة دائمًا Sent: لا يحدّث Flowella النشاط عند تسليم الرسالة. لا يُسجَّل التسليم إلى هاتف جهة الاتصال بوصفه نشاطًا منفصلًا، وتُسجَّل القراءات بوصفها Message Read. عندما تكون الرسالة قالبًا، يحتوي النشاط على رابط View template يفتح القالب كما رأته جهة الاتصال. راجع نافذتا View submission وView template.

Message Read

يُسجَّل عندما تبلغ Meta بأن جهة الاتصال قرأت رسالة من Flowella. يسجّل النشاط:
  • الهاتف: رقم هاتف جهة الاتصال بتنسيق E.164
  • نوع الرسالة: نوع الرسالة التي قُرئت، وهو أحد TEXT أو IMAGE أو AUDIO أو VIDEO أو DOCUMENT أو TEMPLATE أو SYSTEM أو OTHER
  • وقت القراءة (بالثواني): المدة التي قرأت بعدها جهة الاتصال الرسالة منذ أن أرسلها Flowella
  • الروابط: View message in Flowella

Text Reply

يُسجَّل عندما ترسل جهة الاتصال رسالة نصية، أو تنقر على زر، أو تختار من قائمة، أو ترسل Flow. يسجّل النشاط:
  • الهاتف: رقم هاتف جهة الاتصال بتنسيق E.164
  • الرسالة: محتوى الرد. بالنسبة إلى إرسال Flow، ملخص من سطر واحد.
  • وقت الاستجابة (بالثواني): الوقت بين آخر رسالة منك في المحادثة وهذا الرد
  • الروابط: Open in Inbox، View in Flowella

استخدام الأنشطة في سير العمل

تشغّل الأنشطة الأربعة نفسها مشغّلات سير عمل HubSpot من Flowella. يمكنك تسجيل جهة اتصال عند وقوع نشاط، أو إبقاء جهة اتصال عند خطوة Delay until event حتى يقع.
النمط الأقوى هو الإرسال ثم الانتظار: أرسل قالبًا، وأضف خطوة Delay until event مضبوطة على حدث من Flowella مثل Form Completed، ثم تفرّع بناءً على ما إذا كان الحدث قد وقع ضمن الفترة التي اخترتها. راجع إجراءات سير العمل للاطلاع على الإعداد الكامل، بما في ذلك كيفية التوجيه بناءً على رد جهة الاتصال باستخدام خاصية Last WhatsApp reply message.

تحقق من إتاحة أحداث نشاط جهة الاتصال

لا يسجّل Flowella هذه الأنشطة إلا عندما تكون Contact activity events (message sent, read, replies, forms) ضمن Unlocked في بطاقة Capabilities في Settings → HubSpot. وتحتاج إلى أذونات HubSpot timeline وanalytics.behavioral_events.send. إذا كانت ضمن Not available، فأعد ربط HubSpot ووافق على الأذونات. لا يوجد إعداد لإيقاف الأنشطة مؤقتًا. تتوقف فقط عند فصل HubSpot، وتبقى الأنشطة الموجودة بالفعل على المخطط الزمني.

روابط مباشرة من المخطط الزمني

يحمل كل نشاط روابط يمكنك النقر عليها مباشرة من بطاقة النشاط:
  • يفتح View in Flowella المحادثة في صندوق الوارد في Flowella، على رقم WhatsApp الذي تستخدمه المحادثة، حتى إذا كانت لدى مؤسستك عدة أرقام.
  • يفتح Open in Inbox سلسلة المحادثة في صندوق وارد المحادثات في HubSpot، ليتمكن الوكيل من الرد من HubSpot. لا يعمل إلا عندما تكون لجهة الاتصال محادثة في صندوق وارد HubSpot، مثلًا عبر قناة Flowella المخصصة.
  • يفتح View submission (Form Completed) وView template (Message Sent، لرسائل القوالب فقط) نافذة على سجل جهة الاتصال. راجع أدناه.

نافذتا View submission وView template

تحتوي أنشطة Form Completed وأنشطة Message Sent الخاصة بالقوالب على رابط يفتح نافذة على سجل جهة الاتصال في HubSpot. يمكن لفريقك مراجعة ما أُرسل، أو ما رأته جهة الاتصال، من دون التبديل بين علامات التبويب. يحفظ Flowella نسخة من الإرسال أو القالب عند تسجيل النشاط. تعرض النافذة ما أرسلته جهة الاتصال أو ما رأته، حتى إذا عدّلت القالب أو الـ Flow لاحقًا. يعمل كل رابط لمدة 24 ساعة بعد أن يسجّل Flowella النشاط. بعد ذلك، تعرض النافذة Link expired، ويعرض فتح النشاط مرة أخرى الرابط المنتهي نفسه. للاطلاع على التفاصيل لاحقًا، استخدم View in Flowella. اضغط على Escape أو انقر خارج النافذة للعودة إلى المخطط الزمني لجهة الاتصال.

العثور على الأنشطة في جهة اتصال

افتح أي سجل لجهة اتصال وانظر إلى المخطط الزمني Activities. تظهر أحداث Flowella ضمن التسمية Flowella: WhatsApp Forms Integration. لعرض نشاط WhatsApp فقط، صفِّ المخطط الزمني حسب نوع النشاط هذا. لإعداد تقارير حول نشاط WhatsApp، راجع التقارير ولوحات المعلومات.

ذات صلة

إجراءات سير العمل

أعدّ مشغّلات Flowella وإجراءاته في سير عمل HubSpot.

التقارير ولوحات المعلومات

أعدّ تقارير حول نشاط WhatsApp إلى جانب قنواتك الأخرى.

القناة المخصصة

اجلب محادثات WhatsApp إلى صندوق وارد HubSpot.

استخدام صندوق الوارد

اقرأ محادثات WhatsApp وردّ عليها في Flowella.
آخر تعديل في ٢٤ أكتوبر ٢٠٢٦