في هذه الصفحة
أرسل جهة الاتصال التجريبية نفسها مرتين. إذا أنشأ التشغيل الثاني سجلًا آخر أو أعاد الاشتراك بعد إلغائه، فالموصل فشل قبل الوصول إلى حجم كبير.
«نحتاج فقط إلى ربط التطبيقين» بداية معقولة. ما ينقصها هو معرفة ما يتذكره الاتصال بعد الطلب الأول.
تحقق من ثلاثة أمور قبل اختيار البرنامج
النقل يوصل الطلب أو الحدث. الربط يحدد معنى الحقول. الحالة تحفظ نسخة المصدر التي عولجت، وما فشل، وأي سجل في Brevo يخصها.
اكتب مصدرًا واحدًا ووجهة واحدة والحقول اللازمة لأول نتيجة مفيدة. عيّن مالكًا لكل حقل. قد يملك نظام المبيعات مرحلة العميل، بينما يملك Brevo حالة إلغاء البريد الحالية. لا يلزم أن يملك نظام واحد كل شيء في السجل.
أربعة مسارات إلى Brevo
تطبيق أصلي
ابحث في متجر Brevo عن تطبيق تتم صيانته وعن ناشره. اقرأ تعليمات إعداد الحقول والأحداث التي تحتاجها فعلًا. مجرد الظهور في المتجر لا يثبت وجود تكامل مع Tajo.
مع Shopify، ابدأ بمسار إعداد Brevo PushOwl ونقله الموثق. اختبر ربط الحقول قبل بناء اتصال ثان. الحقول المدعومة وضوابط التعافي تخص ذلك التطبيق بعينه.
خدمة أتمتة
يمكنها استقبال نموذج، وربط حقول، واستدعاء Brevo. افحص أدوات الإعادة الحقيقية، وكلفة المهام والتخزين. قلة الحجم ومحرر بصري لا يجعلان ضياع مشترك مقبولًا.
للتسجيل عبر موقع، يميز دليل Webflow بين نموذج Brevo المضمن ونموذج أصلي يعالجه الخادم. اختر ما يحافظ على التسليم والتأكيد المطلوبين.
طبقة تكامل
استخدم طبقة مخصصة حين تبرر خرائط متعددة، أو سجل معالجة دائم، أو تعافٍ منسق خدمة إضافية. اطلب عرض السجل الفاشل وإعادة تشغيل سجل مرفوض. لا تستنتج هذه الميزات من اسم الفئة.
Tajo في مرحلة الوصول المبكر. أحضر مصدرًا ووجهة وفحص قبول محددًا إلى مراجعة تكامل. تحقق من الموصل المتاح ومسار التنفيذ قبل الاعتماد عليه. توثيق اقتران نظامين بداية للمراجعة وليس دليلًا على جاهزيته في مساحة عملك.
شيفرة API مباشرة
اختر الشيفرة إذا احتجت تحكمًا في الهوية أو التحويل أو التعافي لا توفره الطرق الأخرى. حينها تدير بنفسك المفاتيح والحدود والحالة المحفوظة وخطوات التعامل مع العطل.
يعرض دليل Brevo API كتابة جهة اتصال وحدود الفشل. إذا كان المصدر جدولًا، فـمثال Apps Script مسار مستقل لا يحتاج موصل Tajo أصليًا لـ Sheets.
استخدم إطار القرار
| القرار | تطبيق أصلي | خدمة أتمتة | طبقة تكامل | API مباشر |
|---|---|---|---|---|
| الحقول | تحقق من الخريطة | تحقق من المدخلات | راجع الخريطة | نفذ الخريطة |
| الهوية | تحقق من المطابقة | اضبط المطابقة | راجع قواعد الهوية | احفظ معرّف الوجهة |
| التعافي | افحص أدوات التطبيق | تحقق من الإعادة | اعرض تعافي سجل | ابنِه وشغّله |
| الحجم والحدود | أكد حدود المزود | احسب المهام | افحص الحمل | احترم حدود الوجهة |
| المسؤول | الناشر والمشغل | مالك السيناريو | المزود ومالك المزامنة | فريقك |
أي مسار يغطي حاجتك الفعلية؟
-
التطبيق الأصلي يغطي الحقول والفحوص
استخدم التطبيق
ابدأ بالإعداد الموثق.
-
نموذج أو حدث يحتاج إجراءً صغيرًا
قيّم خدمة أتمتة
تحقق من التأكيد وإعادة التشغيل.
-
عدة خرائط تحتاج تعافيًا منسقًا
قيّم طبقة تكامل
اطلب عرض فشل سجل وإعادته.
-
التحويل المطلوب غير متاح
اكتب أصغر مسار API
احسب تكلفة التشغيل بعد أول طلب.
أثبت أول مزامنة بسجل واحد
استخدم وجهة معزولة وجهة اتصال تحت سيطرتك. عطّل الحملات التلقائية أثناء فحص مسار البيانات.
- سجل معرّف المصدر والقائمة المستهدفة والسمات المطلوبة ودليل الموافقة. أنشئ أنواع السمات قبل الكتابة.
- شغل مرة واحدة وافحص السجل في الوجهة، لا حالة المهمة فقط. تحقق من القيم وأهلية التسويق بشكل منفصل.
- أعد تشغيل نسخة المصدر نفسها. توقع هوية واحدة، دون تكرار رسالة تأكيد أو ترحيب.
- غيّر حقلًا عاديًا وزامن من جديد. ثم اترك حقلًا فارغًا وتحقق من قاعدة حفظه أو مسحه.
- سجل إلغاء اشتراك لاحقًا. أعد التسجيل القديم وتأكد أن الإلغاء ما زال نافذًا.
- حاكِ طلبًا مرفوضًا. احتفظ بهويته ونتيجته، وأعد ذلك السجل وافحصه قبل تقديم مؤشر المعالجة.
هذه خطوات قبول، لا ادعاء بأن كل موصل يملك الأدوات نفسها. إذا لم تستطع إثبات فحص ضروري، فهذه الفجوة التي يجب حلها.
لا تدع إعادة المحاولة تغير المعنى
تقبل نقطة جهات الاتصال في Brevo ext_id وتدعم updateEnabled. تبقى المطابقة مسؤوليتك. تعارض المعرّفات يحتاج مراجعة؛ فقد يحذف forceMerge سجلًا ولا يصح جعله طريقة التعافي الافتراضية.
تكرار كتابة البيانات غير تكرار الآثار الجانبية. قد يوجد سجل واحد لكنه يتلقى رسالتي تأكيد. احفظ معرّف التسليم ونتيجة كل أثر. انتهاء مهلة الطلب يترك النتيجة غير مؤكدة؛ افحص الوجهة قبل إعادة الإرسال.
اقرأ جدول حدود المعدل الحالي لكل نقطة ومستوى حساب. تختلف الحدود، وبعض المسارات لها حد بالساعة وآخر بالثانية. لا تعمم رقمًا واحدًا على كل العمليات.
تحتاج webhooks أيضًا إلى مسؤول
يخبرك الحدث بأن شيئًا تغير. لا يحسم ملكية الحقول المتنازع عليها، ولا يحافظ وحده على مزامنة ثنائية الاتجاه كاملة.
وثق التسليم بالطريقة التي يدعمها المزود، واحفظ العمل الصالح، وطابق التغييرات التي فاتتك. إذا عاد تحديث الموصل إليه، فقارن نسخة المصدر المسجلة والقيم المقصودة قبل الكتابة من جديد. لا تفترض أن كل مزود يعيد علامة أصل مخصصة.
للمشترك الجديد، اتبع دليل الاشتراك بتأكيد مزدوج قبل إدخال العنوان إلى جمهور تسويقي. نسخ العنوان نتيجة بيانات، أما العنوان المؤكد والمشترك حاليًا فنتيجة أخرى.
يكون الاتصال جاهزًا حين يمكن تفسير التشغيل الثاني بالوضوح نفسه الذي فسر به الأول.
الأسئلة المتكررة
ما هو موصل Brevo؟
ينقل البيانات بين Brevo ونظام آخر. قيّم وسيلة النقل وربط الحقول وحالة المعالجة المحفوظة، بما في ذلك الهوية والفشل والموافقة.
بأي تكامل مع Brevo أبدأ؟
ابدأ بتطبيق أصلي تتم صيانته إذا كان يغطي المهمة. استخدم خدمة أتمتة أو طبقة تكامل أو شيفرة API عند وجود شرط محدد للربط أو التعافي.
هل يعني ظهور تطبيق في متجر Brevo أن Tajo يدعم التكامل؟
لا. تحقق من الناشر وسير العمل المدعوم كل على حدة. الإدراج في المتجر والصفحة التوثيقية والموصل العامل في Tajo أدلة مختلفة.
كيف أتجنب جهات الاتصال المكررة؟
اختر معرّفًا ثابتًا من المصدر، واحفظ معرّف الوجهة بعد المطابقة، وحل تعارضات الهوية قبل الكتابة. لا تجعل forceMerge إعدادًا عاديًا لإعادة المحاولة.
ماذا أفعل عندما يعيد Brevo الرمز 429؟
انتظر وفق ترويسات الحد المناسبة، واحتفظ بالعمل الفاشل، وأعد المحاولة ضمن سياسة محدودة. تابع نتيجة كل سجل ولا تكرر التأثيرات غير المرتبطة.
هل يمكن مزامنة الموافقة في الاتجاهين؟
حدد مرجعًا واحدًا لكل قناة وغرض. لا يجب أن تلغي تسجيلًا قديمًا إلغاء اشتراك أحدث. يتطلب النقل ثنائي الاتجاه قواعد للتعارض ومنع الحلقات.