مرجع النقاط

تحمل كل نقطة كائن point_data بمفتاح متداخل واحد بالضبط، يطابق point_type للنقطة (انظر تخطيط point-type → key). توثق هذه الصفحة الهيكل تحت كل مفتاح.

نقاط الدخول

تحتاج الـ journey إلى نقطة دخول واحدة على الأقل. جميع نقاط الدخول لها مخرج default واحد.

start_by_segment

يدخل المستخدمون الذين يطابقون segment. POINT_TYPE_START_BY_SEGMENT.

الحقل	النوع	الوصف
`application_code`	string	رمز التطبيق.
`filter_code`	string	رمز Segment/filter الذي يحدد الجمهور.
`repeat`	`SegmentRepeat`	جدول دخول متكرر اختياري (انظر SegmentRepeat).
`start_at`	timestamp	لا تقم بالمعالجة قبل هذا الوقت (ISO 8601).
`is_deactivated`	bool	ما إذا كانت نقطة الدخول هذه معطلة.

message_bus (event entry)

يدخل المستخدمون عندما يقومون بتشغيل event. POINT_TYPE_EVENT.

الحقل	النوع	الوصف
`event_name`	string	اسم الـ Event الذي سيتم الاستماع إليه.
`application_code`	string	رمز التطبيق.
`event_conditions`	`PointEventCondition[]`	الشروط التي تتم مطابقتها مع سمات الـ event.
`active_period`	`Period`	نافذة زمنية يكون فيها المشغل نشطًا.
`multi_entry`	`MultiEntry`	كيف يمكن للمستخدم الدخول أكثر من مرة (انظر MultiEntry).
`attribute_entry`	`AttributeEntry`	تسجيل User IDs المحمولة في سمة event بدلاً من المستخدم الذي قام بتشغيل الـ event (انظر AttributeEntry).
`allow_reenter`	bool	ما إذا كان يمكن للمستخدمين إعادة الدخول إلى الـ journey.

AttributeEntry

يسجل User IDs المحمولة في سمة event، بدلاً من المستخدم الذي قام بتشغيل الـ event. يعكس المستخدمون من سمة event في منشئ Customer Journey.

الحقل	النوع	الوصف
`enabled`	bool	ما إذا كان سيتم تسجيل المستخدمين المذكورين في سمة event بدلاً من المستخدم الذي قام بتشغيل الـ event.
`attribute_name`	string	اسم سمة الـ event التي تحمل User ID (أو قائمة من User IDs) للتسجيل.

start_by_api

نقطة دخول يتم تغذيتها بواسطة استدعاء Start by API. POINT_TYPE_START_BY_API.

الحقل	النوع	الوصف
`application_code`	string	رمز التطبيق.
`attributes`	string[]	أسماء السمات المخصصة التي يمكن تمريرها في `attribute_values` لطلب Start by API.
`is_deactivated`	bool	ما إذا كانت نقطة الدخول هذه معطلة.

نقاط التوقيت

delay (wait)

يوقف كل مستخدم مؤقتًا لفترة زمنية ثابتة أو محسوبة. POINT_TYPE_WAIT. يحدد كائن point_data.delay مفتاح فترة زمنية واحدًا بالضبط من المفاتيح التالية:

مفتاح الفترة الزمنية	النوع	الوصف
`sec`	uint64	انتظر عددًا ثابتًا من الثواني.
`exact_time`	`ExactTime`	انتظر حتى وقت معين من اليوم (`hour`, `minute`).
`exact_date_time`	`ExactDateTime`	انتظر حتى تاريخ ووقت مطلقين.
`exact_week_days_time`	`ExactWeekDaysTime`	انتظر حتى أوقات محددة في أيام أسبوع محددة (خريطة من اليوم `0`=الاثنين … `6`=الأحد → `ExactTime`).
`dynamic_time`	`DynamicTime`	انتظر بالنسبة إلى قيمة من tag أو event.

