دليل إعداد بوت webhook من TradingView

لقد بنيت تنبيهاً على TradingView يُفعَّل بالضبط في اللحظة التي تريد فيها الدخول في صفقة. المشكلة أنّ التنبيه مجرد إشعار. فبحلول الوقت الذي تراه فيه وتضع الأمر، يكون السعر قد تحرّك، أو تكون نائماً وتفوتك الفرصة تماماً.

يسدّ بوت webhook من TradingView هذه الفجوة. فبدلاً من إشعارك أنت، يُشعِر التنبيهُ رابط webhook، وهو عنوان ويب خاص يخصّ بوتك. يستمع بوت الإشارة من Freya عند ذلك العنوان، وفي اللحظة التي يُفعَّل فيها تنبيهك يضع الصفقة على منصتك تلقائياً. يبقى منطق الرسم البياني لديك على TradingView، وتتولّى Freya التنفيذ.

يغطّي هذا الدليل المفاهيم، والإعداد خطوة بخطوة، ومعرفة الموثوقية والأمان وحلّ المشكلات التي تُبقي الاتصال يعمل عندما يكون ذلك مهماً.

كيف تعمل تنبيهات TradingView وروابط الـ webhook

يتكوّن المسار من ثلاثة أجزاء.

التنبيه شرط تحدّده على رسم بياني في TradingView: عبور السعر لمستوى ما، أو انقلاب مؤشر، أو تفعيل سكربت مخصّص. وحده يمكنه أن يظهر على الشاشة، أو يرسل لك بريداً إلكترونياً، أو يدفع إشعاراً إلى هاتفك، وكلها لا تزال تتطلّب منك أنت أن تتحرّك.

الـ webhook هو خيار الأتمتة. عند تفعيله، يرسل TradingView رسالة صغيرة عبر الإنترنت إلى رابط من اختيارك في اللحظة التي يُفعَّل فيها التنبيه. فكأنّ التنبيه يجري مكالمة هاتفية بدل أن يترك لك ملاحظة.

البوت هو الطرف المستقبِل. يوفّر بوت الإشارة من Freya رابط webhook خاصاً؛ وعندما تصل الرسالة، ينفّذ البوت الإجراء المُهيّأ له على حساب المنصة المتصل لديك.

السلسلة الكاملة:

1. يتحقّق شرط الرسم البياني لديك على TradingView
2. يُفعَّل التنبيه ويتّصل TradingView برابط webhook الخاص ببوتك
3. تتلقّى Freya الإشارة فيضع بوتك الأمر على منصتك
4. ثم يدير بوتك الصفقة وفق إعداداته

النموذج الذهني الأساسي: استراتيجيتك تعيش على TradingView؛ وFreya هي طبقة التنفيذ. فمنطق التوقيت بالكامل داخل تنبيهك.

ماذا يفعل مُشغِّل webhook في Freya

على Freya، يتولّى بوت الإشارة تنفيذ الـ webhook، وهو نوع البوت الموصوف في مسار إنشاء البوت بأنه "ينفّذ الصفقات بناءً على إشارات webhook". وعلى خلاف مُشغِّل قائم على مؤشر (RSI أو EMA وما إلى ذلك)، لا يملك مُشغِّل الـ webhook إطاراً زمنياً ولا شرطاً مُهيّأً داخل Freya، فقرار متى يُفعَّل يخصّ تنبيه TradingView الخاص بك بالكامل. أما مهمة Freya فهي ما يحدث بعد ذلك.

يوجد وضعان للـ webhook، ويستخدم البوت أحدهما لا كليهما، فلا يمكن الجمع بينهما:

• TradingView Webhook (وضع Custom Signal). يحصل بوتك على رابطين: رابط فتح webhook (Open) ورابط إغلاق webhook (Close). الرسالة إلى رابط الفتح تفتح صفقة باستخدام إعدادات الأوامر التي هيّأتها في Freya، أي مبلغ الصفقة وجني الأرباح وإيقاف الخسارة؛ والرسالة إلى رابط الإغلاق تغلقها.

• وضع Risk Ratio. يحصل بوتك على رابط واحد. رسالة التنبيه حمولة JSON صغيرة تحمل سعرَي جني الأرباح وإيقاف الخسارة؛ ويُنفَّذ الدخول بسعر السوق عند وصول الإشارة. وبدلاً من مبلغ الصفقة، تحدّد أنت مبلغ مخاطرة ثابتاً (مرتبطاً بإيقاف الخسارة، أو اختيارياً بجني الأرباح)، فتحسب Freya حجم الصفقة تلقائياً من المسافة بين الدخول وإيقاف الخسارة. لا يوجد رابط إغلاق لأنّ المخارج تدير نفسها: يُوضع جني الأرباح كأمر محدَّد (limit) بالسعر الدقيق من إشارتك، ويُنفَّذ إيقاف الخسارة كأمر سوق (market) عند تفعيله.

