> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# نشاط جهة الاتصال من Flowella في HubSpot

> اطّلع على كل نشاط WhatsApp من Flowella مسجَّل في الجدول الزمني لجهة الاتصال في HubSpot، وأسماء أحداث Timeline v4، وكيفية استخدامها كمُشغِّلات لسير العمل.

تتم كتابة كل تفاعل WhatsApp تتعامل معه Flowella إلى سجل جهة الاتصال في HubSpot كنشاط على الجدول الزمني، تحت الاسم **Flowella: WhatsApp Forms Integration**. يمنح هذا فريقك تاريخًا كاملًا للتفاعل عبر WhatsApp إلى جانب البريد الإلكتروني والمكالمات والاجتماعات.

كما يتم عرض كل نوع من أنواع النشاط كمُشغِّل سير عمل في Flowella، ويمكن استخدامه مع إجراء **Delay until event occurs** في HubSpot لإيقاف سير العمل مؤقتًا حتى تقوم جهة الاتصال بشيء ما على WhatsApp.

<Note>
  تستخدم أحداث نشاط جهة الاتصال واجهة برمجة تطبيقات أحداث **CRM Timeline v4** من HubSpot. خلف الكواليس، أنواع الأحداث الأربعة هي `flowella-message-sent` و`flowella-message-seen` و`flowella-reply` و`flowella-form-completed`. لا ترى أبدًا سوى التسميات الودودة في الجدول الزمني، لكن أسماء الأحداث الأساسية مهمة إذا كنت تبني تقارير مخصصة أو تكاملات خارجية فوق واجهة برمجة تطبيقات HubSpot.
</Note>

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

| النشاط         | يتم تسجيله عندما                                    | مُشغِّل سير العمل | الاستخدام مع Delay until event | حدث Timeline v4           |
| -------------- | --------------------------------------------------- | ----------------- | ------------------------------ | ------------------------- |
| اكتمال النموذج | تُرسل جهة اتصال نموذج WhatsApp Flow أرسلته Flowella | Form Completed    | نعم                            | `flowella-form-completed` |
| إرسال الرسالة  | ترسل Flowella رسالة صادرة أو قالبًا                 | Message Sent      | نعم                            | `flowella-message-sent`   |
| قراءة الرسالة  | تفتح جهة الاتصال رسالة سلّمتها Flowella             | Message Read      | نعم                            | `flowella-message-seen`   |
| تلقي الرد      | ترسل جهة الاتصال ردًا نصيًا حرًا                    | Text Reply        | نعم                            | `flowella-reply`          |

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

### اكتمال النموذج

يتم تسجيله عندما تكمل جهة اتصال نموذج WhatsApp Flow. يسجّل النشاط:

* **النوع**: قالب
* **المصدر**: WhatsApp Flow
* **النموذج**: اسم النموذج المكتمَل، على سبيل المثال Get Started
* **الروابط**: View submission، View in Flowella

### إرسال الرسالة

يتم تسجيله عندما ترسل Flowella رسالة صادرة أو قالبًا إلى جهة الاتصال. يسجّل النشاط:

* **الاتجاه**: صادر
* **النوع**: قالب أو نص
* **الحالة**: مرسلة
* **القالب**: اسم القالب، على سبيل المثال `flowella_form_reminder`
* **الروابط**: Open in Inbox، View in Flowella

### قراءة الرسالة

يتم تسجيله عندما تفتح جهة الاتصال رسالة سلّمتها Flowella. يسجّل النشاط:

* **الاتجاه**: وارد (إيصال)
* **النوع**: نص
* **زمن القراءة**: المدة التي مرّت بعد التسليم قبل أن تفتح جهة الاتصال الرسالة
* **الروابط**: View message in Flowella

### تلقي الرد

يتم تسجيله عندما ترسل جهة الاتصال ردًا نصيًا حرًا. يسجّل النشاط:

* **الاتجاه**: وارد
* **النوع**: نص
* **الرسالة**: محتوى الرد
* **زمن الاستجابة**: مدى سرعة رد جهة الاتصال
* **الروابط**: Open in Inbox، View in Flowella

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

تشغّل الأنشطة الأربعة نفسها مُشغِّلات سير عمل Flowella في HubSpot. يمكنك تسجيل جهة اتصال عند وقوع نشاط، أو احتجاز جهة اتصال عند خطوة **Delay until event occurs** حتى يقع النشاط.

