كيف أربط Typeform لتحويل إرسالات النماذج إلى أعضاء؟
اربط حقلَي البريد والاسم في نموذج Typeform وسجّل الـ Webhook، فيُنشئ كل رد جديد عضوًا في المدونة — دون الحاجة إلى Zapier.
يحوّل موصل Typeform رد النموذج مباشرة إلى عضو في المدونة. يسجّل VeloCMS Webhook على نموذجك في Typeform، فيصل كل إرسال إلى قائمة أعضائك لحظة ضغط المرسِل على «إرسال» — دون أداة أتمتة وسيطة.
Typeform هو التكامل الوحيد الذي يستقبل البيانات بدل أن يرسلها. تثبيته يشبه أي إضافة أخرى (راجع الدليل المشترك للتكاملات)، أما بقية هذه المقالة فهي إعداد الـ Webhook الخاص به وحده.
الخطوة 1 — احصل على رمز الوصول الشخصي من Typeform
في Typeform اذهب إلى Account settings ← Personal tokens وأنشئ رمزًا. يستخدمه VeloCMS لقراءة أسئلة النموذج ولتسجيل الـ Webhook، فامنحه صلاحية الوصول إلى النماذج وإلى الـ Webhooks.
الخطوة 2 — املأ لوحة Typeform
افتح «لوحة التحكم ← الإضافات ← Typeform» والصق الرمز. أدخل «معرّف النموذج»، وهو الجزء الذي يمثّل المعرّف في رابط نموذجك. ثم اختر «سرّ الـ Webhook»: أي سلسلة عشوائية تصلح. يستخدمه VeloCMS ليتأكد لاحقًا من أن الإرسال جاء فعلًا من Typeform، ولا يُقبل أي شيء بدونه. اضغط «حفظ الإعدادات» أولًا، ثم «اختبار الاتصال» الذي يسأل Typeform لمن يعود الرمز ولا ينشئ شيئًا.
الخطوة 3 — اربط حقلَي البريد والاسم
اضغط «البحث عن مراجع الحقول». تسرد اللوحة كل سؤال في النموذج مع مرجعه (reference)، وهو المعرّف الثابت الذي يطابق به VeloCMS الإجابات. انسخ مرجع سؤال البريد إلى «مرجع حقل البريد الإلكتروني»، وهو مطلوب، وانسخ اختياريًا مرجع سؤال الاسم إلى «مرجع حقل الاسم». تُقرأ الإجابات أيًّا كان نوع السؤال: بريد إلكتروني، أو نص قصير أو طويل، أو رقم، أو نعم/لا، أو اختيار واحد أو متعدد، أو رابط، أو رقم هاتف، أو تاريخ، وكلها تصل نصًا. استخدم سؤال بريد إلكتروني حقيقيًا للعنوان، حتى لا يستطيع المجيب كتابة ما ليس بريدًا.
الخطوة 4 — سجّل الـ Webhook
اضغط «تسجيل Webhook». ينشئ VeloCMS Webhook على نموذجك، موسومًا بـ velocms، يشير إلى عنوان موقعك متبوعًا بـ /api/webhooks/typeform/ ثم المعرّف المختصر لموقعك. تعرض اللوحة هذا الرابط مع زر نسخ، وبعد قبول Typeform له تعرض السطر «الـ Webhook مُسجَّل مع Typeform». وإن فضّلت فعل ذلك بنفسك فألصق الرابط في Typeform ضمن Connect ← Webhooks. إعادة التسجيل آمنة: فهي تكتب فوق الـ Webhook الموسوم نفسه ولا تضيف ثانيًا.
يحمل كل طلب وارد ترويسة Typeform-Signature، وهي توقيع HMAC لمحتوى الطلب مصنوع بسرّ الـ Webhook لديك. يُرفض أي طلب توقيعه مفقود أو خاطئ برمز 401 قبل أن يُقرأ منه شيء، فلا يستطيع استدعاء مزوَّر لرابط الـ Webhook إنشاء أعضاء.
ماذا يحدث عند الإرسال
- لا بريد صالحًا في الإجابة المربوطة: يُتخطّى الإرسال ولا يُنشأ عضو.
- بريد جديد: يُنشأ عضو على الفئة المجانية، ومشترك في نشرتك البريدية، بالاسم المربوط اسمًا للعرض، ويُسجَّل typeform مصدرًا للاستيراد. كما يصلك إشعار «New subscriber» في لوحة التحكم برابط إلى الأعضاء.
- بريد يعود إلى عضو موجود: لا يتغير شيء، ويبقى العضو الموجود كما هو تمامًا.
- موقع بلغ حدّ المشتركين: يُتخطّى الإرسال بدل إنشاء عضو فوق الحد.
يمرّ العضو الذي يُنشأ بهذه الطريقة بخطوة التسجيل نفسها التي يمرّ بها من انضم عبر موقعك، فيعمل من أجله أي موصل آخر ثبّتّه، مثل ActiveCampaign أو Circle.so. وهذا يسري على النموذج الواحد الذي ربطته؛ أما بقية النماذج في حسابك على Typeform فلا تُمسّ، ولا يظهر Typeform أبدًا في «التكاملات ← نشاط المزامنة» لأن شيئًا لا يُرسَل إلى الخارج.
قطع الاتصال
أزل الإضافة من «لوحة التحكم ← الإضافات» لإيقاف معالجة الإرسالات. ومن المستحسن أيضًا حذف الـ Webhook الموسوم velocms في Typeform إن لم تنوِ إعادة الربط، لأن VeloCMS لا ينظّفه تلقائيًا بعد إلغاء تثبيت الإضافة.