خطوة بخطوة: اربط TradingView ببوتك

الخطوة 1: أنشئ بوت إشارة

في مسار إنشاء البوت على Freya، اختر نوع بوت الإشارة، ثم اختر حساب منصتك وزوج التداول والاتجاه، تماماً كأيّ بوت آخر. يغطّي الشرح الكامل في كيفية إنشاء بوت إشارة على Freya Finance كل شاشة بالتفصيل.

الخطوة 2: اختر وضع الإشارة

اختر Custom Signal إذا أردت ضبط مبلغ الصفقة وجني الأرباح وإيقاف الخسارة داخل Freya وترك تنبيهاتك تقول ببساطة "افتح الآن" و"أغلق الآن". واختر Risk Ratio إذا كانت استراتيجيتك تنتج جني أرباح وإيقاف خسارة لكل صفقة وأردت حساب الحجم تلقائياً من مبلغ مخاطرة ثابت.

الخطوة 3: انسخ رابط (أو روابط) الـ webhook

في خطوة الاستراتيجية، تولّد Freya رابط (أو روابط) الـ webhook الخاص بك. استخدم زر النسخ، فحرف واحد ناقص يجعل الرابط بلا فائدة. يمكنك إعادة توليد أيّ رابط لاحقاً، وهو ما ينشئ رابطاً جديداً ويُبطل القديم فوراً.

الخطوة 4: أنشئ تنبيه TradingView

على رسمك البياني في TradingView، أنشئ تنبيهاً بالشرط الذي يمثّل دخولك. في إعدادات إشعارات التنبيه، فعّل خيار Webhook URL والصق رابط بوتك، أي رابط الفتح في وضع Custom Signal، أو الرابط الوحيد في وضع Risk Ratio. وللخروج المدفوع بالتنبيهات في وضع Custom Signal، أنشئ تنبيهاً ثانياً لشرط خروجك ووجّهه إلى رابط الإغلاق.

الخطوة 5: اضبط رسالة التنبيه

رسالة التنبيه هي الحمولة التي يسلّمها TradingView إلى بوتك. استخدم بالضبط الصيغة التي توفّرها شاشة إعداد بوتك، ففي وضع Risk Ratio تعرض Freya قالب JSON Body بزر نسخ بنقرة واحدة؛ وينبغي أن يرسل تنبيهك تلك البنية مع تعبئة قيم جني الأرباح وإيقاف الخسارة. لا ترتجل: إذا لم تطابق الرسالة ما يتوقّعه البوت، تُتجاهَل الإشارة بدل تخمينها.

الخطوة 6: اختبر قبل الانطلاق

لا تربط webhook وتنصرف أبداً. نفّذ رحلة كاملة واحدة على الأقل بمبلغ صغير:

1. اضبط شرط تنبيه تعلم أنه سيُفعَّل بسرعة (عبور السعر لمستوى على وشك أن يلامسه)
2. دعه يُفعَّل، ثم افحص سجل نشاط بوتك بحثاً عن حدث الإشارة الواردة
3. تأكّد من أنّ الصفقة فُتِحت على منصتك بالحجم الذي توقّعته
4. فعّل الإغلاق (إشارة رابط الإغلاق، أو جني الأرباح/إيقاف الخسارة في وضع Risk Ratio) وتأكّد من أنّ الصفقة أُغلقت فعلاً

بعد رحلة نظيفة فقط عليك أن تربط استراتيجيتك الحقيقية وحجمك الحقيقي.

مثال محلول: حساب الحجم في Risk Ratio

لنقل إنك ضبطت مخاطرة ثابتة قدرها $20 لكل صفقة، مرتبطة بإيقاف الخسارة. يُفعَّل تنبيه TradingView وBTC عند $100,000، حاملاً إيقاف خسارة عند $98,000 وجني أرباح عند $104,000 في رسالته.

