خطافات الويب الواردة
الويب هوك الوارد هو أداة قوية لاستقبال البيانات من أي مكان إلى الدردشة بوت عبر طلب POST.
مع webhooks الواردة، يمكن لروبوتك حتى بدء محادثة مع مستخدم روبوت لم يتحدث إليه من قبل.
على سبيل المثال، عندما يملأ العميل معلومات الاتصال الخاصة به على موقعك، ترسل البيانات إلى رابط ويب وارد في روبوت دردشة، مثل روبوت SMS. يمكن لروبوت الرسائل النصية إرسال رسالة تأكيد إلى رقم هاتف العميل.
إذا كان ذلك الرابط مدمج في بوت صوتي، يمكنه حتى الاتصال بالعميل فورا!
القيود - كل بوت لديه حتى 5 وصلات ويب واردة، وحدود المعدل هي 500 طلب لكل 24 ساعة. تعمل إعادة التعيين كما يلي:
بعد 24 ساعة من الطلب الأول. هناك طابع زمني في رؤوس الردود يمكنك التحقق منه.
الحد الأقصى هو لكل 24 ساعة، وليس يوميا، لذا لا يتم إعادة ضبطه في وقت محدد
إنشاء هوك ويب وارد
متوفر في معظم القنوات، في أداة بناء التدفق الخاصة بك، اذهب إلى الأدوات - Inbound Webhooks:
انقر على Webhook الوارد الجديد، أعط اسما واضغط على حفظ:
سترى واجهة التحرير بهذا الشكل:
عنوان الويبهوك
تظهر لك هذه المنطقة مكان إرسال البيانات والطريقة، وهي POST. كل webhook وارد له رابط فريد في نظام NewAge Ai بأكمله.
مثال على JSON المستلم
تعرض هذه المنطقة نموذجا لملف JSON للرجوع إليه. يصف هيكل البيانات في JSON الذي استلمناه لاحقا. نحتاجه لإيجاد القيم لكل من **تعريف المستخدم ** والبيانات المراد حفظها.
هناك طريقتان للحصول على مثال JSON:
- اكتب أو لصقها يدويا هنا
- استمع إلى بيانات فورية من اختبار مباشر
القيم التي يجب تحديد المستخدم
كلما استقبل webhook بيانات، يبدأ أولا بفحص المسارات التي تحددها هنا ليرى ما إذا كان بإمكانه العثور على مستخدم موجود في الدردشة الروبوت.
إذا لم يكن المستخدم موجودا في النظام، يقوم روبوت الدردشة بإنشاء ملف تعريف جديد. هكذا يبدأ روبوت الدردشة المحادثة دون التحدث مع المستخدم من قبل.
ومع ذلك، بعض القنوات لا تسمح لروبوت الدردشة ببدء المحادثة أولا بسبب مشاكل الخصوصية والرسائل المزعجة.
على سبيل المثال، يمكن لروبوت الرسائل النصية إرسال رسائل طالما لديك رقم هاتف المستلم، بينما لا يمكن لروبوت الدردشة على فيسبوك ماسنجر إرسال رسائل إلى مستخدم فيسبوك لم يتحدث إليه من قبل.
عملية تحديد هوية المستخدم
هذه هي عملية كيفية تحديد النظام للمستخدم:
- تم التحقق
user_ns- إذا كان هناك ، وجد المستخدم صالحا
user_ns. - إذا لم يكن كذلك، فالخطوة التالية
- إذا كان هناك ، وجد المستخدم صالحا
- تحقق
phone/email- إذا استطعنا إيجاد مستخدم بواسطة ال
phoneأوemail، وجد المستخدم. - إذا لم يكن كذلك، فالخطوة التالية
- إذا استطعنا إيجاد مستخدم بواسطة ال
- verify
phone- لم يتم مطابقة أي مستخدم في النظام، هل الرقم
phoneصالح؟ - إذا كان الجواب نعم، تم إنشاء ملف تعريف المستخدم.
- إذا لم يكن كذلك، فلن يتم معالجة Webhook
- لم يتم مطابقة أي مستخدم في النظام، هل الرقم
منطقة رسم الخرائط
تظهر قائمة التعيين أي قيمة يجب تخزينها في أي حقل مخصص. عندما تحصل على نموذج JSON في المنطقة أعلاه، انقر على Preview Payload للحصول على أداة رسم الخرائط.
سجلات الويبهوك
يتم حفظ كل طلب في السجلات. انقر على سجل لرؤية بيانات JSON المستلمة.
الحد من هوك الويب الوارد
افتراضيا، حدود طلب الويبهوك الواردة هي 500 طلب لكل 24 ساعة. يمكنك رؤية الحدود من لقطة الشاشة أدناه:
إذا تجاوزت الحدود، لديك خيار الترقية إلى عدد أكبر من الطلبات يوميا، إليك قائمة بالخيارات المتاحة لديك:
- 500 في اليوم - مشمول ~~ 15 ألف طلب/شهريا
- 1000 دولار يوميا - 20 دولارا في الشهر ~~ 30 ألف طلب شهريا
- 2000/يوم - 40 دولار في الشهر ~~ 60 ألف طلب/شهريا
- 3000 دولار يوميا - 60 دولارا شهريا ~~ 90 ألف طلب/شهريا
- 4000 دولار يوميا - 80 دولار شهريا ~~ 120 ألف طلب شهريا
- 5000 في اليوم - 100 دولار شهريا ~~ 150 ألف طلب/شهريا
- 10000 طلب/يوم - 200 دولار شهريا ~~ 300 ألف طلب/شهريا
يمكنك الاشتراك من الرابط أدناه:
الرابط هو 20 دولارا شهريا لكل وحدة، إذا كنت تحتاج إلى 1000 طلب يوميا، فقط اختر الكمية 1؛
إذا كنت تحتاج إلى 2000 طلب يوميا، فقط اختر الرقم 2، وهكذا
بعد الدفع، تحتاج إلى تقديم إيصال الدفع وملف التدفق إلى بريد الدعم NewAge Ai على ticket@NewAge Ai.com.au
إليك كيف يمكنك العثور على ملف الطيران الخاص بك،
اذهب إلى "جميع البوتات" في لوحة NewAge Ai ، ثم ابحث عن البوت الذي تريد زيادة حدود طلبات webhook الواردة، ثم انقر على القائمة المنسدلة، ستجد ملف flowNS.
فيديو تعليمي
كيفية تصحيح خطأ طلب الحد الأقصى من طلب الويب هوك الوارد
أولا، إذا لم تكن تستقبل البيانات في webhook الوارد، أو لم تتمكن من العثور عليها في السجلات، فمن المحتمل جدا أنك وصلت إلى الحد الأقصى لعدد الطلبات اليومية.
إليك كيف يمكنك اختباره.
يمكنك إرسال الطلب إلى الويبهوك الوارد من Postman أو NewAge Ai طلب خارجي، ثم يمكنك العثور على المعلومات أدناه في الرأس:
كما ترى، هناك حد معدل متبقي، إذا كان 0، فهذا يعني أنك وصلت بالفعل إلى حدود المعدل، يجب عليك الترقية للحصول على المزيد من القيود.
العرض التجريبي: تأكيد الحجز
أداة مثالية لاختبار webhook الوارد لديك مدمج بالفعل في كل مكان! ببساطة احصل على روبوت دردشة (أي قناة)، وجربه في Action Step.
افتح صفحة ويب NewAge Ai أخرى جنبا إلى جنب، احتفظ بتحرير webhook الوارد في الصفحة 1 واختر طلبا خارجيا في الصفحة 2:
اتبع الخطوات من 1 إلى 8 في لقطة الشاشة التالية:
قدم البيانات التي يجب إرسالها إلى روبوت الدردشة واضغط على اختبار، يجب أن تحصل على خطأ "webhook غير نشط" لأننا لم نقم بتفعيله بعد. لا بأس، انقر على تم الانتهاء في الصفحة 1، وسترى البيانات محفوظة:
قم بالتمرير قليلا للأسفل واتبع الخطوات 1، 2، 3 لتخبر النظام بمكان قيم و phone email في ملف JSON:
وأخيرا، قم بربط باقي البيانات بروبوت الدردشة:
احفظ تحرير الويبهوك الوارد:
ادخل التدفق الفرعي، لنرسل رسالة إلى مستخدم البوت:
انشر التدفق ولنقم باختبار مباشر في الطلب الخارجي مرة أخرى:
يمكننا أن نرى أن هذه المرة تم تشغيله بدون خطأ لأننا فعلنا webhook واستخدمنا رقم هاتف حقيقي. اذهب إلى السجلات ونرى أن ملف تعريف المستخدم الجديد تم إنشاؤه بنجاح.
من جانب المستخدم:
الأسئلة الشائعة
هل الرابط الداخلي للويب هوك لا يعمل على النطاق المخصص لشريكك؟
في الحالات التي تتوقف فيها الروابط الواردة تحت نطاق شريكك المخصص عن العمل، بينما تحت نطاق NewAge Ai تعمل بشكل صحيح.
قد تكون المشكلة في إعدادات CloudFlare لديك.
أحيانا يكتشف Cloudflare تلقائيا الطلبات إلى نطاقك ويصفها بأنها هجمات من روبوتات. هذا يمنع الطلبات القادمة إلى هذه الهوك الوارد لفترة زمنية معينة.
لتجنب ذلك، اذهب إلى إعداداتك داخل لوحة تحكم Cloudflare، وتحت تبويب الأمان، قم بإيقاف "وضع قتال الروبوت".
سيساعدك ذلك على التوقف عن تصنيف الطلبات المقدمة إلى webhooks على أنها هجمات بوتات، وستبدأ الروابط الواردة في العمل مجددا
ملاحظة: سبب آخر لتوقف الهوك عن العمل هو وصولها إلى عتبة يومية. لذا تحقق دائما من أن الحدود ليست على الحد الأقصى