يضيف dynamic_time مع split_branches: true فرع output1 (انظر مفاتيح المخرجات).

DynamicTime

الحقل	النوع	الوصف
`from`	enum `DynamicTimeFrom`	ما إذا كان الوقت الأساسي يأتي من tag أو event.
`direction`	enum `DynamicTimeDirection`	الإزاحة قبل أو بعد الوقت الأساسي.
`duration`	uint64	حجم الإزاحة.
`unit`	enum `DynamicTimeUnit`	وحدة `duration` (دقائق، ساعات، أيام، …).
`split_branches`	bool	قسم المستخدمين إلى فروع منفصلة عندما تختلف أوقاتهم المحسوبة.
`tag_name`	string	الـ Tag الذي يحمل الوقت الأساسي (عندما يكون `from` هو tag).
`event_name` / `event_attribute` / `point_id`	string	مصدر الـ Event للوقت الأساسي (عندما يكون `from` هو event).

wait_event

ينتظر حتى يقوم المستخدمون بتشغيل event (أو انتهاء المهلة). POINT_TYPE_WAIT_EVENT. المخرج default هو مسار عدم التشغيل. المسار المشغل هو output1 أو، مع script، فرع واحد لكل شرط.

الحقل	النوع	الوصف
`events`	`PointWaitEventInfo[]`	الـ Events التي سيتم انتظارها.
`conditions_script`	string	Script اختياري لمنطق الأحداث المتعددة المعقد. تصبح أسماء الشروط التي تم تحليلها هي مفاتيح المخرجات.
`multi_entry`	`MultiEntry`	سلوك إعادة الدخول.

نقاط التقسيم والتصفية

boolean_splitter

يوجه المستخدمين إلى فروع بناءً على شرط. POINT_TYPE_BOOLEAN_SPLITTER.

الحقل	النوع	الوصف
`split_strategy`	enum	`SPLIT_FILTER` (حسب الـ segment)، `SPLIT_TAGS` (حسب شروط الـ tag)، أو `SPLIT_EVENTS` (حسب شروط الـ event).
`load_policy`	enum	`ALL` (قد يطابق أي من أجهزة المستخدم) أو `FILTER` (الجهاز الحالي فقط).
`filter_code`	string	رمز الـ Segment، عندما يكون `split_strategy` هو `SPLIT_FILTER`.
`filter_expressions`	`FilterExpression[]`	شروط الـ Tag، عندما يكون `split_strategy` هو `SPLIT_TAGS`: فرع `output` إضافي واحد لكل تعبير.
`event`	`BooleanSplitterEventInfo`	شروط الـ Event، عندما يكون `split_strategy` هو `SPLIT_EVENTS`: فرع `output` إضافي واحد لكل شرط.

ab_splitter

يقسم المستخدمين عشوائيًا إلى متغيرات مرجحة. POINT_TYPE_AB_SPLITTER. مفاتيح المخرجات هي output0، output1، … (واحد لكل إدخال في split، مفهرس من 0. لا يوجد default).

الحقل	النوع	الوصف
`split`	uint32[]	النسبة المئوية لكل فرع. يجب أن يكون المجموع 100. الفهرس `i` يرتبط بمفتاح المخرج `output{i}`.
`auto_select_winner`	bool	ما إذا كان سيتم اختيار فرع فائز تلقائيًا.
`winner_strategy`	enum	`ANY_GOAL` أو `SPECIFIC_GOAL`.
`goal_uuid`	string	الـ Goal المستخدم لتحديد الفائز (مع `SPECIFIC_GOAL`).
`winner_split`	uint32	رقم الفرع الفائز (يبدأ من 1، `0` = لا يوجد فائز بعد).

filter

يسمح فقط للمستخدمين المطابقين بالاستمرار (default)، ويوجه الباقي إلى output1. POINT_TYPE_FILTER.

