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

# دليل إعداد أتمتة لوحة SMM

> انتقل من مفتاح الترخيص إلى تسليم طلبات SMM تلقائيًا ومباشرةً في متجر SellAuth الخاص بك.

يربط EchoAuth **متجر SellAuth** الخاص بك بـ **لوحة SMM** الخاصة بك. عندما يشتري مشترٍ منتجًا، يستدعي SellAuth رابط Dynamic Delivery الشخصي الخاص بك، ويقوم EchoAuth بوضع الطلب على لوحتك تلقائيًا.

يرشدك هذا الدليل خلال الإعداد الكامل، من شراء الترخيص حتى أول طلب يتم تسليمه.

> [!NOTE]
>
> **قبل أن تبدأ، جهّز ما يلي:**
>
> * متجر SellAuth يحتوي على المنتجات التي تريد أتمتتها
> * حساب في لوحة SMM مع إمكانية الوصول إلى API (رابط API + مفتاح API)
> * رابط Discord webhook لإشعارات الطلبات (اختياري لكنه موصى به)

## الإعداد

**1. اشترِ ترخيصًا**

اشترِ ترخيصًا من [متجر EchoAuth](https://shop.echoauth.dev/product/social-media-panel-automation). بعد إتمام الدفع تتلقى **مفتاح ترخيص**، احتفظ به للخطوة التالية.

> [!TIP]
>
> يتضمن كل ترخيص محدد مسبقًا **مهلة إضافية لمدة يومين** للإعداد، لذا يمنحك ترخيص الشهر الواحد 32 يومًا.

**2. أنشئ حسابك**

انتقل إلى صفحة **Register** واملأ اسم المستخدم والبريد الإلكتروني وكلمة المرور ومفتاح الترخيص الذي استلمته للتو، ثم انقر على **Register**.

![نموذج التسجيل مع اسم المستخدم والبريد الإلكتروني وكلمة المرور ومفتاح الترخيص](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/01-register.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=52572520427a7a2b9e8348ef48add0b8)

سجّل باستخدام مفتاح الترخيص من عملية الشراء.

بعد التسجيل مباشرةً، يقوم EchoAuth تلقائيًا بتجهيز معالج الطلبات المعزول الخاص بك (**الحاوية** الخاصة بك). قد يستغرق ذلك لحظة.

> [!NOTE]
>
> إذا ظهر إشعار **"provisioning failed"** فلا تقلق. أكمل خطوة الإعدادات أدناه، فالزر **Save & update** يعيد بناء حاويتك لك. تواصل مع الدعم إذا استمر الفشل.

**3. اتبع قائمة الإعداد**

تصل إلى صفحة **Overview**. تُظهر البطاقات في الأعلى تاريخ انتهاء ترخيصك وعدد معرّفات الخدمات لديك وحالة حاويتك.

وتحتها تسرد **Finish setting up** كل ما يزال ناقصًا قبل أن يمكن تسليم أي طلب. يرتبط كل عنصر مباشرةً بالصفحة التي تعالجه فيها، وتختفي القائمة بمجرد إكمال كل الخطوات.

![صفحة Overview مع بطاقات الإحصاءات وقائمة Finish setting up](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/03-overview-empty.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=f50d3a5c86faaaeed17b7bfe03efcf39)

حساب جديد: تعرض القائمة ما تبقى لإنجازه.

**4. املأ إعداداتك**

افتح تبويب **Settings**. وهو مقسم إلى أربعة أقسام. **اضبط معرّف متجر SellAuth أولًا**، فهو يوجّه الطلبات الواردة إلى حسابك ويصبح جزءًا من رابط التسليم الخاص بك (أحرف وأرقام وشرطات وشرطات سفلية فقط).

| القسم | الحقل | أين تجده |
| - | - | - |
| **SellAuth** | Shop ID | [dash.sellauth.com/api](https://dash.sellauth.com/api) |
| | API Key | [dash.sellauth.com/api](https://dash.sellauth.com/api) |
| | Webhook Secret | [dash.sellauth.com/shop#miscellaneous](https://dash.sellauth.com/shop#miscellaneous) |
| **لوحة SMM** | Panel API URL | نقطة نهاية API للوحتك، مثل `smmpanel.com/api/v2` |
| | Panel API Key | في قسم الحساب بلوحتك |
| **إشعارات Discord** (اختياري) | Webhook URL | المكان الذي تُرسل إليه إشعارات الطلبات وتحذيرات انتهاء الترخيص |
| | User ID | من يتم ذكره بـ @ عند تنبيهات انخفاض الرصيد |
| **الإعدادات الافتراضية** | Low balance alert threshold | المقترح \$10–20 |
| | Default quantity multiplier | يُستخدم لأي معرّف خدمة ليس له قاعدة خاصة في تبويب Config |

![صفحة الإعدادات مقسمة إلى SellAuth ولوحة SMM وإشعارات Discord والإعدادات الافتراضية](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/05-settings-filled.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=3412f84cc54a4fdd8636a475dcea7454)

الإعدادات بعد ملئها (الأسرار مخفية).

بمجرد أن تغيّر أي حقل، يظهر شريط في أسفل الصفحة. انقر على **Save & update**، فهو يحفظ إعداداتك **ويعيد** بناء حاويتك في خطوة واحدة، وتصبح التغييرات سارية فور انتهائه (قد يستغرق ما يصل إلى دقيقة). يعيد **Discard** الحقول إلى ما كان محفوظًا.

![شريط الحفظ مع الزرين Discard وSave & update](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/10-savebar.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=5fc7f305a9c9532c061b76b83876c63e)

يظهر شريط الحفظ كلما كانت لديك تغييرات غير محفوظة.

**5. اضبط خدماتك**

افتح تبويب **Config**. فهو يتحكم في كيفية تحويل الطلبات الواردة إلى طلبات على اللوحة. استخدم زر **Add** في كل قسم لتجهيز التغييرات، ويمكنك العمل في الأقسام الثلاثة ثم النقر على **Save & update** مرة واحدة في الشريط السفلي.

![صفحة Config تعرض قائمة معرّفات الخدمة المسموحة ومضاعفات الكمية وقواعد الروابط](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/06-config.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=9f2fda46fb0a1f94da3563485b449f30)

تبويب Config مع ثلاثة معرّفات خدمة وقاعدة كمية وقاعدتي رابط.

> [accordion] قائمة معرّفات الخدمة المسموحة (مطلوبة)
>
> أضف كل معرّف خدمة على اللوحة تبيعه (حتى 5,000). يُرفض أي طلب لمعرّف خدمة **غير** موجود في هذه القائمة. يمكنك إعطاء كل معرّف اسمًا اختياريًا (مثل "Instagram Followers HQ") لتسهيل البحث في القوائم الطويلة، والأسماء مجرد تسميات. استخدم مربع التصفية للعثور على معرّف في قائمة طويلة.

> [accordion] مضاعفات الكمية لكل خدمة
>
> بعض اللوحات تحتسب الكمية بوحدات مختلفة (مثلًا 1 وحدة = 1000 متابع). اضبط مضاعفًا لكل معرّف خدمة. أي خدمة بلا قاعدة تستخدم المضاعف الافتراضي من Settings.

> [accordion] قواعد الروابط لكل خدمة
>
> اختر كيف يتحول الحقل المخصص للمشتري إلى رابط:
>
> * **منصة** (Instagram وYouTube وTikTok وTwitch وX وKick وThreads): يُحوَّل اسم مستخدم المشتري تلقائيًا إلى رابط الملف الشخصي الصحيح.
> * **Use custom field as raw link**: يقدّم المشتري الرابط الكامل بنفسه.

> [!NOTE]
>
> إذا نجح الحفظ لكن فشل تحديث الحاوية، يبقى الشريط ظاهرًا مع الخطأ وزر **Retry update**.

**6. اربط منتجات SellAuth الخاصة بك**

بالعودة إلى **Overview**، تختفي قائمة الإعداد وترى الآن **Dynamic Delivery URL** واحدًا لكل معرّف خدمة. لكل منها هذا الشكل:

```text theme={null}
https://smm-delivery.echoauth.dev/<shopid>/deliver/<serviceid>
```

على سبيل المثال، يستخدم Shop ID `1234` الذي يبيع الخدمة `7866` الرابط `https://smm-delivery.echoauth.dev/1234/deliver/7866`.

![صفحة Overview تعرض روابط Dynamic Delivery مع أزرار Copy](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/07-overview-urls.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=647552e125a2e1175b2075214edde797)

اكتمل الإعداد: انسخ كل رابط إلى منتج SellAuth المطابق.

في لوحة تحكم SellAuth، افتح كل منتج (أو متغيّر)، وفعّل **Dynamic Delivery**، والصق الرابط المطابق باستخدام زر **Copy**.

> [!TIP]
>
> هذا كل شيء، أصبح متجرك مؤتمتًا الآن. أجرِ طلب اختبار للتأكد من وصوله إلى لوحتك.

## بعد الإعداد

### تتبّع طلباتك

تبويب **Orders** عرض للقراءة فقط لسجل طلباتك: معرّف الفاتورة، ومعرّف الخدمة، والكمية، والرابط، ومعرّف الطلب على اللوحة، والحالة، والتكلفة، والطابع الزمني.

![جدول الطلبات مع طلبين نموذجيين](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/08-orders.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=f6e3aef66edcfb79767210084810f39e)

تبويب Orders يعرض طلبًا قيد التنفيذ وآخر مكتملًا.

### جدّد ترخيصك

يعرض تبويب **License** الوقت المتبقي لك. للتجديد، أدخل مفتاح ترخيص جديدًا وانقر على **Renew License**.

![صفحة الترخيص مع الوقت المتبقي ونموذج التجديد](https://mintcdn.com/echoauth/il481LL4mRI5-fUU/images/setup/09-license.png?fit=max\&auto=format\&n=il481LL4mRI5-fUU\&q=85\&s=ea0a715680fda811b2873c3b2d248e66)

تبويب License: الوقت المتبقي ونموذج التجديد.

* يُضاف الوقت الجديد **فوق** تاريخ انتهائك الحالي، فلا يكلّفك التجديد المبكر أي وقت.
* تصلك رسالة تذكير على Discord **قبل 7 أيام من الانتهاء** (إلى رابط webhook المحدد في Settings).
* إذا انتهى ترخيصك تمامًا، يتم إيقاف الأتمتة. التجديد يعيد تفعيلها وتشغيلها تلقائيًا.

## هل ما زلت بحاجة إلى Rebuild؟

عادةً لا. إن **Save & update** في صفحتي Settings وConfig يعيد بناء حاويتك بالفعل. الزر **Rebuild now** في قسم **Container** بصفحة Overview مخصص فقط لإعادة تطبيق إعداداتك المحفوظة يدويًا، مثلًا إذا فشل التجهيز عند التسجيل أو أبلغ تحديث سابق عن خطأ.

## استكشاف الأخطاء وإصلاحها

> [accordion] روابط التسليم الخاصة بي لا تظهر في Overview
>
> أكمل قائمة **Finish setting up** في صفحة Overview. كحد أدنى، اضبط **SellAuth Shop ID** في Settings وأضف معرّف خدمة واحدًا في تبويب Config.

> [accordion] الطلبات مرفوضة
>
> تأكد من أن معرّف خدمة المنتج موجود في **قائمة معرّفات الخدمة المسموحة** وأنك نقرت على **Save & update** بعد إضافته.

> [accordion] أبلغ Save & update عن خطأ
>
> تم حفظ تغييراتك لكن تحديث الحاوية فشل. انقر على **Retry update** في الشريط أو استخدم **Rebuild now** في صفحة Overview. تواصل مع الدعم إذا استمر الفشل.

> [accordion] سجّلت قبل أن يوجد نطاق التسليم المشترك
>
> تستمر روابطك القديمة `<subdomain>.echoauth.online/hook{serviceid}` في العمل. استخدم روابط `smm-delivery.echoauth.dev` الجديدة لأي منتجات جديدة.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.