مرحباً بتكامل البونساي لنماذج جرافتي

كيف يمكنني تفعيل البرنامج المساعد؟

بعد شراء إضافة Hello Bonsai Integration for Gravity Forms، ستحتاج إلى تثبيت الإضافة على موقعك الإلكتروني على ووردبريس. دعنا نستعرض هذه العملية.

الخطوة الأولىالتثبيت

قم بتسجيل الدخول إلى موقع ووردبريس الخاص بك وانتقل إلى الإضافات → إضافة إضافة → رفع إضافة → قم بتثبيت ملف zip وقم بتفعيله.

الخطوة 2: قم بتسجيل الملحق

انتقل إلى النماذج ← الإعدادات ← مرحباً بونساي وانقر تفعيل الترخيص في قسم الترخيص. أدخل مفتاح الترخيص الخاص بك وقم بتفعيله.

الخطوة 3: قم بربط حسابك في Hello Bonsai

في حسابك على Hello Bonsai، انتقل إلى الإعدادات ← حسابي → التكاملات → واجهة برمجة تطبيقات البونساي (جديدة) وقم بإنشاء مفتاح API (يبدأ بـ bonsai_at_). في ووردبريس، قم بلصقه في قسم اتصال Hello Bonsai وانقر على حفظ الإعدادات - يتم التحقق من المفتاح مقابل Hello Bonsai وإضافة الحساب في خطوة واحدة.

الخطوة الرابعة: إنشاء موجز

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

تفاصيل الميزة

ما الذي يتم إنشاؤه في Hello Bonsai

يقوم كل موجز بتشغيل سلسلة من الخطوات تصل إلى أربع خطوات على كل عملية إرسال:

1. شركة (اختياري) - تتم مطابقته بواسطة المجال و/أو الاسم، أو يتم إنشاؤه عندما لا يوجد شيء مطابق.
2. اتصال (دائماً) – يتم العثور عليها من خلال البريد الإلكتروني المحدد وتحديثها، أو يتم إنشاؤها وربطها بالشركة.
3. اتفاق (اختياري) - تم فتحه في مرحلة خط الأنابيب التي اخترتها، وتم تعيينه وتقييمه وربطه بجهة الاتصال والشركة.
4. تعليق (اختياري) - تقديم الطلب المنشور على الصفقة الجديدة كدليل ورقي.

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

حقول الاتصال التي يرسمها

• الاسم (مطلوب) - يتم ربط حقول اسم Gravity Forms تلقائيًا (الاسم الأول + الاسم الأخير).
• بريد إلكتروني (مطلوب) - المفتاح الفريد الذي يطابق جهات الاتصال في Hello Bonsai.
• مسمى وظيفي
• رقم التليفون

هذه هي الحقول التي يقبلها تطبيق Hello Bonsai في بيانات الاتصال حاليًا. ومع توسع واجهة برمجة التطبيقات الخاصة بـ Hello Bonsai (حيث تُعدّ الحقول المخصصة من أولوياتها)، سيتطور هذا الملحق بالتوازي مع هذا التوسع.

إذا كان الاتصال موجودًا بالفعل, يمكنك اختيار السلوك لكل موجز: تحديث جهة الاتصال الحالية بالقيم المُرسلة (الوضع الافتراضي)، أو تركها دون تغيير. في كلتا الحالتين، يتم ربط الإرسال بجهة الاتصال الحالية - لا يتم إنشاء أي نسخة مكررة، ولا يؤدي حقل اختياري فارغ إلى الكتابة فوق البيانات الحقيقية في Hello Bonsai.

مطابقة الشركات

يتعامل تطبيق Hello Bonsai مع نطاقات المواقع الإلكترونية على أنها فريدة ضمن حسابك - إذ لا يمكن أن ينتمي النطاق إلا لشركة واحدة - مما يجعل مطابقة النطاقات موثوقة للغاية. يوفر لك قسم الشركة في كل موجز ثلاثة أوضاع للمطابقة:

• اسم النطاق، ثم اسم الشركة (افتراضي) - جرب النطاق أولاً، ثم ارجع إلى مطابقة الاسم التامة (غير الحساسة لحالة الأحرف).
• النطاق فقط
• اسم الشركة فقط

