> ## Documentation Index
> Fetch the complete documentation index at: https://www.mellowtel.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# القبول / الرفض

> المستخدمين لازم يوافقو بشكل صريح قبل ما يتشارك أي عرض نطاق، ويقدرو يسحبو الموافقة في أي وقت

## واش هو

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

## علاش يهم

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

## كيفاش يخدم

في التثبيت الأول (وأي تحديث جديد يضيف Mellowtel) لازم توري المستخدم إشعار غير قابل للإغلاق يشرح واش يدير Mellowtel، ومن بعد تسجل اختيارهم. من بعد، لازم يكون رابط الإعدادات متاح من مكان واضح في واجهة المستخدم تاعك باش يقدرو يغيرو رأيهم.

<Frame caption="مثال على الإشعار">
  <img src="https://mintcdn.com/mellowtel/-NaMUO-H7VMwBlS7/images/mellowtel_disclaimer.png?fit=max&auto=format&n=-NaMUO-H7VMwBlS7&q=85&s=ab77574d21e0e4879d5f55977eab0223" alt="مثال على الإشعار" width="1058" height="898" data-path="images/mellowtel_disclaimer.png" />
</Frame>

عندك زوج خيارات للتنفيذ:

1. **موصى به:** افتح صفحة القبول المسبقة البناء تاع Mellowtel باستعمال `generateAndOpenOptInLink()`. نداء واحد للطريقة، متوافق تمامًا، يزيد من تحويل القبول.
2. **واجهة مستخدم مخصصة:** ابني واجهة الموافقة الخاصة بيك واستعمل `optIn()` / `optOut()` بنفسك.

## واجهة API

| الطريقة                      | يرجع               | استعملها باش                                                               |
| ---------------------------- | ------------------ | -------------------------------------------------------------------------- |
| `generateAndOpenOptInLink()` | `Promise<void>`    | افتح صفحة القبول المستضافة (الطريق الموصى به).                             |
| `getOptInStatus()`           | `Promise<boolean>` | تحقق إذا كان المستخدم وافق بالفعل.                                         |
| `optIn()`                    | `Promise<void>`    | سجل الموافقة من واجهة المستخدم الخاصة بيك.                                 |
| `optOut()`                   | `Promise<void>`    | اسحب الموافقة من واجهة المستخدم الخاصة بيك.                                |
| `start()`                    | `Promise<void>`    | ابدأ في تقديم الطلبات بعد القبول.                                          |
| `generateSettingsLink()`     | `Promise<string>`  | رابط لصفحة الإعدادات المستضافة باش المستخدمين يقدرو يغيرو اختيارهم لاحقًا. |

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

## التنفيذ الموصى به

الدليل الكامل للتكامل موجود في بدايات المنصة السريعة. يوريوك وين تحط الSDK، كيفاش تربطو بدورة التثبيت/التحديث، وكيفاش تجربو:

* [بداية سريعة لملحقات المتصفح](/browser-plugins/quickstart)
* [بداية سريعة لتطبيقات سطح المكتب](/desktop-app/quickstart)
* [بداية سريعة للمواقع](/website/quickstart)
* [بداية سريعة لتطبيقات الهاتف](/mobile-app/quickstart)

باختصار، بعد `new Mellowtel(...)` و `initBackground()`, نادى `generateAndOpenOptInLink()` من معالج التثبيت/التحديث تاعك. هذا هو كل شيء.

## واجهة مستخدم مخصصة

إذا حبيت تحكم كامل في واجهة الموافقة، سجل اختيار المستخدم في واجهة المستخدم الخاصة بيك ومررو للSDK:

```javascript theme={null}
// المستخدم وافق
await mellowtel.optIn();
await mellowtel.start();

// المستخدم رفض أو سحب الموافقة لاحقًا
await mellowtel.optOut();

// تحقق من الحالة (مثلاً لعرض تبديل)
const hasOptedIn = await mellowtel.getOptInStatus();
```

أي واجهة مستخدم تبنيها لازم:

1. تكون غير قابلة للإغلاق في التثبيت الأول.
2. تكون الافتراضية مرفوضة حتى يوافق المستخدم بنشاط.
3. تكون قابلة لإعادة الفتح من مكان واضح في المنتج تاعك باش المستخدمين يقدرو يغيرو اختيارهم.

## رابط الإعدادات

المستخدمين لازم دايمًا يكون عندهم طريقة سهلة باش يغيرو إعداداتهم. استعمل `generateSettingsLink()` باش تحصل على رابط لصفحة الإعدادات المستضافة وحطو في مكان دائم: النافذة المنبثقة تاعك، صفحة الخيارات، شاشة الحساب.

```javascript theme={null}
const settingsUrl = await mellowtel.generateSettingsLink();
```

## الإعلان عن Mellowtel للمستخدمين الحاليين

إذا كنت تضيف Mellowtel لامتداد عندو بالفعل مستخدمين، لازم تخبرهم واش تغير قبل ما تطلب الموافقة. نوفر لك [قالب إعلان جاهز للنسخ واللصق](/concepts/update-announcement) تقدر تعدلو.

## ذات صلة

* [الخصوصية](/concepts/privacy): واش يوافقو المستخدمين على مشاركتو بالفعل.
* [تحديد المعدل](/concepts/rate-limiting): كيفاش يحمي الSDK المستخدمين اللي يوافقو.