الحقل	النوع	الوصف
`filter`	enum `Filter`	فحص محدد مسبقًا: `EMAIL_EXISTS`، `PUSH_TOKEN_EXISTS`، `SMS_TOKEN_EXISTS`، `WHATSAPP_TOKEN_EXISTS`، `LINE_TOKEN_EXISTS`، أو `CUSTOM`.
`filter_raw`	string	تعبير filter مخصص، عندما يكون `filter` هو `CUSTOM`.

نقاط الإجراء

set_tags

يحدّث الـ tags على المستخدم. POINT_TYPE_SET_TAGS.

الحقل	النوع	الوصف
`application_code`	string	رمز التطبيق.
`tags`	`Tag`[]	الـ Tags التي سيتم كتابتها.

Tag

الحقل	النوع	الوصف
`name`	string	اسم الـ Tag.
`type`	enum `TagType`	نوع البيانات والعملية: `TYPE_STRING`، `TYPE_INTEGER`، `TYPE_DATE`، `TYPE_BOOLEAN`، `TYPE_LIST`، `TYPE_LIST_APPEND`، `TYPE_LIST_REMOVE`، `TYPE_DYNAMIC`، …
value	oneof	مفتاح قيمة واحد بالضبط يطابق `type`: `str`، `int`، `bool`، `date`، `price`، `version`، `timezone`، `list`، أو `dynamic`.

web_hook

يرسل طلب HTTP صادر. POINT_TYPE_WEBHOOK. مخرج default واحد.

الحقل	النوع	الوصف
`method`	string	طريقة HTTP (`GET`، `POST`، `PUT`، …).
`url`	string	عنوان URL المستهدف.
`request_template`	string	قالب نص الطلب. يدعم قوالب Liquid.
`headers`	map<string, string>	ترويسات HTTP.
`disabled`	bool	للقراءة فقط. `true` عندما يقوم Pushwoosh بتعطيل الـ webhook تلقائيًا بعد أخطاء متكررة.
`reactivate`	bool	للكتابة فقط. اضبط القيمة على `true` لإعادة تمكين webhook معطل.

نقاط التحويل

goal_event

يتتبع هدف تحويل. POINT_TYPE_GOAL_EVENT. لا يوجد لديه مخرجات.

الحقل	النوع	الوصف
`event_name`	string	اسم event الهدف.
`application_code`	string	رمز التطبيق.
`event_conditions`	`PointEventCondition[]`	الشروط التي تتم مطابقتها مع سمات event الهدف.
`is_throw_out`	bool	ما إذا كان سيتم إزالة المستخدم من الـ journey بمجرد الوصول إلى الهدف.
`is_cancel_event`	bool	ما إذا كان هذا هدفًا سلبيًا (إلغاء).

نقاط الخروج

terminator

ينهي الـ journey للمستخدم. POINT_TYPE_EXIT. كائن فارغ ({}) ولا يوجد مخرجات.

{ "point_type": "POINT_TYPE_EXIT", "point_data": { "terminator": {} }, "outputs": [] }

نقطة الإنهاء اختيارية. ترك info.next_point_uuid للمخرج غير معين ينهي الـ journey للمستخدم بنفس الطريقة التي يفعلها الإنهاء الصريح — يتم حساب كلتا الحالتين بنفس الطريقة، كـ Exits، وليس كأخطاء.

نقاط الرسائل

ترسل جميع نقاط الرسائل عبر قناة وتشارك في غلاف مشترك. لكل منها مخرج default واحد ما لم يتم تمكين splitter (انظر مفاتيح المخرجات).

الحقول المشتركة:

الحقل	النوع	الوصف
`application_code`	string	رمز التطبيق.
`preset_code`	string	Preset (قالب) للإرسال. يستخدم `inapp` `richmedia_code` بدلاً من ذلك.
`content` / `title`	string	محتوى الرسالة المضمن، عند عدم استخدام preset (يعتمد على القناة).
`campaign_code`	string	رمز الحملة للتتبع. يتم إنشاؤه تلقائيًا إذا تم حذفه.
`split_params`	`BehaviorSplitter`	اختياري: انتظر تفاعلًا وتفرع بناءً عليه.
`message_type`	enum	نوع الرسالة تسويقية مقابل معاملات (يتحكم في معالجة مجموعة التحكم). لا يستخدم بواسطة `send_email`، الذي لديه زوج `email_type`/`email_category` الخاص به أدناه.