قم بتعيين حقل موقع الويب/النطاق، وسيقوم البرنامج المساعد بتوحيد أي شيء يكتبه الزوار – https://www.acme.com/contact يصبح acme.com قبل المطابقة. إذا لم يتم تعيين حقل النطاق، فسيتم استخدام نطاق جهة الاتصال. عنوان البريد الإلكتروني يتم استخدام هذه الميزة تلقائيًا، ويتم تجاهل مزودي خدمة البريد الإلكتروني المجانيين (مثل gmail.com وoutlook.com وyahoo.com وicloud.com وغيرها الكثير) حتى لا ينتهي بك الأمر أبدًا باستخدام خدمة بريد إلكتروني تابعة لشركة "Gmail". يمكن للمطورين تعديل قائمة مزودي الخدمة المجانيين باستخدام فلتر.

عندما لا شيء يتطابق, يمكنك اختيار ما يناسبك لكل موجز: إنشاء الشركة (الخيار الافتراضي) أو تخطيه. تُسمى الشركات التي تم إنشاؤها من حقل "اسم الشركة" المُحدد، أو من نطاقها في حال عدم إدخال اسم - وهو نفس الاصطلاح الذي يستخدمه تطبيق Hello Bonsai نفسه.

لا يؤدي مطابقة شركة موجودة إلى تعديلها. وعندما يقوم أحد جهات الاتصال الحالية بإرسال طلب إلى شركة لم يتم ربطه بها بعد، يقوم المكون الإضافي بإنشاء الرابط دون تغيير جهة الاتصال الرئيسية للشركة - وهو أمر يجعل واجهة برمجة تطبيقات Hello Bonsai الأمر صعبًا بشكل مدهش، ويتم التعامل معه نيابة عنك.

عروض

فعّل قسم الصفقات، وسيتمكن كل عميل محتمل من فتح صفقة على لوحة صفقات Hello Bonsai. يتطلب Hello Bonsai أن تنتمي كل صفقة إلى شركة، لذا يجب تفعيل قسم الشركة وحلّه - يوضح محرر البيانات ونتائج الإدخال ذلك بوضوح إذا لم يكن كذلك.

• عنوان الصفقة – يدعم علامات دمج نماذج Gravity Forms، على سبيل المثال. Website lead – {Name:1}. القيمة الافتراضية هي عنوان النموذج.
• قيمة الصفقة – قم بتعيين أي حقل نموذج يحتوي على مبلغ بالدولار. يتم قراءة حقول المنتج مع مراعاة العملة (السعر، وليس التسمية)، وتعمل حقول الأرقام بشكل رائع أيضًا.
• مرحلة خط الأنابيب – أداة اختيار مباشرة لمراحل لوحة الصفقات الفعلية الخاصة بك، يتم استخراجها من حسابك في Hello Bonsai. يتم افتراضياً اختيار المرحلة الأولى.
• تعيين إلى – غير مُعيّن، أو عضو في الحساب المتصل، أو أي عضو نشط في الفريق (يتم سحبه أيضًا بشكل مباشر).
• إبرام صفقة – على كل طلب، أو فقط عند كون جهة الاتصال جديدة. يمنع الخيار الثاني العملاء العائدين من تراكم الصفقات المكررة.

تعليقات الصفقة

فعّل خيار التعليق، وسيقوم الملحق بنشر المشاركة على الصفقة التي تم إنشاؤها حديثًا - القالب الافتراضي هو {form_title} ثم يتبع ذلك {all_fields}, ويمكنك تخصيصها باستخدام أي علامات دمج. أي شخص يستلم الصفقة في Hello Bonsai يرى الاستفسار كاملاً دون مغادرة لوحة الصفقات. (تعليقات Hello Bonsai عبارة عن نص عادي؛ حيث يقوم Hello Bonsai بإزالة التنسيق).

نتائج المشاركة وإعادة الإرسال

كل مشاركة تحصل على مرحباً بونساي مربع في صفحة التفاصيل يوضح بالضبط ما حدث:

• متزامن – تم إنجاز كل خطوة مطلوبة.
• متزامن جزئياً – جهة الاتصال آمنة في تطبيق Hello Bonsai، لكن هناك خطوة لاحقة (شركة، صفقة، أو تعليق) تتطلب اهتمامًا. توضح الرسالة بالتحديد أي خطوة ولماذا.
• فشلت عملية المزامنة – لم يكن بالإمكان كتابة أي شيء؛ فالرسالة تتضمن خطأً خاصاً بـ Hello Bonsai.

معرفات جهات الاتصال والشركات والصفقات التي تم إنشاؤها هي روابط قابلة للنقر مباشرة إلى حسابك في Hello Bonsai, ويظهر رقم تعريف طلب Hello Bonsai في أي محادثة دعم.

