إدارة الاشتراك في النشرة الإخبارية وإلغاء الاشتراك باستخدام القائمة السوداء والبيضاء
عند تشغيل حملات البريد الإلكتروني أو مزامنة جهات الاتصال بين تطبيقك و ESP، تحتاج إلى قاعدة واضحة واحدة: من المسموح لهم بتلقي البريد ومن يجب استبعادهم. لا يعد موقع verify-email.app بديلاً عن رابط إلغاء الاشتراك الخاص بـ ESP أو الامتثال القانوني، ولكنه يوفر لك قواعد القائمة السوداء و القائمة البيضاء التي تظهر في كل استجابة التحقق كحقل واحد: block. يمكن أن يقرأ الكود الخاص بك block قبل الإرسال أو استيراد قائمة أو إنشاء حساب — دون نسخ منطق السماح/المنع في كل خدمة.
ما الذي تفعله القوائم
القائمة السوداء — إذا كان البريد الإلكتروني أو مجاله موجوداً في قائمتك السوداء، فإن API ترجع
block: true. استخدم هذا للأشخاص الذين اختاروا عدم الاشتراك، حالات الإساءة، أو المجالات التي لا ترغب في إرسال البريد إليها أبداً.القائمة البيضاء — عندما يكون وضع القائمة البيضاء مفعل، فإن العناوين (أو المجالات بأكملها) التي أضفتها إلى القائمة البيضاء فقط تحصل على
block: false. يحصل الجميع الآخرون علىblock: true. استخدم هذا للقوائم المغلقة — الشركاء، الدعوات، الإصدارات التجريبية الداخلية — وليس لنشرة إخبارية “يمكن لأي شخص الاشتراك فيها”.الترتيب — القائمة السوداء تفوز. إذا تم إدراج عنوان في القائمة السوداء، فإنه يبقى محظوراً حتى لو ظهر أيضاً في القائمة البيضاء.
مهم: استخدم block لاتخاذ قرار “هل يجب أن نرسل / هل يجب أن نزامن هذا الاتصال؟”. لا valid بمفرده يعبر عن سياسة إلغاء الاشتراك أو القائمة المغلقة.
إلغاء الاشتراك من حملاتك (القائمة السوداء)
عندما يلغى المستخدم الاشتراك في تطبيقك أو تعالج إشعار ESP، خذ عنوانه (أو المجال الذي تحظر فيه السياسة).
أضفه باستخدام
POST /v1/blacklistوجسم JSON{"value": "[email protected]"}(أو"example.com"لحظر كل العناوين في هذا المجال). استخدم الرأسX-API-Keyمع مفتاح API الخاص بك.قبل أن ترسل حملة أو تبث صفاً إلى أداة البريد الخاصة بك، تحقق من العنوان. إذا كان
blockصحيحاً، قم بتخطي هذا المستلم.
للسماح لهم مرة أخرى لاحقاً (مثلا إذا كانوا قد أعادوا الاشتراك وتأكدوا)، قم بإزالة القاعدة باستخدام DELETE /v1/[email protected].
الاشتراك في قائمة مغلقة أو قائمة الدعوة فقط (القائمة البيضاء)
قم بتفعيل وضع السماح الصارم فقط:
PUT /v1/whitelist/enabledمع الجسم{"enabled": true}.أضف كل عنوان أو نطاق معتمد:
POST /v1/whitelistمع{"value": "[email protected]"}أو{"value": "company.com"}.عند التحقق،
block: falseتعني أن العنوان مسموح به تحت قائمتك البيضاء؛ ستظل الأخرى محظورة حتى تضيفها.
عندما لا تحتاج إلى وضع السماح فقط (مثلا عند عودة التسجيلات العامة)، قم بتعيين enabled إلى false لكي تتوقف القائمة البيضاء عن تقييد الجميع الآخرين.
“اشتراك في النشرة الإخبارية” النموذجي بدون قائمة مغلقة
يخزن معظم المنتجات الموافقة في ESP ويحافظ على قائمة القمع هناك. في apply-email.app تقوم عادةً بإزالة العنوان من القائمة السوداء إذا كانوا قد ألغوا الاشتراك من قبل (DELETE في القائمة السوداء)، ثم تعتمد على ESP لحالة الاشتراك الفعلية. احتفظ بـ القائمة البيضاء للتدفقات حيث يمكن فقط تمرير البريد الإلكتروني الموافق عليه مسبقاً.
لوحة القيادة
يمكنك إدارة القواعد نفسها في لوحة القيادة وكذلك عبر API — راجع صفحات القائمة السوداء والقائمة البيضاء على verify-email.app للسياق وتفاصيل API.
الأسئلة المتكررة
ما هو الهدف من القائمة السوداء؟
تضمن القائمة السوداء عدم إرسال أي اتصالات إلى العناوين أو المجالات الموجودة في هذه القائمة. يتم استخدامها للأشخاص الذين اختاروا عدم الاشتراك، أو حالات الإساءة، أو المجالات التي لا ترغب في إرسال البريد إليها.
كيف تعمل القائمة البيضاء؟
يتم تفعيل القائمة البيضاء في وضع السماح الصارم، مما يسمح بالتواصل فقط مع العناوين أو المجالات المضافة إليها. يتم حظر الآخرين حتى يتم إضافتهم.
ماذا يحدث إذا كان العنوان موجودًا في كل من القائمة السوداء والبيضاء؟
القائمة السوداء تأخذ الأولوية. إذا كان العنوان في القائمة السوداء، فإنه يبقى محظوراً، حتى لو ظهر في القائمة البيضاء.