أنواع النقاط وحقولها الإضافية البارزة:

نوع النقطة	مفتاح `point_data`	ملاحظات
`POINT_TYPE_SEND_PUSH`	`send_push`	يمكن لـ `split_params` (السلوك) بالإضافة إلى مقسم التسليم إنتاج ما يصل إلى ثلاثة مخرجات. `send_by_user_id`، `wait_optimal_time`.
`POINT_TYPE_SEND_EMAIL`	`send_email`	`liquid_template_params`، `personalise`، `email_type`، `email_category` (انظر أدناه). انظر Email API.
`POINT_TYPE_SEND_SMS`	`send_sms`	انظر SMS.
`POINT_TYPE_SEND_WHATSAPP`	`send_whatsapp`	يضيف preset الرد السريع مخرجًا واحدًا لكل رد (المفتاح = قيمة الرد). انظر WhatsApp.
`POINT_TYPE_SEND_TELEGRAM`	`send_telegram`	قناة Telegram.
`POINT_TYPE_SEND_KAKAO`	`send_kakao`	انظر Kakao.
`POINT_TYPE_SEND_LINE`	`send_line`	انظر LINE API.
`POINT_TYPE_SEND_DATA`	`send_data`	رسالة بيانات صامتة (بدون واجهة مستخدم).
`POINT_TYPE_INAPP`	`inapp`	يستخدم `richmedia_code`، `expire_in_days`، `capping`.

الأنواع المشتركة

SegmentRepeat

الحقل	النوع	الوصف
`enabled`	bool	ما إذا كان الدخول المتكرر مفعلًا.
`frequency`	string	`daily`، `weekly`، `monthly`، أو `dates`.
`every`	uint32	كرر كل N فترة.
`dates`	string[]	تواريخ محددة، عندما يكون `frequency` هو `dates`.
`time`	`SegmentRepeatTime`	تكوين وقت اليوم.

كائنات الوقت

ExactTime: { "hour": 0–23, "minute": 0–59 }.
ExactDateTime: { "year", "month": 1–12, "day": 1–31, "hour": 0–23, "minute": 0–59 }.

BehaviorSplitter

الحقل	النوع	الوصف
`enabled`	bool	ما إذا كان سيتم انتظار تفاعل والتفرع بناءً عليه.
`interval`	uint64	عدد الثواني لانتظار التفاعل.

MultiEntry

يتحكم في عدد الجلسات النشطة التي يمكن أن يمتلكها المستخدم في الـ journey في نفس الوقت. يعكس التحكم في عدد الجلسات التي يمكن أن يمتلكها المستخدم في نفس الوقت في منشئ Customer Journey. يستخدم بواسطة نقطة دخول الحدث و wait_event.

الحقل	النوع	الوصف
`enabled`	bool	ما إذا كان يمكن للمستخدم أن يكون لديه جلسات نشطة متعددة في نفس الوقت. `false`: جلسة نشطة واحدة لكل مستخدم. `true`: جلسات نشطة متعددة لكل مستخدم.
`attribute_name`	string	اختياري. سمة Event التي تحدد نطاق كل جلسة. عند التعيين، يمكن للمستخدم أن يكون لديه جلسة نشطة واحدة لكل قيمة مميزة لهذه السمة (على سبيل المثال، واحدة لكل `order_id`). تشترك الأحداث التي لها نفس القيمة في جلسة واحدة. اتركه فارغًا لتحديد نطاق جميع إدخالات المستخدم معًا.

مواضيع ذات صلة

كائن Journey

الإنشاء والتحديث

Presets API