استلم ردود النماذج على Next.js أو Node.js أو Python
احتفظ بنسخة موقَّعة من كل رد على نماذجك في تطبيقك الخاص. مستقبِلات جاهزة لـNext.js وNode.js وPython وLaravel وPHP، والقواعد الأربع إن كتبت مستقبِلك بنفسك.
تريد فرق كثيرة إجابات نماذجها في مكانين: في Weesify، حيث يصبح الشخص جهة اتصال وتبدأ الأتمتة، وفي تطبيقها الخاص، بجانب عملائها أو طلباتها أو تذاكرها. حتى الآن كان Weesify يوفّر مستقبِلات لـWordPress وPHP العادي وLaravel. يضيف هذا الإصدار Next.js وNode.js وPython، وأصبح Weesify يتعرّف على هذه المواقع عند ربطها.
يشرح هذا الدليل كيف تربط موقعًا، وتختار المستقبِل المناسب، وما يجب أن يتحقق منه المستقبِل، وكيف تنتقل من التخزين التجريبي إلى قاعدة بياناتك.
في هذا الدليل
- كيف تعمل النسخ
- اربط موقعك
- اختر مستقبِلك
- القواعد الأربع التي يتبعها كل مستقبِل
- من ملفات JSON إلى قاعدة بياناتك
- الاختبار والتشغيل الفعلي
- طرق أخرى لإخراج الإجابات
كيف تعمل النسخ
يحفظ Weesify كل رد أولًا دائمًا. عندما يكون خيار احفظ نسخة على هذا الموقع مفعّلًا في نموذج، يرسل Weesify بعدها نسخة إلى موقعك في طلب HTTPS موقَّع. يتحقق مستقبِلك من التوقيع، ويحفظ النسخة مرة واحدة، ويجيب بأنها حُفظت. عندها فقط يعدّ Weesify النسخة مُسلَّمة.
إذا كان موقعك متوقفًا أو أجاب بخطأ، يعيد Weesify المحاولة لمدة يوم تقريبًا، مع فترات تتباعد بين المحاولات. تعرض شاشة المواقع لكل موقع النسخ المسلَّمة والمنتظرة والجارية إعادة محاولتها والفاشلة، لتعرف دائمًا أين تقف الأمور.

