تستخدم أحداث نشاط جهة الاتصال واجهة برمجة تطبيقات أحداث CRM Timeline v4 من HubSpot. خلف الكواليس، أنواع الأحداث الأربعة هي
flowella-message-sent وflowella-message-seen وflowella-reply وflowella-form-completed. لا ترى أبدًا سوى التسميات الودودة في الجدول الزمني، لكن أسماء الأحداث الأساسية مهمة إذا كنت تبني تقارير مخصصة أو تكاملات خارجية فوق واجهة برمجة تطبيقات HubSpot.الأنشطة المتتبَّعة على جهة اتصال
خصائص الأحداث المستخدَمة للتصفية
يحمل كل حدث في الجدول الزمني من Flowella مجموعة ثابتة من الخصائص المُعرَّفة في تطبيق مطوِّر HubSpot. ترفض 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 contains “cancel” على Reply Received لبناء سير عمل نية الإلغاء.
الاتجاه ليس حاليًا خاصية حدث. يتحدّد الاتجاه بنوع الحدث: Message Sent وMessage Read دائمًا صادرَان، وReply Received دائمًا وارد. صفِّ حسب الحدث نفسه بدلًا من التصفية عبر خاصية
direction.تُضبَط هذه الخصائص على حدث الجدول الزمني. تظهر في مُشغِّلات سير العمل كحقول قابلة للتصفية ضمن حدث Flowella؛ وفي قوائم HubSpot النشطة يمكنك الإشارة إليها عبر عامل تصفية حدث الجدول الزمني لنوع الحدث المطابق.
ما يسجّله كل نشاط
اكتمال النموذج
يتم تسجيله عندما تكمل جهة اتصال نموذج WhatsApp Flow. يسجّل النشاط:- اسم النموذج: اسم النموذج المكتمَل، على سبيل المثال Get Started
- المصدر: مصدر الإرسال، على سبيل المثال WhatsApp Flow
- الروابط: View submission، View in Flowella
إرسال الرسالة
يتم تسجيله عندما ترسل Flowella رسالة صادرة أو قالبًا إلى جهة الاتصال. يسجّل النشاط:- الهاتف: رقم هاتف المستلِم بتنسيق E.164
- حالة التسليم: حالة التسليم من Meta، على سبيل المثال
sent - اسم القالب: القالب المستخدَم، على سبيل المثال
flowella_form_reminder(يُضبَط فقط عندما تُرسَل الرسالة من قالب) - الروابط: Open in Inbox، View in Flowella
قراءة الرسالة
يتم تسجيله عندما تفتح جهة الاتصال رسالة سلّمتها Flowella. يسجّل النشاط:- الهاتف: رقم هاتف المستلِم بتنسيق E.164
- نوع الرسالة: نوع الرسالة الصادرة التي تمت قراءتها — أحد
TEXTأوIMAGEأوAUDIOأوVIDEOأوDOCUMENTأوTEMPLATEأوSYSTEMأوOTHER - زمن القراءة (بالثواني): المدة التي مرّت بعد التسليم قبل أن تفتح جهة الاتصال الرسالة
- الروابط: View message in Flowella
تلقي الرد
يتم تسجيله عندما ترسل جهة الاتصال ردًا نصيًا حرًا. يسجّل النشاط:- الهاتف: رقم هاتف جهة الاتصال بتنسيق E.164
- الرسالة: محتوى الرد
- زمن الاستجابة (بالثواني): مدى سرعة رد جهة الاتصال
- الروابط: Open in Inbox، View in Flowella
استخدام الأنشطة في سير العمل
تشغّل الأنشطة الأربعة نفسها مُشغِّلات سير عمل Flowella في HubSpot. يمكنك تسجيل جهة اتصال عند وقوع نشاط، أو احتجاز جهة اتصال عند خطوة Delay until event occurs حتى يقع النشاط.أقوى نمط هو الإرسال ثم الانتظار: أرسل قالبًا، أضف خطوة Delay until event occurs مضبوطة على حدث Flowella مثل Form Completed، ثم تفرّع بناءً على ما إذا وقع الحدث في النافذة التي اخترتها. راجع إجراءات سير العمل للاطلاع على الإعداد الكامل، بما في ذلك كيفية تصفية مُشغِّل Text Reply حسب محتوى الرسالة.
تشغيل أحداث نشاط جهة الاتصال أو إيقافها
تتم كتابة الأحداث الأربعة بواسطة قدرة على مستوى المؤسسة. يمكنك تشغيل الميزة بأكملها أو إيقافها دون إلغاء تثبيت تطبيق HubSpot. انتقل إلى Settings → HubSpot → Contact activity events وبدّل المفتاح.- مشغَّل (افتراضي) — تنشر Flowella أحداث message-sent وmessage-seen وreply وform-completed إلى الجدول الزمني لكل جهة اتصال متصلة.
- متوقَّف — تتوقف Flowella عن نشر أحداث جديدة. تبقى إدخالات الجدول الزمني الموجودة كما هي.
الروابط العميقة من الجدول الزمني
يحمل كل حدث في الجدول الزمني رابطين يمكنك النقر عليهما مباشرة من بطاقة النشاط:- View in Flowella — يستخدم مسار صندوق الوارد الجديد المحدَّد بنطاق القناة (
/{org}/{waba}/{phone}/inbox/...) بحيث تصل إلى القناة الصحيحة حتى لو كان حساب Flowella الخاص بك يمتد عبر عدة WABAs. - Open in Inbox — يفتح سلسلة live-messages الخاصة بـ HubSpot للمحادثة، حتى يتمكن وكيل من الرد من داخل HubSpot.
flowellaRecordUrl وinboxUrl. كانت سابقًا عامة وكانت تتعطّل مع الحسابات متعددة القنوات — يتم الآن إنشاء كلا الرابطين لكل قناة على حدة.)
إيجاد الأنشطة على جهة اتصال
افتح أي سجل جهة اتصال وانظر إلى الجدول الزمني Activities. تظهر أحداث Flowella تحت تسمية Flowella: WhatsApp Forms Integration. لعرض نشاط WhatsApp فقط، صفِّ الجدول الزمني حسب نوع النشاط هذا. تغذّي هذه الأنشطة ذاتها خصائص جهة الاتصال والمحادثة المستخدَمة في التقارير ولوحات المعلومات.ذات صلة
إجراءات سير العمل
إعداد مُشغِّلات وإجراءات Flowella في سير عمل HubSpot.
التقارير ولوحات المعلومات
أعدّ تقارير عن نشاط WhatsApp إلى جانب قنواتك الأخرى.
القناة المخصصة
أحضِر محادثات WhatsApp إلى صندوق وارد HubSpot.
استخدام صندوق الوارد
اقرأ محادثات WhatsApp وردّ عليها في Flowella.