اربط Stripe وTwilio وخدمات أخرى
باختصارتصل الموصلات تطبيقك بخدمات خارجية، مثل Stripe للمدفوعات وTwilio للرسائل النصية وResend للإرسال من نطاق بريدك الخاص وغيرها. اطلب الميزة في المحادثة فيعرض MonstarX بطاقة لإدخال المفاتيح، أو افتح الخدمات السحابية ← السحابة ← الموصلات وانقر على «ربط». ليست لديك مفاتيح بعد؟ انقر على «لاحقًا» وسينشئ MonstarX كل شيء رغم ذلك.
يتضمن تطبيقك مسبقًا قاعدة بيانات وحسابات وبريدًا إلكترونيًا وتخزين ملفات وذكاءً اصطناعيًا. أما الموصلات فتضيف كل ما عدا ذلك: استقبال المدفوعات عبر Stripe، وإرسال الرسائل النصية عبر Twilio، وجلب البيانات من أي موقع ويب عبر Firecrawl، وغير ذلك. يربط كل موصل خدمة خارجية واحدة بتطبيق واحد، باستخدام المفاتيح (كلمات المرور السرية التي تمنحك إياها الخدمة لواجهة API الخاصة بها) من حسابك أنت في تلك الخدمة.
نادرًا ما تحتاج إلى البحث عنها. عندما تطلب ميزة تحتاج إلى خدمة ما، مثل «دع الأعضاء يشترون باقات الحصص»، يكتب MonstarX الشفرة ويطلب منك المفاتيح هناك في المحادثة.
ما الخدمات التي يستطيع تطبيقي الاتصال بها؟
Section titled “ما الخدمات التي يستطيع تطبيقي الاتصال بها؟”هذه الموصلات مخصصة لما يقدمه تطبيقك لمن يستخدمونه. تجدها كلها في الخدمات السحابيةالسحابة، في قائمة الموصلات.
| الموصل | ما يستطيع تطبيقك فعله به | ما تلصقه |
|---|---|---|
| Stripe | استقبال المدفوعات والاشتراكات وصفحات الدفع. بمفاتيح بيئة الاختبار أو البيئة الفعلية. | المفتاح السري، والمفتاح القابل للنشر، وسر توقيع Webhook (اختياري) |
| Twilio | إرسال الرسائل النصية ورسائل WhatsApp، وإجراء المكالمات الصوتية. | SID للحساب، ورمز المصادقة، ورقم المرسل |
| Resend | إرسال البريد الإلكتروني من نطاقك الخاص بدلًا من بريد MonstarX. | مفتاح API، وعنوان المرسل |
| OpenAI | استخدام مفتاح OpenAI الخاص بك بدلًا من الذكاء الاصطناعي في MonstarX. | مفتاح API |
| OpenRouter | استخدام مفتاح OpenRouter الخاص بك (أي نموذج) بدلًا من الذكاء الاصطناعي في MonstarX. | مفتاح API |
| Google Maps | البحث عن الأماكن والإكمال التلقائي، وتفاصيل الأنشطة التجارية، واتجاهات القيادة. | مفتاح API |
| Mapbox | تحديد المواقع الجغرافية (تحويل العنوان إلى موقع على الخريطة)، والاتجاهات، وأنماط خرائط Mapbox، بما فيها صور الأقمار الصناعية. | رمز الوصول العام |
| Firecrawl | تحويل أي موقع ويب إلى نص نظيف أو بيانات منظّمة (استخراج الصفحات، والزحف، والبحث). | مفتاح API |
| Zernio | ربط حسابات التواصل الاجتماعي لمستخدميك (X وInstagram وFacebook وLinkedIn وTikTok وYouTube وغيرها) ونشر المنشورات أو جدولتها. | مفتاح API |
| ElevenLabs | تحويل النص إلى كلام وتوليد الأصوات. | مفتاح API |
| Google Analytics | عدّ مشاهدات الصفحات والأحداث باستخدام GA4. | معرّف القياس |
بعض الموصلات تؤدي مهام أكبر ولها صفحات خاصة:
- يستطيع Supabase وRailway حفظ بيانات تطبيقك في قاعدة بيانات Postgres خاصة بك، راجع Supabase وRailway.
- يمنح Firebase تطبيقك Firestore وتسجيل الدخول وتخزين الملفات والإشعارات الفورية من مشروعك الخاص، راجع Firebase.
- يشغّل Cloudflare التطبيق كله على حسابك الخاص في Cloudflare، راجع حسابك الخاص في Cloudflare.
- أما Azure وAWS وVercel وGoogle Cloud فهي أماكن لنشر تطبيقك، راجع النشر على استضافات أخرى.
كيف أربط خدمة من المحادثة؟
Section titled “كيف أربط خدمة من المحادثة؟”اطلب الميزة بكلمات بسيطة، مثل «دع الناس يدفعون ثمن باقة الحصص عبر Stripe». ينشئها MonstarX ويعرض بطاقة تطلب منك ربط الخدمة، مع سبب حاجته إليها.
-
اقرأ البطاقة. يفتح رابط أين تجد المفاتيح صفحة الخدمة نفسها التي تشرح مكان مفاتيحها.
-
في Stripe، اختر البيئة: بيئة الاختبار (مفاتيح اختبار) أثناء التجربة، والبيئة الفعلية (مفاتيح تشغيل فعلي) عندما يدفع عملاء حقيقيون.
-
الصق المفاتيح في الحقول وانقر على ربط Stripe (يحمل الزر دائمًا اسم الخدمة).
-
تتحول البطاقة إلى اللون الأخضر: Stripe متصل. يُعاد تشغيل المعاينة بالمفاتيح، فتجرّب الميزة فورًا.
لا يستطيع ربط الخدمة إلا مالك المشروع. أما أي شخص آخر يطّلع على المشروع فيرى البطاقة مع عبارة «لا يمكن ربطه إلا لمالك المشروع».
ماذا لو لم تكن لديّ المفاتيح بعد؟
Section titled “ماذا لو لم تكن لديّ المفاتيح بعد؟”انقر على لاحقًا. تُطوى البطاقة في سطر واحد، «Stripe · ستربطه لاحقًا»، وينشئ MonstarX كل شيء رغم ذلك. وحيث يحتاج التطبيق إلى الخدمة، يعرض رسالة واضحة مثل «Stripe غير مربوط بعد» بدلًا من أن يتعطل. انقر على ربط الآن متى أصبحت المفاتيح لديك.
يُحفظ اختيارك مع المشروع، فتبقى البطاقة مطوية على كل الأجهزة إلى أن تربط الخدمة.
ماذا لو لم يستطع MonstarX المتابعة من دونها؟
Section titled “ماذا لو لم يستطع MonstarX المتابعة من دونها؟”أحيانًا يعتمد الطلب كله على ما في حسابك، مثل «استورد منتجاتي من Stripe». عندها تظهر البطاقة باللون الكهرماني، وتقول يحتاج MonstarX إلى Stripe للمتابعة، ولا يكون فيها زر لاحقًا. ينشئ MonstarX الأجزاء التي لا تحتاج إلى الخدمة وينتظر. وفور ربطها، يواصل العمل تلقائيًا.
كيف أربط خدمة من تبويب الخدمات السحابية؟
Section titled “كيف أربط خدمة من تبويب الخدمات السحابية؟”-
افتح مشروعك وانقر على الخدمات السحابية في الشريط العلوي، ثم على السحابة.
-
مرّر إلى الموصلات وانقر على ربط بجانب الخدمة.
-
املأ الحقول. الحقول الاختيارية مكتوب بجانبها «(اختياري)»، وتحت كثير منها سطر يشرحها.
-
انقر على زر ربط متبوعًا باسم الخدمة.
تظهر بجانب الخدمة المربوطة علامة خضراء متصل (وفي Stripe: متصل · بيئة الاختبار أو متصل · البيئة الفعلية)، مع زرين:
- تحديث المفاتيح لاستبدال مفتاح أو أكثر. اترك الحقل فارغًا للإبقاء على قيمته الحالية.
- قطع الاتصال لإزالة الخدمة ومفاتيحها من هذا التطبيق.
وأيقونة السهم الصغيرة بجانب كل موصل تفتح توثيق الخدمة نفسها.
كيف أعرف الخدمات التي ما زال تطبيقي ينتظرها؟
Section titled “كيف أعرف الخدمات التي ما زال تطبيقي ينتظرها؟”يلاحظ MonstarX متى تستخدم شفرة تطبيقك خدمة لم تُربط بعد، ويخبرك في 3 أماكن:
- الخدمات السحابية ← السحابة تعرض هذه الموصلات أولًا، مع علامة يستخدمه تطبيقك · الاتصال لاحقًا أو يستخدمه تطبيقك · غير متصل أو مطلوب للمتابعة.
- نشر تظهر عليه نقطة كهرمانية، وفي داخله ملاحظة مثل «لم يُربط بعد: Stripe وTwilio»، مع زر ربط لكل خدمة. ويمكنك النشر رغم ذلك، لكن تلك الأجزاء لن تعمل لأي أحد إلى أن تُضاف المفاتيح.
- اختبارات QA تفحص المسار حتى الخطوة التي تحتاج إلى الخدمة، وتعلّمه بأنه يحتاج إلى مفاتيح بدلًا من أن تعدّه فاشلًا. راجع اختبارات QA.
إذا أزلت الميزة التي كانت تستخدم الخدمة، يختفي التذكير تلقائيًا.
أين تُحفظ المفاتيح؟
Section titled “أين تُحفظ المفاتيح؟”تُحفظ المفاتيح مشفّرة مع التطبيق، بأسماء ثابتة مثل STRIPE_SECRET_KEY. ترى أسماءها (لا قيمها أبدًا) في الخدمات السحابيةالأسرار، بجانب أي مفاتيح أضفتها بنفسك. راجع الأسرار.
- المفاتيح السرية لا يستخدمها إلا خادم تطبيقك. ولا يستطيع أي زائر لتطبيقك رؤيتها.
- المفاتيح العامة، مثل المفتاح القابل للنشر في Stripe أو مفتاح Google Maps أو معرّف القياس في Google Analytics، مصممة للاستخدام في المتصفح. وهذا آمن لهذه المفاتيح، ولهذا تمنحك الخدمات نوعين منها.
- المفاتيح تخص تطبيقًا واحدًا، ولا يراها أي تطبيق آخر من تطبيقاتك.
هل يمكنني استخدام خدمتي الخاصة بدلًا من الخدمة المدمجة؟
Section titled “هل يمكنني استخدام خدمتي الخاصة بدلًا من الخدمة المدمجة؟”نعم. بعض الموصلات مصممة لتحل محل إحدى خدمات MonstarX Cloud، وتضع عليها القائمة علامة يحلّ محل خدمة … من MonstarX:
| الخدمة المدمجة | استبدلها بـ |
|---|---|
| البريد الإلكتروني (يرسل من نطاق بريد MonstarX) | Resend، للإرسال من نطاقك الخاص |
| الذكاء الاصطناعي (نماذج مُدارة مع بدائل احتياطية) | OpenAI أو OpenRouter، على حسابك أنت |
| قاعدة البيانات | Supabase، أو Railway Postgres الذي لا يحمل العلامة لكنه يستطيع حفظ البيانات أيضًا. راجع Supabase وRailway. |
اربط البديل، ثم اطلب من MonstarX استخدامه، مثل «أرسل رسائل التطبيق عبر Resend». وعندما لا يعود شيء في التطبيق يستخدم الخدمة المدمجة، يمكنك إيقاف البريد الإلكتروني أو الذكاء الاصطناعي أو بحث الويب أو التخزين من الخدمات السحابيةالسحابة. راجع هل يمكنني إيقاف خدمة واستخدام خدمتي الخاصة؟
من المفيد أن تعرف
Section titled “من المفيد أن تعرف”- الإنشاء لا ينتظر المفاتيح أبدًا. يكتب MonstarX الشفرة استنادًا إلى توثيق الخدمة، فالمفتاح الناقص لا يوقف إلا تلك الميزة وحدها.
- اختبر أولًا. تتيح لك مفاتيح بيئة الاختبار في Stripe تجربة الدفع ببطاقات اختبار دون أموال حقيقية.
- حسابك وفاتورتك. الخدمة المربوطة تحاسب حسابك لديها، وفق أسعارها الخاصة. ولا يضيف MonstarX أي شيء.
- الموصلات الخاصة بـ MonstarX نفسه مختلفة: أدوات الأعمال تتيح لوكيل الإنشاء قراءة Google Sheets أو HubSpot أو Jira، وموصلات MCP تمنحه أدوات أخرى.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”هل أحتاج إلى معرفة البرمجة لربط Stripe؟
لا. اطلب الميزة في المحادثة، والصق مفتاحَي Stripe في البطاقة التي يعرضها MonstarX، وانقر على ربط Stripe. يكتب MonstarX الشفرة كلها.
هل يمكنني إنشاء التطبيق قبل أن تصبح المفاتيح لديّ؟
نعم. انقر على لاحقًا في البطاقة. ينشئ MonstarX كل شيء، ويعرض رسالة ودودة بأن الخدمة «غير مربوطة بعد» حيث تلزم، ويذكّرك في نشر قبل أن يُتاح التطبيق على الإنترنت.
أين أغيّر مفتاحًا أو أحذفه؟
في الخدمات السحابية ← السحابة ← الموصلات، انقر على تحديث المفاتيح أو قطع الاتصال بجانب الخدمة. وتظهر أسماء المفاتيح أيضًا في الخدمات السحابية ← الأسرار.
هل يرى مستخدمو تطبيقي مفاتيحي؟
لا يرون مفاتيحك السرية، فهي تبقى على خادم تطبيقك. لا تصل إلى الصفحة إلا المفاتيح العامة المصممة للمتصفحات، مثل المفتاح القابل للنشر في Stripe.
هل تعمل مفاتيحي في المعاينة وفي التطبيق المنشور؟
نعم. يعيد الربط تشغيل المعاينة بالمفاتيح الجديدة، وفي المرة التالية التي تنشر فيها يحصل عليها التطبيق المنشور أيضًا.
هل يوجد موصل لخدمة غير موجودة في القائمة؟
يمكنك استخدامها رغم ذلك. اطلب من MonstarX دمج الخدمة، ثم أضف مفتاحها بنفسك في الخدمات السحابية ← الأسرار. يقرؤه التطبيق بالطريقة نفسها.