اربط موقعك
- انتقل إلى النماذج › المواقع واضغط ربط موقع.
- أدخل عنوان موقعك. يفحص Weesify صفحته العامة، ويتعرّف على مواقع WordPress وLaravel وNext.js وNode.js وPython وPHP العادي، ويقترح عنوان الاستلام المناسب، مثل
/api/weesifyلـNext.js. - انسخ سرّ التوقيع. يُعرض مرة واحدة فقط. احفظه على خادمك في متغير بيئة اسمه
WEESIFY_SECRET، ولا تضعه أبدًا في صفحة ويب أو في مستودع الشيفرة. - نزّل المستقبِل المناسب لتقنيتك من اللوحة نفسها.
إذا لم يستطع Weesify معرفة طريقة بناء موقعك، اختر خادمي الخاص وأدخل العنوان بنفسك. أي تقنية تستطيع استقبال طلب POST عبر HTTPS تعمل.
اختر مستقبِلك
Next.js (App Router). احفظ route.ts باسم app/api/weesify/route.ts. يعمل على بيئة تشغيل Node.js، ويقرأ جسم الطلب الخام، ويتحقق من التوقيع ويجيب بصيغة JSON. فيه مكان محدد بوضوح لاستدعاء قاعدة بياناتك، باستخدام Prisma أو Drizzle أو Supabase أو ما تستخدمه أصلًا.
Node.js. يحتاج weesify-receiver.mjs إلى Node 18 أو أحدث ولا يحتاج إلى أي حزم. شغّله منفردًا خلف HTTPS، أو ركّبه في Express عبر app.post('/weesify/receive', weesifyExpress()). لا تضع محلّل JSON للجسم على ذلك المسار: يُتحقق من التوقيع مقابل البايتات نفسها التي أرسلها Weesify.
Python. يستخدم weesify_receiver.py المكتبة القياسية فقط، مع Python 3.8 أو أحدث. شغّله منفردًا، أو استدعِ دالته handle() من مسار Flask أو عرض Django. في Django، علّم العرض بـ@csrf_exempt: فالتوقيع هو ما يحميه.
Laravel. يوضع WeesifyFormCopyController.php في app/Http/Controllers، مع مسار واحد في routes/api.php وجدول صغير للنسخ. يوضح الملف كليهما.
PHP. يعمل weesify-receiver.php على أي استضافة PHP 7.4+، بما فيها الاستضافة المشتركة. ارفعه واضبط السرّ.
يشرح كل ملف نفسه في أعلاه، لتقرأ بالضبط ما يفعله قبل أن يقترب من خادمك.
القواعد الأربع التي يتبعها كل مستقبِل
إن فضّلت كتابة مستقبِلك بنفسك، فهذه هي الأمور الوحيدة التي عليه فعلها.
1. التحقق من التوقيع. لكل طلب ترويستان: X-Weesify-Timestamp (بالثواني) وX-Weesify-Signature، وقيمتها v1= متبوعة بقيمة HMAC-SHA256 بالنظام الست عشري لـtimestamp.body باستخدام سرّك. احسب القيمة نفسها من الجسم الخام وقارنها في زمن ثابت.
2. رفض الطلبات القديمة. إذا ابتعد الطابع الزمني أكثر من خمس دقائق عن ساعة خادمك، أجب بـ401. هذا يمنع إعادة إرسال طلب تم التقاطه لاحقًا.
3. الرد على طلبات ping. عندما تضغط «اختبار» في Weesify، يرسل {"event": "ping"}. أجب بـ{"ok": true}.
4. حفظ كل نسخة مرة واحدة. النسخة الحقيقية تحتوي على "event": "submission.copy" وidempotency_key. احفظها إن لم تكن رأيت ذلك المفتاح وأجب بـ{"stored": true}؛ وإن كنت رأيته فأجب بـ{"duplicate": true}. تستخدم إعادة المحاولات المفتاح نفسه، فالنسخة التي تصل مرتين تُحفظ مرة واحدة.
أي إجابة غير 2xx مع stored أو duplicate تُعامَل على أنها «أعد المحاولة لاحقًا». وهذا مقصود: إذا توقفت قاعدة بياناتك لحظة، فإن الإجابة بـ500 تعني أن Weesify يُبقي النسخة في الانتظار بدل أن يفقدها.
نختبر هذه القواعد على مستقبِلاتنا في كل إصدار: يُنشئ موقِّع Weesify طلبًا حقيقيًا، وتعمل ملفات Node.js وPython كما ستعمل على خادمك، ويجب أن تصمد الفحوص أعلاه، بما فيها رفض طابع زمني قديم.
من ملفات JSON إلى قاعدة بياناتك
تحفظ مستقبِلات PHP وNode.js وPython كل نسخة في ملف JSON داخل مجلد خاص، لتعمل فور رفعها. هذا يكفي للاختبار أو لموقع قليل الحركة. أما للاستخدام الفعلي، فغيّر الدالة store() لتكتب صفًا في قاعدة بياناتك:
- استخدم
idempotency_keyعمودًا فريدًا، لترفض قاعدة البيانات نفسها التكرار؛ - احتفظ بـ
submission.id، المرجع إلى الأصل في Weesify؛ - خزّن
answersبصيغة JSON، أو وزّع الأسئلة التي تهمك على أعمدة خاصة بها؛ - تسرد
filesأي ملفات مرفوعة بأسمائها وعنوان لتنزيلها.
يأتي مستقبِل Next.js بمجموعة في الذاكرة بدل الملفات، لأن معظم استضافات Next.js لا تملك قرصًا دائمًا. وهو موسوم بوضوح بأنه غير دائم، مع مثال معلَّق لاستدعاء قاعدة البيانات الذي يحل محله.
الاختبار والتشغيل الفعلي
- انشر المستقبِل مع ضبط
WEESIFY_SECRET. - في النماذج › المواقع، اضغط اختبار. تعني «متصل» باللون الأخضر أن التوقيع والساعة وping كلها تعمل.
- افتح نموذجًا، وانتقل إلى النسخ وفعّل احفظ نسخة على هذا الموقع لموقعك.
- أرسل النموذج مرة بنفسك وشاهد النسخة تظهر على أنها مُسلَّمة.
إذا فشل الاختبار، تشرح الرسالة السبب بكلمات بسيطة: تعذّر الوصول إلى العنوان، أو لم تكن الإجابة JSON، أو لم يتطابق التوقيع (غالبًا سرّ لُصق مع مسافة زائدة، أو محلّل جسم يغيّر البايتات).
طرق أخرى لإخراج الإجابات
النسخ إلى خادمك طريق من عدة طرق، ويمكنك استخدام أكثر من طريق في الوقت نفسه:
- التطبيقات. Google Sheets وAirtable وNotion وHubSpot وSalesforce، لكل منها تسجيل دخوله الخاص، من شاشة المواقع نفسها.
- Webhooks والواجهة البرمجية. كل رد حدث يمكنك إرساله إلى أي مكان، والواجهة البرمجية تقرأ النماذج والردود. يشرح مقالنا عن واجهة Weesify البرمجية وأداة سطر الأوامر كليهما.
- مساعدو الذكاء الاصطناعي. يتيح خادم MCP من Weesify لمساعد تستخدمه قراءة نماذجك وردودك وإنشاء مسودات نماذج جديدة، بمفتاح تتحكم به.

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