ال أعد الإرسال إلى Hello Bonsai يُعيد الزر محاولة المزامنة الفاشلة أو الجزئية بأمان: تتم إعادة مطابقة الشركات وجهات الاتصال بدلاً من تكرارها، ولا تتم إعادة إنشاء صفقة تم إنشاؤها مسبقًا، ولا يتم نشر تعليق تم نشره مسبقًا مرتين. كما أنه يعمل على الإدخالات التي سبقت تثبيت الإضافة - افتح أي إدخال قديم وانقر أرسل إلى Hello Bonsai لردمها.

علامات الدمج

{bonsai_contact_id} – معرف الاتصال الخاص بـ Hello Bonsai المرتبط بهذه المشاركة.

{bonsai_company_id} – معرف شركة Hello Bonsai المرتبط بهذا الإدخال.

{bonsai_deal_id} – تم فتح معرف صفقة Hello Bonsai لهذا الإدخال.

استخدمها في الإشعارات والتأكيدات وحمولات Webhook. تتم معالجة البيانات بشكل متزامن أثناء الإرسال، لذا تكون المعرّفات مُحدّدة مسبقًا عند إرسال Gravity Forms إشعارات نفس الإرسال - دون أي تضارب في البيانات. أما علامات السجلات التي لم يتم إنشاؤها (على سبيل المثال، عدم وجود اتفاق مع مُرسِل مُكرّر) فتظهر فارغة.

حسابات متعددة

يمكن للوكالات وفرق العلامات التجارية المتعددة ربط أكثر من حساب Hello Bonsai. يتم التحقق من كل حساب عند إضافته، ويُدرج في جدول "الحسابات المتصلة" مع إمكانية اختباره وإزالته، ويختار كل موجز الحساب الذي يُرسل إليه المحتوى - مع استخدام حساب افتراضي في حال عدم تحديد حساب في الموجز. تُخزّن بيانات الاعتماد على خادم قاعدة بيانات ووردبريس الخاصة بك، ولا تُعرض مرة أخرى على الصفحة بعد الحفظ.

إشعارات الأخطاء وإعادة المزامنة

إشعارات الأخطاء أضف عنوان بريد إلكتروني من خلال النماذج ← الإعدادات ← Hello Bonsai ← تقارير الأخطاء، وستتلقى رسالة بريد إلكتروني عند فشل المزامنة أو نجاحها جزئيًا. تتضمن الرسالة الإلكترونية موجز البيانات، ورسالة النتيجة، ومعرّف طلب Hello Bonsai، ورابطًا مباشرًا للإدخال لتتمكن من التحقق من المشكلة وإعادة إرسالها بنقرتين فقط.

إعادة مزامنة تعديل الإدخال – يُمكن إعادة تشغيل خلاصات النموذج عند تعديل أي إدخال في لوحة تحكم ووردبريس، بحيث يتم تحديث بيانات جهة الاتصال والشركة المرتبطة في Hello Bonsai. ولن يتم إنشاء الصفقات مرتين لنفس الإدخال، مهما تكررت عملية المزامنة.

الأسئلة الشائعة

من أين أحصل على مفتاح واجهة برمجة تطبيقات Hello Bonsai؟

في حسابك على Hello Bonsai ضمن الإعدادات ← واجهة برمجة التطبيقات, أنشئ مفتاح API - يبدأ بـ bonsai_at_. قم بلصقه في صفحة إعدادات الإضافة، وسيتم التحقق منه وحفظه بخطوة واحدة. أي حساب Hello Bonsai قادر على إنشاء مفتاح API هناك يعمل مع هذه الإضافة.

لماذا لم يتم إبرام صفقة بشأن طلبي؟

يتطلب تطبيق Hello Bonsai أن تنتمي كل صفقة إلى شركة، لذا يجب تفعيل قسم "الشركة" في موجز البيانات، ويجب أن يتطابق مع شركة أو أنشئ شركة جديدة. يوضح مربع Hello Bonsai في كل خطوة ما حدث بالضبط؛ فإذا تم تخطي الشركة أو تعذر إتمام الصفقة، ستُذكر رسالة الصفقة ذلك بوضوح.

ماذا يحدث عندما يقوم نفس الشخص بتقديم الطلب مرتين؟

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

هل يمكنني إعادة نشر الإدخالات التي تم إرسالها قبل تثبيت الإضافة؟

نعم. افتح أي مدخل وانقر أرسل إلى Hello Bonsai في مربع "مرحباً بونساي". يقوم بتشغيل خلاصات النموذج مقابل هذا الإدخال مع حماية كاملة من التكرار، لذا فإن إعادة التعبئة آمنة حتى لو كان بعض هؤلاء الأشخاص موجودين بالفعل في "مرحباً بونساي" الخاص بك.

هل يمكنني ربط الحقول المخصصة، أو إرسال ملفات للتحميل؟