• الدخول: بسعر السوق، نُفِّذ عند $100,000
• المسافة إلى إيقاف الخسارة: $2,000 لكل BTC (2%)
• حجم الصفقة: مخاطرة $20 ÷ $2,000 لكل BTC = 0.01 BTC (نحو $1,000 من الانكشاف)
• جني الأرباح: أمر محدَّد عند $104,000. إذا نُفِّذ، فالربح 0.01 × $4,000 = $40، أي عائد 2:1 مقابل الـ $20 المخاطَر بها
• إيقاف الخسارة: أمر سوق إذا تحقّق $98,000، أي نحو الـ $20 التي اخترتها، إضافةً إلى الرسوم، وربما قليلاً أكثر في تحرّك سريع لأنّ إيقاف الخسارة المُفعَّل يُنفَّذ بسعر السوق

سواء كان إيقافك على بعد 1% أو 5%، يبقى المبلغ المخاطَر به $20 لأنّ الحجم يتكيّف. وهذا الثبات هو الغاية كلها من وضع Risk Ratio.

الموثوقية: على ماذا تستطيع الاعتماد وما لا تستطيع

الأتمتة موثوقة بقدر أضعف حلقاتها، ومع بوتات الـ webhook تكون تلك الحلقة عادةً خارج Freya.

متطلبات خطة TradingView. إشعارات الـ webhook ليست مضمَّنة في كل خطط TradingView، كما تختلف حدود التنبيهات وانتهاء صلاحيتها بحسب الفئة. والتنبيه الذي لا يستطيع إرسال webhook يفشل بصمت من وجهة نظر البوت، فافحص خيارات التنبيه في خطتك قبل أن تبني إعدادك عليها.

التأخيرات والانقطاعات تحدث. يُوسِم متجر Freya الاستراتيجيات المدفوعة بـ webhook بتحذير إشارة خارجية: تُفعَّل الصفقات بإشارات من TradingView أو webhook، والتأخيرات أو الانقطاعات في المصدر واردة. إذا وقع عطل لدى TradingView، فلن يُفعَّل تنبيهك ولن يفعل البوت شيئاً، وهذا صحيح. تنفّذ Freya ما يصل؛ ولا يمكنها تنفيذ ما لا يصل أبداً.

إشارات الإغلاق الفائتة هي أخطر ما في الأمر. في وضع Custom Signal، إذا وصلت إشارة الفتح ولم تصل إشارة الإغلاق أبداً، تبقى الصفقة مفتوحة. وإيقاف الخسارة المُهيّأ في إعدادات أوامر بوتك هو شبكة أمان لا تعتمد على وصول webhook ثانٍ، ويستحق وجوده في معظم الإعدادات.

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

الأمان: رابط الـ webhook لديك سرّ

رابط الـ webhook هو مفتاح تشغيل بوتك. لا توجد كلمة مرور فوقه، فامتلاك الرابط هو بحدّ ذاته بيانات الاعتماد:

• لا تشارك رابط webhook أو تنشره أبداً، لا في لقطة شاشة لإعدادات التنبيه، ولا في تخطيط رسم بياني مشترك، ولا في رسالة محادثة تطلب فيها المساعدة. اطمِسه أو اقتصصه أولاً.
• الصقه فقط في أدوات تتحكّم فيها، مثل تنبيهات TradingView الخاصة بك.
• أعِد توليده فوراً إذا اشتبهت في انكشافه، فيتوقّف الرابط القديم عن العمل حالاً. ثم حدّث تنبيهاتك بالرابط الجديد.

حلّ المشكلات: التنبيه فُعِّل لكن لم تُنفَّذ أيّ صفقة

يكاد السبب دائماً أن يكون واحداً من قائمة قصيرة، فراجعها بالترتيب:

1. هل البوت يعمل؟ البوت المتوقّف أو المُوقَف يتجاهل الإشارات الواردة، وهذا أكثر الأسباب شيوعاً.
2. الرابط الصحيح في الخانة الصحيحة؟ تنبيه دخول موجَّه إلى رابط الإغلاق لن يفتح صفقة أبداً. تأكّد من الفتح مقابل الإغلاق، وتأكّد من أنّ الرابط لُصِق كاملاً.
3. هل أعدت التوليد مؤخراً؟ إعادة التوليد تُبطل الرابط القديم فوراً. فإذا كان تنبيهك لا يزال يحمل القديم، فرسائله لا تذهب إلى أيّ مكان.
4. هل تطابق صيغة الرسالة؟ خصوصاً في وضع Risk Ratio، يجب أن تطابق الرسالة بنية الـ JSON من شاشة إعداد بوتك. الرسالة المشوّهة تُتجاهَل.
5. هل تستطيع خطة TradingView إرسال webhook أصلاً؟ إن لم تستطع، فسيُفعَّل التنبيه بصرياً لكن لن تُرسَل أيّ رسالة. تحقّق أيضاً مما إذا كان التنبيه قد انتهت صلاحيته أو ضُبِط على "مرة واحدة فقط".
6. حدود المنصة الدنيا. إذا كان مبلغك المُهيّأ، أو حجم Risk Ratio المحسوب تلقائياً، أقلّ من الحد الأدنى لحجم أمر الزوج، فسترفض المنصة الأمر.

