كيفية إرسال Webhooks من نماذج Google

باستخدام webhooks لنماذج Google، يمكنك إرسال (أو دفع) استجابات النماذج إلى أي خدمة ويب خارجية بمجرد تقديم نموذج Google جديد. على سبيل المثال، يمكنك استخدام webhooks لنشر استجابات نماذج Google تلقائياً إلى أداة إدارة علاقات العملاء الخاصة بك. أو يمكنك إنشاء إدخالات جديدة في برنامج قائمة البريد الإلكتروني الخاص بك عندما يتم التقاط عميل محتمل جديد من خلال نماذج Google.

تدعم أحدث إصدار من إضافة إشعارات البريد الإلكتروني webhooks ويمكنها أيضاً تضمين استجابة المستخدم وبيانات النموذج في جسم طلب HTTP.

Webhooks لنماذج Google
نظرة عامة على تكامل Webhook

تمكين Webhooks في نماذج Google

للبدء، قم بتثبيت إضافة نماذج Google من متجر Google. عنوان الإضافة هو "إشعارات البريد الإلكتروني" ولكنها تتضمن أيضاً دعم إرسال إشعارات دفع فورية إلى أي عنوان URL للـ webhook.

بعد ذلك، قم بتشغيل الإضافة واختر Webhooks لنماذج Google من القائمة.

انقر على زر إنشاء Webhook لدمج webhook جديد مع نماذج Google الخاصة بك. يمكنك ربط عدة webhooks بنفس نموذج Google وستقوم بإرسال بيانات النماذج إلى جميع عناوين URL للـ webhook عند استلام تقديم نموذج جديد.

إضافة عنوان URL للـ Webhook ومعلمات الاستعلام

في الشاشة الأولى، قم بتوفير اسم فريد لـ webhook الخاص بك (يستخدم داخلياً) واختر طريقة طلب HTTP. من المرجح أن تقوم بطلب POST ولكن وحدة webhook تدعم أيضاً طرق GET وPUT وPATCH وDELETE.

بعد ذلك، قم بتوفير عنوان URL الكامل للـ webhook لخدمة الويب الخارجية التي ترغب في دمجها مع نماذج Google. لأغراض الاختبار، أوصي باستخدام خدمة webhook.site أو requestbin.com للحصول على عنوان URL فريد لفحص واختبار webhooks الخاصة بك.

نموذج عنوان Webhook
تكوين عنوان URL للـ Webhook

يتيح لك قسم معلمة الاستعلام إضافة معلمات مخصصة إلى عنوان URL للـ webhook. على سبيل المثال، إذا كنت تقوم بإرسال webhook من نماذج متعددة، يمكنك إضافة معلمة {{Form Id}} إلى عنوان URL الخاص بك للتمييز بسهولة بين مصدر استدعاء webhook معين.

التفويض والمصادقة

يمكنك تكوين webhook الخاص بك لتضمين رمز حامل سري أو رمز وصول لتفويض الاستدعاءات. يمكنك إجراء المصادقة الأساسية باستخدام تسجيل الدخول وكلمة المرور أو تضمين مفاتيح API مع رؤوس المصادقة.

رؤوس مخصصة

يمكنك أيضاً تضمين رؤوس مخصصة في نقاط نهاية webhook الخاصة بك. يمكن أن تكون مفاتيح الرأس سلاسل نصية أو أرقاماً ولا يمكن أن تتضمن مسافات أو أحرفاً غير صالحة.

جسم الطلب

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

جسم طلب webhook

قد تحتوي الحمولة على بيانات وصفية للنموذج (مثل معرف النموذج ومعرف الاستجابة وعنوان URL لتحرير الاستجابة) وإجابات المستخدم. يجب إضافة كل سؤال كمفتاح وقيمة جديدة في جسم الطلب مع عنوان الإجابة محاطاً بأقواس معقوفة مزدوجة.

بعد الانتهاء من تعريف webhook الخاص بك، انقر على زر الاختبار وستقوم الإضافة بإجراء طلب HTTP إلى عنوان URL للاستدعاء باستخدام بيانات النموذج من أحدث استجابة تم استلامها لنموذج Google الخاص بك.

انقر على حفظ لتمكين webhook.