HubSpot: الحصول على خصائص جهة الاتصال

يقرأ قالب النقطة HubSpot: get contact properties الخصائص التي تسميها من جهة اتصال واحدة في HubSpot ويسلمها إلى بقية الرحلة: يمكن لرسالة طباعتها، ويمكن لمقسم التفرع بناءً عليها.

تتم مصادقة هذه النقطة باستخدام رمز التطبيق الخاص بها في HubSpot — فهي لا تستخدم أي تكامل HubSpot على مستوى الحساب تم تكوينه في مكان آخر في الإعدادات.

تكوين النقطة

1. اسحب HubSpot: get contact properties من قسم Integrations إلى لوحة العمل.
2. انقر نقرًا مزدوجًا على النقطة وأدخل Step Name.
3. في Private app token، أدخل رمز تطبيق HubSpot خاص مع نطاق crm.objects.contacts.read. يتم تخزينه مقنعًا، مثل رأس سري لـ webhook.

4. في Look the contact up by، أدخل الاسم الداخلي لخاصية HubSpot التي تحمل المعرف — email افتراضيًا، أو خاصية خاصة بك تحمل Pushwoosh User ID. يبحث HubSpot فقط عن جهة اتصال بواسطة خاصية يحتفظ بقيمها فريدة.

5. في Identifier value، أدخل القيمة للبحث عنها، على سبيل المثال {{device:user_id}} أو علامة للمسافر.

6. في Properties to read، أضف صفًا لكل اسم داخلي لخاصية HubSpot (على سبيل المثال firstname، lifecyclestage) — انظر حقول القائمة. احتفظ بقيمة واحدة على الأقل غير فارغة.

7. انقر على Save.

توصيل الفروع

بعد الحفظ، تظهر النقطة فرعين على لوحة العمل. قم بتوصيل خطوة تالية بكل منهما:

• Found: تطابق المعرف مع جهة اتصال HubSpot موجودة. على سبيل المثال، استمر مع تقسيم شرطي أو رسالة تستخدم الخصائص التي قرأتها.
• Not found: أجاب HubSpot بـ 404 (لا توجد جهة اتصال مطابقة). لا يتم إسقاط المسافر. لا تعيد النقطة المحاولة أو تنتظر فترة تهدئة للطلب الفاشل كما يفعل الطلب الفاشل الحقيقي. على سبيل المثال، أرسل مسارًا مختلفًا أو رسالة عامة.

Not found ليس طلبًا فاشلاً. الطلب الفاشل الحقيقي يسقط المسافر بدلاً من ذلك. انظر الأخطاء والطلبات الفاشلة.

الاستجابة

عند Found، يمكن للخطوات اللاحقة استخدام:

• كل خاصية طلبتها كـ hubspot_<property>. على سبيل المثال، يصبح firstname hubspot_firstname.
• معرف جهة الاتصال كـ hubspot_contact_id.

استخدمها بنفس طريقة سمة استجابة Webhook. على سبيل المثال، تفرع باستخدام تقسيم شرطي أو قم بتعيين علامة باستخدام تحديث ملف تعريف المستخدم.

عند Not found، لا تتوفر أي من هذه السمات.

سيناريو مثال: تخصيص رسالة بخطة جهة اتصال HubSpot

يريد فريق أن تذكر رسالة الدفع فئة خطة المسافر كما هي مخزنة في HubSpot، دون الاحتفاظ بنسخة منفصلة منها في علامات Pushwoosh.

1. أضف HubSpot: get contact properties عند النقطة في الرحلة حيث يجب قراءة الخطة. اترك Look the contact up by على email وقم بتعيين Identifier value إلى {{tag:Email}}. في Properties to read، أضف plan.
2. انقر على Save، ثم قم بتوصيل Found بخطوة Push تستخدم hubspot_plan في نصها، وقم بتوصيل Not found بخطوة ترسل رسالة دفع عامة بدلاً من ذلك.

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