رسالة «تم الإرسال» لا تكفي
قد يعرض الموقع رسالة نجاح من دون أن يحفظ شيئاً. لذلك حدد أولاً الخدمة التي ستستقبل البيانات. لدى Lovable بنية خلفية ووصلات للبريد وتليجرام؛ إذا كان تطبيقك يعتمد عليها بالفعل، يمكنك معالجة النموذج هناك.
أما Formgong فيناسب نموذج تواصل بسيط يحتاج إلى صندوق رسائل وتنبيهات مستقلين. تظل الحقول والأزرار والتصميم داخل موقعك.
جهّز البريد ومفتاح النموذج
أدخل بريدك في Formgong وافتح رابط التأكيد. قبل التأكيد قد تبقى الرسائل معلقة، لذا أكمل هذه الخطوة قبل اختبار التنبيهات.
افتح النموذج المطلوب في لوحة التحكم، ثم قسم ربط الموقع، وانسخ access_key. هذا مفتاح عام للإرسال فقط؛ لا يتيح قراءة صندوق الرسائل أو تعديل الإعدادات.
اطلب الربط مع الحفاظ على النموذج
قل لـ Lovable أن يربط النموذج الموجود مع الاحتفاظ بالتصميم وأسماء الحقول. أضف التعليمات التالية واستبدل fk_your_access_key بمفتاحك. المثال مخصص للحقول النصية؛ لا تضف رفع ملفات أو أسرار خدمة البريد أو رمز البوت إلى كود المتصفح.
أضف نموذج تواصل يرسل الطلبات إلى Formgong. لا تنشئ خادماً ولا قاعدة بيانات ولا أسراراً. - POST https://formgong.com/submit - حقل مخفي access_key بقيمة fk_your_access_key (المفتاح علني) - الحقول: name وemail وphone اختياري وmessage. التسميات بالعربية - فخ: حقل botcheck مخفي خارج الشاشة - بلا ملفات وبلا دوال خادم - نموذج HTML عادي، أو fetch مع Accept: application/json. النجاح هو json.success === true
مثال على طلب API
استبدل المفتاح وأضف حالات الانتظار والنجاح والخطأ. احتفظ بما كتبه الزائر إذا فشل الإرسال.
async function onSubmit(event) {
event.preventDefault();
const fields = Object.fromEntries(new FormData(event.currentTarget));
const response = await fetch("https://formgong.com/submit", {
method: "POST",
headers: {
"Content-Type": "application/json",
Accept: "application/json",
},
body: JSON.stringify({ ...fields, access_key: "fk_your_access_key" }),
});
const result = await response.json();
if (!result.success) throw new Error(result.message || "Formgong error");
}تتبع رسالة تجريبية واحدة
أرسل نصاً يسهل التعرف عليه، وابحث عنه في النموذج الصحيح داخل Formgong، ثم في البريد ومجلد الرسائل غير المرغوب فيها. تحقق من الحقول الإضافية أيضاً.
عند استخدام fetch، اعرض النجاح بعد success: true واحتفظ بالقيم عند الخطأ. أعد الاختبار من النطاق المنشور وعلى الهاتف؛ معاينة المحرر وحدها لا تختبر الموقع العام.
اختر محادثة التنبيهات
افتح رابط تليجرام من إعدادات النموذج وابدأ البوت. للمجموعة، أضف البوت وأرسل /connect مع الرمز الصادر من لوحة التحكم. رمز الربط ليس مفتاح إرسال النموذج.
تأكد أن المحادثة ظهرت في الإعدادات، ثم أرسل رسالة اختبار جديدة. يشرح دليل تليجرام الطريقتين بالتفصيل.
ابدأ من المكان الذي تتوقف فيه الرسالة
إذا لم يوجد سجل، راجع https://formgong.com/submit والمفتاح. إذا وجدت الرسالة ولم يصل البريد، راجع تأكيد العنوان والمستلمين والتنبيهات ومجلد البريد غير المرغوب فيه. يجب أن يبقى حقل botcheck المخفي فارغاً.
بعد تفعيل Turnstile يجب تحديث الكود ليرسل الرمز المطلوب. اتبع دليل تشخيص الإرسال لفحص كل مرحلة.
بعد نشر الموقع
يمكن تعديل المستلمين والمحادثات وعنوان التنبيه والتحويل إلى صفحة الشكر من Formgong دون إعادة نشر الموقع. تحقق أيضاً من رسالة الخطأ التي يراها الزائر. تتضمن الخطة المجانية 300 رسالة شهرياً للحساب، مع البريد وتليجرام.
أسئلة شائعة
هل أحتاج إلى Supabase إضافي؟
لا للنموذج الذي يستقبله Formgong. إذا كان التطبيق يستخدم Lovable أو Supabase بالفعل، يمكنك معالجة النموذج في تلك البنية أيضاً.
هل يجوز وضع المفتاح في المتصفح؟
نعم. access_key مفتاح عام لإرسال الرسائل، ولا يمنح صلاحية قراءة الصندوق أو تعديل الإعدادات.
هل يتغير تصميم النموذج؟
Formgong يستقبل البيانات؛ التصميم يبقى في الموقع. اطلب من Lovable الحفاظ عليه، ثم راجع النتيجة.
هل النجاح يعني أن البريد وصل؟
لا. نجاح الطلب، وحفظ الرسالة، ووصول التنبيه مراحل منفصلة يجب التحقق منها.
المصادر والتوثيق
مراجع رسمية لهذا الدليل: Lovable Cloud, Lovable Resend connector, Lovable Telegram connector. توثيق Formgong, مكان تخزين البيانات.
اقرأ بصيغة Markdown