للمشكلات المتعلّقة بحالة البوت خارج نطاق الـ webhook، راجع لماذا لا يتداول بوتي؟

الأسئلة الشائعة

هل أحتاج إلى خطة TradingView مدفوعة لاستخدام بوتات الـ webhook؟

إذا كان TradingView هو مصدر إشارتك، فإنّ فئة الخطة تهمّ: إشعارات الـ webhook ليست جزءاً من كل خطة، وتنبيهات الفئة المجانية لها حدود وقواعد انتهاء صلاحية أشدّ. قبل أن تبني أتمتتك على التنبيهات، افتح مقارنة الخطط في TradingView وتأكّد من أنّ إشعارات الـ webhook مضمَّنة في خطتك، وتحقّق من مخصّص تنبيهاتك إذا كنت تشغّل عدة أزواج. ومع ذلك، لا يهتمّ جانب البوت بمن يرسل الرسالة. يستجيب بوت الإشارة من Freya لاستدعاءات webhook من أيّ مصدر، أي منصة رسوم بيانية أخرى، أو سكربتك الخاص، أو أيّ أداة قادرة على إرسال webhook. فخطة TradingView المدفوعة متطلَّب لميزة webhook في TradingView، لا في Freya. وإذا كانت خطتك لا تتضمّن webhook، فبدائلك هي الترقية، أو تغيير مصادر الإشارة، أو بناء المنطق داخل Freya بمُشغِّلات قائمة على مؤشرات بدل الإشارات الخارجية.

ما الفرق بين رابطي webhook الفتح والإغلاق؟

في وضع Custom Signal، يوفّر بوتك رابطين منفصلين لهما مهمتان متمايزتان. الرسالة إلى رابط فتح webhook (Open) تفتح صفقة باستخدام إعدادات الأوامر التي هيّأتها في Freya، أي مبلغ الصفقة إضافةً إلى أيّ جني أرباح وإيقاف خسارة تضبطه. والرسالة إلى رابط إغلاق webhook (Close) تغلق الصفقة المفتوحة لدى البوت. وهما غير قابلين للتبادل، فتنبيه دخول موجَّه إلى رابط الإغلاق لن يفتح صفقة أبداً. أما وضع Risk Ratio فيعمل بشكل مختلف، إذ يوجد رابط واحد فقط يُستخدَم لإشارة الدخول، ولا وجود لرابط إغلاق لأنّ الخروج يُدار تلقائياً بجني الأرباح وإيقاف الخسارة المحمولين في رسالة الـ webhook. ويمكن نسخ كلا الرابطين وإعادة توليدهما بشكل مستقل؛ وإعادة التوليد تنشئ رابطاً جديداً وتُبطل القديم فوراً، فحدّث تنبيه TradingView المطابق بعد ذلك.

هل يمكن لتنبيه TradingView أن يضبط جني الأرباح وإيقاف الخسارة؟

نعم، وهذا بالضبط ما وضع Risk Ratio له. في ذلك الوضع، تكون رسالة تنبيهك حمولة JSON صغيرة تحمل سعرَي جني الأرباح وإيقاف الخسارة، وتوفّر شاشة إعداد Freya قالب JSON Body لنسخه إلى تنبيهك. عندما تصل الإشارة، يُنفَّذ الدخول بسعر السوق، وتُوضع المخارج من قيم إشارتك: جني الأرباح كأمر محدَّد بالسعر الدقيق الذي أرسلته، وإيقاف الخسارة كأمر سوق عند بلوغ سعر تفعيله. وبما أنّ إيقاف الخسارة يُنفَّذ بسعر السوق، فقد يتعرّض للانزلاق السعري في تحرّك سريع، كأيّ أمر إيقاف. أما في وضع Custom Signal، فلا يمكن للـ webhook ضبط مستويات الخروج؛ إذ يأتي جني الأرباح وإيقاف الخسارة من إعدادات الأوامر التي تهيّئها داخل Freya، وتقتصر تنبيهاتك على تحديد متى تفتح ومتى تغلق.

هل من الآمن لصق رابط الـ webhook في TradingView؟