ليس بعد - لا تدعم واجهة برمجة التطبيقات العامة لـ Hello Bonsai حاليًا الحقول المخصصة أو مرفقات الملفات أو روابط الويب. يُغطي الملحق جميع البيانات التي تقبلها واجهة برمجة التطبيقات اليوم، ومع توسيع Hello Bonsai لواجهة برمجة التطبيقات، سيتم توسيع هذا الملحق أيضًا. في هذه الأثناء، يُعد خيار التعليق على الصفقة طريقة رائعة لعرض الطلب كاملاً (جميع الحقول) على الشخص المسؤول عن العميل المحتمل.

هل يمكنني إرسال أنواع معينة فقط من المشاركات إلى Hello Bonsai؟

نعم - يدعم كل موجز منطق Gravity Forms الشرطي ("أرسل إلى Hello Bonsai إذا ...")، لذا يمكنك تقييد المزامنة على أي حقل: الميزانيات المؤهلة فقط، واختيارات خدمة معينة فقط، والرسائل غير المزعجة فقط، أيًا كان ما يناسب نموذجك.

ما هي البيانات التي تغادر موقعي؟

يتم إرسال القيم التي تحددها في موجز البيانات فقط (بالإضافة إلى نموذج التعليق، إن تم تفعيله) مباشرةً إلى واجهة برمجة التطبيقات الرسمية لـ Hello Bonsai عبر بروتوكول HTTPS. لا يتم إرسال أي شيء إلى أي طرف ثالث آخر، ولا يتم إرسال أي شيء على الإطلاق إلا إذا تم استيفاء شروط موجز البيانات.

هل يعمل مع التخزين المؤقت/شبكات توصيل المحتوى (CDN) وتحسين البرامج النصية؟

نعم، بدون أي إعدادات. تتم جميع عمليات المزامنة من جانب الخادم عند إرسال النموذج - لا توجد نصوص برمجية للواجهة الأمامية، لذلك لا يوجد شيء يجب استبعاده من التخزين المؤقت أو التصغير أو إضافات التأجيل.

هل يعمل مع نماذج Gravity Forms التي تدعم تقنية AJAX؟

نعم. إنه يعمل مع نماذج AJAX وإرسال نماذج Gravity Forms القياسية (غير AJAX).

ماذا يحدث إذا كان تطبيق Hello Bonsai بطيئًا أو غير متاح أثناء عملية الإرسال؟

زائر موقعك محمي: يعيد الملحق محاولة إرسال النموذج مؤقتًا في حال حدوث أعطال عابرة، لكنه يحدد مدة زمنية قصوى لإرسال النموذج (40 ثانية افتراضيًا، قابلة للتعديل عبر فلتر) بحيث لا يتسبب بطء واجهة برمجة التطبيقات في تعليق النموذج. يتم تسجيل أي عملية لم تكتمل بشكل صحيح في سجل البيانات على أنها فاشلة أو جزئية، وإذا كنت قد فعّلت خاصية إرسال إشعارات الأخطاء عبر البريد الإلكتروني، فستتلقى إشعارًا بذلك. بعد ذلك، بنقرة واحدة على "إعادة الإرسال"، يتم إنهاء العملية بمجرد أن يصبح Hello Bonsai جاهزًا للعمل.

هل يعمل مع شبكة ووردبريس متعددة المواقع؟

نعم. يربط كل موقع فرعي حسابه (أو حساباته) الخاص بـ Hello Bonsai ويُهيئ موجزاته الخاصة، ويؤدي إلغاء التثبيت إلى تنظيف الشبكة بأكملها. مع ترخيص غير محدود، يتيح لك وضع الشبكة إرسال مفتاح ترخيص واحد إلى كل موقع فرعي دفعة واحدة.

هل هو جاهز للترجمة؟

نعم، كل نص قابل للترجمة. يمكنك استخدام النسخة المجانية إضافة ترجمة لوكو لإنشاء ترجمة للغة/موقع موقعك. إذا لم يسبق لك استخدام Loco Translate من قبل، فإليك دليل تعليمي مناسب للمبتدئين.

خطافات

الفلاتر

pb_gfhellobonsai_contact_payload

قم بتصفية نص الاتصال قبل إرساله إلى Hello Bonsai - قم بتعديل الاسم أو البريد الإلكتروني أو المسمى الوظيفي أو رقم الهاتف عند إرساله.

حدود:

• $contact_body (مصفوفة) – حقول الاتصال ذات الشكل المحدد (الاسم، البريد الإلكتروني، المسمى الوظيفي، رقم الهاتف).
• $feed (مصفوفة) – تغذية أشكال الجاذبية.
• $entry (مصفوفة) – المدخل الحالي.
• $form (مصفوفة) – الشكل الحالي.

