النماذج والعملاء المحتملون

تجمع نماذج Atlas الاستفسارات على موقعك وتحوّل كل واحد منها إلى عميل محتمل (lead) يستطيع فريقك إسناده ومتابعته وتصديره. تعمل النماذج على موقع التطوير، وعلى موقعك الحي بمجرد تشغيل الإنتاج.

كيف تعمل

1. أنشئ النموذج في Studio. الحقول والتسميات ونص الموافقة وتسمية زر الإرسال ورسالة النجاح، ضمن Forms & leads.

2. يعرضه موقعك. يجلب تعريف النموذج ويرسم الحقول بمكوّناته الخاصة، فيطابق النموذج تصميمك.

3. يرسل الزائر النموذج. يرسل المتصفح الطلب مباشرة إلى Atlas. لا يُستخدم أي رمز: يقبل Atlas فقط الطلبات التي يكون Origin فيها هو عنوان موقعك المسجَّل.

4. يفحصه Atlas ويخزّنه. تعمل فحوص الرسائل المزعجة وإساءة الاستخدام أولًا، ثم يُحفظ العميل المحتمل ويُرسل بالبريد الإلكتروني إلى فريقك وإلى webhooks لديك.

التطوير والموقع الحي

	موقع التطوير	الموقع الحي (الإنتاج)
متى تستجيب النماذج	دائمًا	عند تشغيل الإنتاج و وجود إصدار موقّع حي
أي نسخة من النموذج	أحدث مسودة منشورة	النسخة الموجودة في الإصدار الحي
الأصل المقبول	عناوين التطوير لديك	https:// ونطاق الإنتاج لديك فقط
أين يظهر العملاء	Leads ← Development	Leads ← Live website (“Leads from the live website”)
رسائل العملاء بالبريد	متوقفة افتراضيًا	مفعّلة افتراضيًا؛ ويمكن إيقافها مؤقتًا

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

عندما يكون الإنتاج متوقفًا، تردّ عناوين نماذجه بـ404 CP_NOT_FOUND. وإذا كان الإنتاج مفعّلًا ولا يوجد إصدار موقّع حي بعد، فتردّ بـ403 CP_PRODUCTION_LOCKED.

اعرض النموذج

// GET /v1/public/environments/{environmentId}/forms/{formKey}
// → { key, name, version, fields, settings: { submitLabel, successMessage, consentText },
//     challenge: { provider: 'turnstile', action, siteKey } }

اعرض fields بحقول الإدخال الخاصة بك. وإذا كانت قيمة challenge.provider هي turnstile، فاعرض أداة Cloudflare Turnstile بالقيمتين siteKey وaction المعطاتين، واسمح بـTurnstile في Content-Security-Policy لديك.

الإرسال

// POST /v1/public/environments/{environmentId}/forms/{formKey}/submissions
{
  "idempotencyKey": "<new UUID per attempt>",
  "sessionId": "<16–128 chars, A–Z a–z 0–9 _ ->",
  "startedAt": 1761210000000,       // when the visitor opened the form, in ms
  "challengeToken": "<Turnstile token>",
  "website": "",                    // hidden honeypot field; leave empty
  "consent": true,
  "fields": { "name": "…", "email": "…", "message": "…" }
}

الاستجابة	المعنى
201 { status: 'received' }	قُبل الإرسال. اعرض settings.successMessage
422 SUBMISSION_INVALID	فشل حقل في التحقق. اعرض أخطاء الحقول
400 SUBMISSION_REJECTED	رُفض الإرسال، مثلًا بسبب فشل التحدي
429	عدد كبير جدًا من عمليات الإرسال. اطلب من الزائر المحاولة لاحقًا

تُعزل عمليات الإرسال المشبوهة في الحجر لكنها تحصل مع ذلك على 201، فلا يستطيع المهاجمون معرفة ما جرى تمييزه.

الحماية من الرسائل المزعجة وإساءة الاستخدام

• تحدّي Turnstile من Cloudflare، لكل موقع.
• حقل فخّ (honeypot) وحدّ أدنى لزمن التعبئة.
• كشف التكرار خلال 10 دقائق.
• حدود المعدل لكل موقع ونموذج وجلسة زائر وعنوان IP. انظر الحدود.

يعرض تبويب Spam review في Studio عمليات الإرسال المعزولة من التطوير. أما عمليات الإرسال المعزولة من الموقع الحي فلا يمكن مراجعتها في Studio بعد.

رسائل العملاء المحتملين بالبريد الإلكتروني

يضيف مالك الموقع اتصال بريد إلكتروني (SMTP أو مزوّد بريد) ضمن Integrations → Email. تُخزَّن كلمات المرور ومفاتيح API مشفّرة ولا تُعرض مرة أخرى ولا تُسجَّل.

تحتوي البطاقة Email for enquiries and leads على مفتاحين:

• Live website: مفعّل افتراضيًا متى كان الإنتاج حيًا. اضبطه على “emails paused” لإيقاف الرسائل دون المساس بالنماذج.
• Development: متوقف افتراضيًا، فلا تُرسل عمليات الإرسال التجريبية بريدًا إلى أحد. وتُوسَم عمليات الإرسال التجريبية بـ[Test].

لا يستطيع تغيير هذين المفتاحين إلا مسؤول الموقع. والردود التلقائية على الزوار متوقفة ما لم تفعّلها.

ماذا تقرأ بعد ذلك

العمل مع العملاء المحتملينأسند العملاء المحتملين وادمجهم وصدّرهم ونظّفهم، وأرسلهم إلى CRM.الإطلاقانشر إصدارًا وفعّل الإنتاج لتستجيب النماذج للزوار الفعليين.