| النشاط         | مُشغِّل سير العمل | الاستخدام النموذجي                              |
| -------------- | ----------------- | ----------------------------------------------- |
| اكتمال النموذج | Form Completed    | معالجة إجابات النموذج، ثم التفرع بناءً على الرد |
| إرسال الرسالة  | Message Sent      | تسجيل النشاط الصادر أو بدء مؤقت متابعة          |
| قراءة الرسالة  | Message Read      | المتابعة فقط بعد أن ترى جهة الاتصال الرسالة     |
| تلقي الرد      | Text Reply        | توجيه جهة الاتصال بناءً على ما ردّت به          |

<Note>
  أقوى نمط هو **الإرسال ثم الانتظار**: أرسل قالبًا، أضف خطوة **Delay until event occurs** مضبوطة على حدث Flowella مثل Form Completed، ثم تفرّع بناءً على ما إذا وقع الحدث في النافذة التي اخترتها. راجع [إجراءات سير العمل](/hubspot/workflow-actions) للاطلاع على الإعداد الكامل، بما في ذلك كيفية تصفية مُشغِّل Text Reply حسب محتوى الرسالة.
</Note>

## تشغيل أحداث نشاط جهة الاتصال أو إيقافها

تتم كتابة الأحداث الأربعة بواسطة **قدرة** على مستوى المؤسسة. يمكنك تشغيل الميزة بأكملها أو إيقافها دون إلغاء تثبيت تطبيق HubSpot.

انتقل إلى **Settings → HubSpot → Contact activity events** وبدّل المفتاح.

* **مشغَّل (افتراضي)** — تنشر Flowella أحداث message-sent وmessage-seen وreply وform-completed إلى الجدول الزمني لكل جهة اتصال متصلة.
* **متوقَّف** — تتوقف Flowella عن نشر أحداث جديدة. تبقى إدخالات الجدول الزمني الموجودة كما هي.

إيقاف المفتاح مفيد أثناء تصحيح أخطاء سير عمل صاخب، أو إذا أراد مسؤول البوّابة إبقاء بيانات WhatsApp خارج الجدول الزمني لـ CRM مؤقتًا.

## الروابط العميقة من الجدول الزمني

يحمل كل حدث في الجدول الزمني رابطين يمكنك النقر عليهما مباشرة من بطاقة النشاط:

* **View in Flowella** — يستخدم **مسار صندوق الوارد الجديد المحدَّد بنطاق القناة** (`/{org}/{waba}/{phone}/inbox/...`) بحيث تصل إلى القناة الصحيحة حتى لو كان حساب Flowella الخاص بك يمتد عبر عدة WABAs.
* **Open in Inbox** — يفتح سلسلة **live-messages** الخاصة بـ HubSpot للمحادثة، حتى يتمكن وكيل من الرد من داخل HubSpot.

(خلف الكواليس، تُعرَض هذه في حمولة حدث v4 على شكل `flowellaRecordUrl` و`inboxUrl`. كانت سابقًا عامة وكانت تتعطّل مع الحسابات متعددة القنوات — يتم الآن إنشاء كلا الرابطين لكل قناة على حدة.)

## إيجاد الأنشطة على جهة اتصال

افتح أي سجل جهة اتصال وانظر إلى الجدول الزمني **Activities**. تظهر أحداث Flowella تحت تسمية **Flowella: WhatsApp Forms Integration**. لعرض نشاط WhatsApp فقط، صفِّ الجدول الزمني حسب نوع النشاط هذا. تغذّي هذه الأنشطة ذاتها خصائص جهة الاتصال والمحادثة المستخدَمة في [التقارير ولوحات المعلومات](/hubspot/reporting-and-dashboards).

## ذات صلة

<CardGroup cols={2}>
  <Card title="إجراءات سير العمل" icon="git-branch" href="/hubspot/workflow-actions">
    إعداد مُشغِّلات وإجراءات Flowella في سير عمل HubSpot.
  </Card>

  <Card title="التقارير ولوحات المعلومات" icon="chart-column" href="/hubspot/reporting-and-dashboards">
    أعدّ تقارير عن نشاط WhatsApp إلى جانب قنواتك الأخرى.
  </Card>

  <Card title="القناة المخصصة" icon="inbox" href="/hubspot/custom-channel">
    أحضِر محادثات WhatsApp إلى صندوق وارد HubSpot.
  </Card>

  <Card title="استخدام صندوق الوارد" icon="messages-square" href="/app/inbox">
    اقرأ محادثات WhatsApp وردّ عليها في Flowella.
  </Card>
</CardGroup>