// Title-case every contact name on its way into Hello Bonsai.
add_filter( 'pb_gfhellobonsai_contact_payload', function( $contact_body, $feed, $entry, $form ) {
    if ( isset( $contact_body['name'] ) ) {
        $contact_body['name'] = ucwords( strtolower( $contact_body['name'] ) );
    }
    return $contact_body;
}, 10, 4 );

pb_gfhellobonsai_company_payload

قم بتصفية بيانات الشركة قبل إنشائها – قم بتعديل الاسم أو النطاقات.

حدود:

• $body (مصفوفة) – حقول الشركة (الاسم، النطاقات).
• $feed (مصفوفة) – تغذية أشكال الجاذبية.
• $entry (مصفوفة) – المدخل الحالي.
• $form (مصفوفة) – الشكل الحالي.

// Prefix companies created from forms so they're easy to spot in Hello Bonsai.
add_filter( 'pb_gfhellobonsai_company_payload', function( $body, $feed, $entry, $form ) {
    $body['name'] = 'Lead: ' . $body['name'];
    return $body;
}, 10, 4 );

pb_gfhellobonsai_deal_payload

قم بتصفية نص الصفقة قبل إرسالها - اضبط العنوان أو القيمة أو المرحلة أو المُسند إليه برمجيًا.

حدود:

• $deal (مصفوفة) – حقول الصفقة (العنوان، معرف الشركة، معرف جهة الاتصال، معرف مجموعة المجلس، معرف عضو مجلس الإدارة، قيمة الصفقة).
• $feed (مصفوفة) – تغذية أشكال الجاذبية.
• $entry (مصفوفة) – المدخل الحالي.
• $form (مصفوفة) – الشكل الحالي.

// Route big-budget leads into a different pipeline stage.
add_filter( 'pb_gfhellobonsai_deal_payload', function( $deal, $feed, $entry, $form ) {
    if ( isset( $deal['deal_value'] ) && (float) $deal['deal_value'] >= 10000 ) {
        $deal['board_group_id'] = 'your-priority-stage-uuid';
    }
    return $deal;
}, 10, 4 );

pb_gfhellobonsai_free_email_domains

قم بتصفية قائمة نطاقات البريد الإلكتروني المجانية المستبعدة من مطابقة الشركات القائمة على البريد الإلكتروني (gmail.com و outlook.com و yahoo.com و icloud.com وعشرات النطاقات الأخرى افتراضيًا).

حدود:

• $free_domains (مصفوفة) – النطاقات التي تحتوي على أحرف صغيرة والتي سيتم استبعادها.

// Also treat a local ISP's addresses as personal email.
add_filter( 'pb_gfhellobonsai_free_email_domains', function( $free_domains ) {
    $free_domains[] = 'myisp.example';
    return $free_domains;
} );

pb_gfhellobonsai_record_url

قم بتصفية عنوان URL لتطبيق Hello Bonsai المستخدم لرابط السجل المتزامن في مربع الإدخال. أعد سلسلة نصية فارغة لعرض معرّف عادي بدون رابط.

حدود:

• $url (خيط) – عنوان URL الافتراضي للتطبيق الخاص بالسجل.
• $type (خيط) – أحد عناصر الاتصال، أو الشركة، أو الصفقة.
• $id (عدد صحيح) – رقم تعريف سجل Hello Bonsai.

pb_gfhellobonsai_run_time_budget

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

حدود:

• $seconds (يطفو) – الميزانية بالثواني. القيمة الافتراضية 40.

// Tighten the budget on high-traffic sites.
add_filter( 'pb_gfhellobonsai_run_time_budget', function( $seconds ) {
    return 20.0;
} );

pb_gfhellobonsai_runtime_allowed

تجاوز بوابة ترخيص معالجة البيانات. مفيد بشكل أساسي في بيئات الاختبار والتطوير.

حدود:

• $allowed (بول) – ما إذا كانت معالجة الأعلاف مسموح بها حاليًا بموجب الترخيص.

pb_gfhellobonsai_api_base_url

قم بتجاوز عنوان URL الأساسي لواجهة برمجة تطبيقات Hello Bonsai. هذا مفيد فقط للتطوير والاختبار باستخدام واجهة برمجة تطبيقات وهمية - لن تحتاج إلى هذا في بيئة الإنتاج.

حدود:

• $url (خيط) – عنوان URL الأساسي لواجهة برمجة التطبيقات. افتراضي https://app.hellobonsai.com/public-api/v1.