# ويبهوكس

goodcryptoX يتيح لك أتمتة إجراءات التداول عبر webhooks من TradingView — آلية قوية لتشغيل الأوامر وإجراءات البوت مباشرة من إشاراتك.

على عكس بعض التنفيذات التي تعامل webhooks كواجهة برمجة قابلة للبرمجة (حيث ترسل أوامر مُعلمة مثل "اشترِ 3 BTC"), يدعم goodcryptoX حاليًا نموذجًا قائمًا على المشغلات. كل webhook يقوم ببساطة بتنشيط إجراء محدد مسبقًا في طلب أو بوت معين — لا يتم تفسير أي معلمات أو أوامر.

> في المستقبل القريب، سنطلق [بوت استراتيجية TradingView](https://docs.goodcrypto.app/goodcryptox-ar/bwrsat-perp-dexs/alwzaef-alqadmh/rwbwt-astratyjyh-tradingview) الذي يدعم تعليمات استراتيجية كاملة عبر webhooks، بما في ذلك اختيار الرموز الديناميكي، والكميات، وأنواع الأوامر، ومنطق متعدد الرموز — يعمل فعليًا كطبقة API. ترقبوا

### الأمن والوصول

* يتم قبول webhooks فقط من خوادم TradingView في الوقت الحالي — لا توجد عناوين IP مخصصة أو مصادر خارجية.
* إذا كنت بحاجة لاستخدام مصدر webhook مخصص، اتصل بنا على <support@goodcrypto.app> لطلب الوصول.
* تتوفر webhooks فقط للمستخدمين الذين لديهم خطة PRO [أو](https://docs.goodcrypto.app/goodcryptox-ar/alnzam-albyey/khtt-alashtrak) أعلى.

### كيف تعمل webhooks في goodcryptoX

* كل طلب أو بوت **إجراء** له عنوان URL خاص بالـ webhook مخصص
* يجب عليك إنشاء الطلب أو البوت أولاً للحصول على عنوان URL (ستظهر في **Webhooks** قسم **تفاصيل**)
* إرسال **أي** حمولة webhook إلى ذلك العنوان ستؤدي إلى تشغيل الإجراء

> عناوين URL الخاصة بالـ Webhook مخصصة للإجراء، وليس للمستخدم. يجب عليك إنشاء webhook واحد لكل إجراء، على سبيل المثال واحد للدخول، واحد لجني الأرباح، واحد لإيقاف الخسارة، إلخ. لكل بوت أو طلب

### الأوامر وإجراءات البوت المدعومة

إذا كنت تريد أن يتم **تنشيط طلبك أو بوتك بواسطة webhook**، يجب عليك اختيار webhook كـ **شرط التشغيل أثناء الإعداد**. هذا ينطبق على:

* أوامر إيقاف السوق / إيقاف الحد يتم تشغيلها
* تنشيط أوامر التتبع (بدء التتبع)
* تنشيطات جني الأرباح وإيقاف الخسارة&#x20;
* شرط دخول بوت DCA

<figure><img src="https://1503371023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1503371023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

بعد الإنشاء، ستجد جميع عناوين URL الخاصة بالـ webhook المتاحة في **تفاصيل** تفاصيل طلبك أو بوتك:

<figure><img src="https://1503371023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1503371023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" alt="" width="563"><figcaption></figcaption></figure>

> **إلغاء** webhook — متاح دائمًا في جميع الطلبات والبوتات
>
> **إغلاق المركز** webhook — متاح دائمًا في تفاصيل بوت DCA

للخلاصة:

| الإجراء                           | مدعوم؟ | ملاحظات                                                |
| --------------------------------- | ------ | ------------------------------------------------------ |
| إلغاء الطلب                       | ✅      | معروض دائمًا في التفاصيل                               |
| تفعيل أمر إيقاف                   | ✅      | يجب اختيار webhook أثناء الإعداد                       |
| تنشيط أمر تتبعي                   | ✅      | بدء التتبع = webhook                                   |
| تشغيل جني الأرباح / إيقاف الخسارة | ✅      | اختياريًا يتم تشغيله بواسطة webhook                    |
| بوت DCA - الدخول                  | ✅      | الدخول شراء/بيع عبر webhook (يجب تعيينه أثناء الإعداد) |
| بوت DCA - الخروج                  | ✅      | إغلاق المركز عبر webhook (متاح دائمًا)                 |
| بوت الشبكة - الدخول               | 🚫     | غير مدعوم بعد                                          |

{% hint style="info" %}
**أهداف جني أرباح متعددة عبر webhooks**

إذا قمت بإعداد مجموعة جني أرباح باستخدام webhook كطريقة تشغيل، فستشارك جميعها نفس عنوان URL للـ webhook. في كل مرة يتم فيها تشغيل الـ webhook، سيتم تنفيذ هدف TP التالي في التسلسل — واحدًا تلو الآخر.
{% endhint %}

### كيفية إعداد التنبيهات في TradingView

بعد إنشاء طلبك أو البوت في goodcryptoX ونسخ عنوان URL للـ webhook لإجراء محدد، إليك كيفية ربطه بتنبيهات TradingView:

1. اذهب إلى الرسم البياني الخاص بك في TradingView
2. أنشئ تنبيهًا جديدًا بناءً على استراتيجيتك أو المؤشر أو الشرط
3. في **إعدادات التنبيه**، قم بتمكين خانة الاختيار **“Webhook URL”**
4. الصق عنوان URL المحدد للـ webhook من قسم Webhooks في goodcryptoX
5. اترك **حقل الرسالة** كما هو (أي محتوى مقبول — goodcryptoX يتجاهل الحمولة في الوقت الحالي)
6. احفظ التنبيه

### الاستراتيجيات المتكررة (عبر بوت DCA)

الأمر المشغل بواسطة webhook (مثل stop-market مع TP وSL) هو **إعداد لمرة واحدة**. بمجرد تنفيذ الأمر وإطلاق TP أو SL المرتبطين به، تكتمل الصفقة بأكملها. إذا أردت أن **يتكرر تلقائيًا**، فهذا غير ممكن مع الأوامر — لكنه قابل للتحقيق الآن باستخدام بوت DCA.

سنقوم قريبًا بتقديم [بوت استراتيجية TradingView](https://docs.goodcrypto.app/goodcryptox-ar/tdawl-cex/alwzaef-alqadmh/rwbwt-astratyjyh-tradingview) مخصص لدعم تداولات متعددة الإجراءات قابلة للتكرار، ولكن في هذه الأثناء، يوفر بوت DCA طريقة مرنة لتكرار استراتيجيتك القائمة على webhooks.

#### حلقة webhook فقط

لإعداد بوت يدخل موقفًا عبر webhook، يخرج عبر webhook، ثم يتكرر:

1. اضبط **شرط الدخول** = webhook
2. اضبط **أوامر المتوسط** = 0 (تعطيل المتوسط)
3. عطل كلاً من **جني**-**الأرباح** و **إيقاف الخسارة**
4. قم بتمكين **"التكرار عند إغلاق المركز"**&#x20;

<figure><img src="https://1503371023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

بمجرد إطلاق البوت، سترى عناوين URL التالية للـ webhook تحت **تفاصيل → Webhooks** القسم:

* **دخول شراء** — يفتح مركزًا طويلًا
* **دخول بيع** — يفتح مركزًا قصيرًا
* **إغلاق المركز** — يغلق المركز النشط (طويل أو قصير)
* **إلغاء** — يوقف البوت

**منطق التنفيذ**

* عندما يتلقى البوت **دخول شراء**، يفتح مركزًا طويلاً.
* عندما يتلقى **دخول بيع**، يفتح مركزًا قصيرًا.
* سيقوم البوت **بالاستجابة فقط لأول webhook دخول** يتلقاه بينما يكون في حالة خمول.
* أثناء فتح مركز:
  * أي إشارات دخول إضافية تكون **مهملة**
  * لن يزيد البوت أو يعكس المركز الحالي استنادًا إلى إشارات الدخول
  * الإشارات الوحيدة المقبولة هي **إغلاق المركز** أو TP/SL مُشغل (إذا تم تكوينه)
* بمجرد إغلاق المركز (يدويًا، بواسطة webhook، أو بواسطة SL/TP)، يعيد البوت ضبط حالته وينتظر webhook الدخول التالي.

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

#### وضع webhook الخالص مقابل الإعدادات المختلطة

يدعم بوت DCA عدة طبقات تحكم يمكن دمجها لبناء استراتيجيات مرنة:

* **الدخول**: عبر webhook أو إشارة أو فورًا
* **الخروج**: عبر webhook أو جني أرباح/إيقاف خسارة مدمج قائم على السعر
* **المتوسط**: اختياري؛ يمكن تعطيله

يمكنك:

* تشغيل بوت بالكامل عبر إشارات webhook (دخول وخروج)
* إضافة جني أرباح/إيقاف خسارة قائمين على السعر كخطط احتياطية، حتى لو كنت تستخدم إنهاءات عبر webhook
* إضافة أوامر متوسط للحماية الإضافية

هذا يجعل من الممكن تصميم:

* استراتيجيات حلقة مؤتمتة بالكامل (webhook الخالص)
* بوتات مدفوعة بالإشارات مع تحويلات فشل يدوية
* إعدادات هجينة مع مخارج متعددة الطبقات

### أمثلة عملية على استراتيجيات webhook

#### المثال 1: أمر لمرة واحدة + أهداف جني أرباح متعددة (ارتداد نطاق بولينجر)

**الهدف:** الشراء عندما يخترق السعر نطاق بولينجر السفلي، والبيع تدريجيًا مع ارتفاعه.

**الإعداد في goodcryptoX**

* أنشئ أمر stop-market مع شرط تشغيل = webhook
* أضف ثلاث أهداف جني أرباح. مشغل TP = webhook

<figure><img src="https://1503371023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**الإعداد في TradingView**

أنشئ أربعة تنبيهات:

1. السعر يخترق النطاق السفلي → أرسِل إلى **مشغل** عنوان URL للـ webhook الخاص بالطلب الرئيسي
2. السعر يعود داخل النطاق → أرسِل إلى **مشغل جني الأرباح** عنوان URL للـ webhook الخاص بالطلب الرئيسي
3. السعر يعبر الشريط الوسطي → أرسِل إلى **مشغل جني الأرباح** عنوان URL للـ webhook الخاص بالطلب الرئيسي
4. السعر يخترق النطاق العلوي → أرسِل إلى **مشغل جني الأرباح** عنوان URL للـ webhook الخاص بالطلب الرئيسي

<figure><img src="https://1503371023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

في **إعدادات التنبيه**، قم بتمكين خانة الاختيار **“Webhook URL”**

الصق عنوان URL المحدد للـ webhook من قسم Webhooks في goodcryptoX. اترك حقل الرسالة كما هو — لا يُستخدم.

#### المثال 2: استراتيجية متكررة باستخدام بوت DCA (التقاطع الذهبي/الموت)

**الهدف:** ادخل شراء عند التقاطع الذهبي، ادخل بيع عند تقاطع الموت. اخرج بربح 10% أو عندما يكون RSI > 70 وكرر إلى الأبد.

**الإعداد في goodcryptoX**

أنشئ بوت DCA

* شرط الدخول = webhook
* المتوسط = إيقاف (اضبط على 0)
* جني الأرباح = 10%
* إيقاف الخسارة = إيقاف
* قم بتمكين: "التكرار عند TP"

**الإعداد في TradingView**

* أنشئ ثلاثة تنبيهات على نفس الرسم:
  1. SMA50 يتقاطع فوق SMA200 → أرسِل إلى **دخول شراء** webhook
  2. SMA50 يتقاطع تحت SMA200 → أرسِل إلى **دخول بيع** webhook
  3. RSI > 70 → أرسِل إلى **إغلاق المركز** webhook

{% hint style="info" %}
يحتفظ بوت DCA بمركز واحد فقط في كل مرة. أثناء تواجد المركز، يتجاهل webhooks الدخول الجديدة حتى يتم إغلاق المركز.

إذا أردت أن تكون قادرًا على دخول مراكز شراء وبيع على نفس الأداة بشكل متوازي - أنشئ بوتين منفصلين وأرسل Enter Buy إلى أحدهما وEnter Sell إلى الآخر
{% endhint %}

### الملخص

| المفهوم               | الوصف                                                             |
| --------------------- | ----------------------------------------------------------------- |
| نموذج التشغيل         | كل إجراء له عنوان URL خاص به للـ webhook                          |
| تدفق الإعداد          | إنشاء طلب → نسخ عنوان URL للـ webhook → لصقه في تنبيه TradingView |
| الاستراتيجية المتكررة | استخدم بوت DCA مع تمكين التكرار                                   |
| الوصول                | يتطلب خطة PRO أو أعلى                                             |

### دروس فيديو

#### **مقدمة لتداول webhooks**

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **استخدام بوت DCA مع webhooks**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **أهداف جني أرباح متعددة عبر webhooks**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}