لصق الرابط في تنبيه TradingView الخاص بك هو الاستخدام المقصود، وهذا هو التكامل يعمل كما صُمِّم. الخطر الحقيقي هو الانكشاف، لا اللصق نفسه. رابط الـ webhook لا كلمة مرور فوقه: فمن يملك الرابط يمكنه تشغيل ذلك الإجراء على بوتك. ومسارات التسريب الشائعة عادية: لقطة شاشة لإعدادات التنبيه تُشارَك في محادثة، أو منشور عام يطلب المساعدة، أو تخطيط رسم بياني مشترك. تعامل مع كل رابط كأنه كلمة مرور: أبقِه بعيداً عن لقطات الشاشة، ولا تشاركه مع أحد، والصقه فقط في أدوات تتحكّم فيها شخصياً. وإذا اشتبهت يوماً في أنّ رابطاً قد رآه شخص آخر، فأعِد توليده فوراً، إذ يتوقّف الرابط القديم عن العمل لحظة إنشاء الجديد، ثم حدّث تنبيهك بالبديل قبل أن تُفعَّل إشارتك التالية.

لماذا فُعِّل تنبيهي لكن لم تحدث أيّ صفقة؟

ابدأ بالبوت نفسه: البوت المتوقّف أو المُوقَف يتجاهل الإشارات تماماً، وهذا أكثر الأسباب شيوعاً. بعد ذلك تحقّق من التوصيلات: يجب أن يحمل التنبيه الرابط الصحيح الكامل (الفتح لا الإغلاق للدخول)، وإذا أعدت التوليد مؤخراً فقد يظلّ التنبيه يشير إلى الرابط الميت. ثم افحص الرسالة: خصوصاً في وضع Risk Ratio، يجب أن تطابق الحمولة قالب الـ JSON من شاشة إعداد بوتك، وإلا تُتجاهَل الإشارة. وعلى جانب TradingView، تأكّد من أنّ خطتك ترسل webhook فعلاً وأنّ التنبيه لم تنتهِ صلاحيته أو يُطلِق طلقته الوحيدة "مرة واحدة فقط". وأخيراً، إذا كان مبلغك، أو حجم Risk Ratio المحسوب تلقائياً، أقلّ من الحد الأدنى للمنصة للزوج، فسيُرفَض الأمر. يخبرك سجل نشاط بوتك أيّ جانب فشل: إشارة مسجَّلة تعني مشكلة تنفيذ؛ وغياب أيّ قيد يعني أنّ الإشارة لم تصل أبداً.

هل يجب أن تأتي إشاراتي من TradingView؟

لا. TradingView هو المصدر الأكثر شيوعاً لأنّ نظام تنبيهاته مرن ومبني على الرسوم البيانية، لكن بوت الإشارة من Freya يستجيب لاستدعاءات webhook بصرف النظر عن أصلها. أيّ أداة تستطيع إرسال webhook تعمل: منصة رسوم بيانية أخرى، أو سكربت مخصّص، أو ماسح (screener) بإشعارات webhook، أو نظام إشارات داخلي. والعقد واحد في كل حالة، أي استدعاء رابط الفتح أو الإغلاق في وضع Custom Signal، أو إرسال حمولة JSON المتوقّعة بقيم جني الأرباح وإيقاف الخسارة إلى الرابط الوحيد في وضع Risk Ratio. وينطبق تحذيران على أيّ مصدر. أولاً، مسألة الموثوقية لا تختفي: فبوتك لا يستطيع تنفيذ إلا الإشارات التي تصل فعلاً، فوقت تشغيل مصدرك هو وقت تشغيل استراتيجيتك. ثانياً، قاعدة الأمان عامة، فأياً كانت الأداة التي تستخدمها، لا يذهب رابط الـ webhook إلا إلى أنظمة تتحكّم فيها وتثق بها.

إلى أين تذهب بعد ذلك

بوت الـ webhook جيد بقدر جودة الاستراتيجية التي تغذّيه. اختبر منطق إشارتك تحت الضغط مقابل التاريخ عبر كيفية إجراء اختبار رجعي لاستراتيجية تداول العملات الرقمية، واقرأ الشرح الكامل في كيفية إنشاء بوت إشارة على Freya Finance إذا تخطّيت أيّ تفصيل في الإعداد. وإذا كنت تفضّل بناء منطق الدخول داخل Freya بدلاً من ذلك، فإنّ دليل استراتيجية بوت DCA يغطّي ذلك النهج بعمق. ولأسئلة الحفظ وأذونات مفاتيح API، راجع هل أموالي آمنة على Freya Finance؟