# النموذج يعرض النجاح لكن البريد لا يصل: أين تبحث؟

شخّص طلب النموذج والرد والسجل والمستلم المؤكد وTurnstile لتعرف أين تتوقف رسالة التواصل.

Author: Formgong
Published: 2026-10-01
Language: ar
Canonical: https://formgong.com/blog/contact-form-not-sending-email?lang=ar

افحص طلب الموقع، ثم حفظ الرسالة في Formgong، ثم إعدادات البريد والمستلم المؤكد. success: true يعني قبول الطلب ولا يثبت وصول البريد. قد تمنع التنبيهات أيضاً حالة الحساب أو تصنيف البريد المزعج أو Turnstile.

## افصل النتائج الثلاث

الشكر الذي يظهر في الموقع قد يكون مجرد حالة في الواجهة. حفظ الرسالة ووصول البريد مرحلتان أخريان. أرسل نصاً مميزاً من الموقع المنشور وتتبع الرسالة نفسها. رموز الأخطاء هنا تخص Formgong؛ مع خدمة أخرى راجع توثيقها.

## هل خرج الطلب من المتصفح؟

افتح أدوات المتصفح وابحث في Network عن POST إلى `https://formgong.com/submit`. راجع المفتاح والحقول والرد. إذا لم يوجد طلب، افحص الزر ومعالج الإرسال. في HTML راجع `action` و`method`، وفي JavaScript راجع عنوان `fetch`.

## اعرض النجاح بناءً على الرد

اطلب JSON باستخدام `Accept: application/json`. افحص حالة HTTP و`success` معاً. عند الخطأ، احتفظ بالقيم واعرض إمكانية إعادة المحاولة. يوضح المثال التالي قبول الطلب؛ لا يؤكد وصول البريد.

```javascript
// Call from your form's submit handler inside try/catch.
// Keep the entered fields when the request fails.
async function sendContactForm(form) {
  const response = await fetch("https://formgong.com/submit", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Accept: "application/json",
    },
    body: JSON.stringify({
      ...Object.fromEntries(new FormData(form)),
      access_key: "fk_your_access_key",
    }),
  });
  const result = await response.json();
  if (!response.ok || result.success !== true) {
    throw new Error(result.message || "Submission failed");
  }
  // Accepted by Formgong; this is not email-delivery confirmation.
  return result.id;
}
```

## اقرأ سبب الرفض قبل تغيير الكود

`unknown_access_key`: انسخ مفتاح النموذج الصحيح. `origin_not_allowed`: راجع نطاق الموقع الفعلي. `rate_limited`: انتظر قبل إعادة المحاولة. `limit_exceeded`: راجع استهلاك الحساب. `turnstile_missing` أو `turnstile_failed`: تحقق من المكوّن والرمز.

الإرسال العادي قد ينتقل إلى صفحة نتيجة بدلاً من JSON. اختبر النموذج بالطريقة التي ينفذها الموقع فعلاً.

## هل ظهرت الرسالة في النموذج الصحيح؟

افتح النموذج المطابق للمفتاح وابحث عن نص الاختبار، ثم راجع البريد المزعج. ملء `botcheck` قد يبدو ناجحاً بينما تصنف الرسالة كبريد مزعج دون تنبيه. قد تنتظر رسائل الحساب غير المؤكد حتى التأكيد. هذه حالات مختلفة عن انقطاع الشبكة.

## افحص قناة البريد بعد العثور على السجل

تحقق من تشغيل تنبيهات البريد ومن أن المستلم المطلوب مؤكد. افتح صندوق ذلك العنوان ومجلد البريد غير المرغوب فيه. قد يضع برنامج البريد الرسالة في تصنيف آخر.

يمكنك الرد على بريد الزائر عندما يحتوي النموذج على عنوانه. تغيير المستلم في Formgong لا يحتاج إلى نشر الموقع من جديد، ولا يغير إعدادات تليجرام.

## بعد تفعيل Turnstile

أضف المكوّن بمفتاح الموقع ومرر `cf-turnstile-response`. تنتهي صلاحية الرمز ولا يعاد استخدامه؛ حدّث المكوّن قبل محاولة جديدة. مفتاح الموقع عام، أما المفتاح السري فلا يوضع في المتصفح.

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

## اختبر بعد تعديل واحد

غيّر سبباً محدداً وأرسل رسالة جديدة يمكن تمييزها. إذا احتجت إلى مساعدة، أرفق مسار الصفحة ووقت الاختبار ورمز الخطأ من دون بيانات العملاء أو مفاتيح سرية. للربط الأساسي، ابدأ بـ [دليل HTML](/blog/html-contact-form-without-backend?lang=ar) أو [دليل Lovable](/blog/lovable-contact-form-email-telegram?lang=ar).

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

### هل success: true يثبت وصول البريد؟

لا. يعني قبول الطلب. تحقق من السجل وتصنيفه ومن وصول التنبيه كل على حدة.

### لماذا يعمل النموذج في المعاينة فقط؟

راجع نطاق الموقع المنشور في قائمة النطاقات المسموحة، وإعدادات Turnstile والكود المنشور فعلياً.

### هل يلزم نشر الموقع بعد تغيير المستلم؟

لا. إعدادات المستلمين موجودة في Formgong، لكن العنوان الجديد يحتاج إلى تأكيد.

### هل وصول تليجرام يثبت وصول البريد؟

لا. القناتان منفصلتان؛ تحقق من إعدادات البريد والمستلم وصندوقه.

## المصادر والتوثيق

- [MDN: Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch)
- [Cloudflare: Turnstile token validation](https://developers.cloudflare.com/turnstile/get-started/server-side-validation/)
- [توثيق Formgong](https://formgong.com/docs?lang=ar)

[احصل على مفتاح النموذج](https://formgong.com/?lang=ar#top)