توضّح هذه الصفحة كيفية إعداد ردّ تلقائي على الويب لإرسال الرسائل غير المتزامنة إلى مساحة Chat تستخدم عوامل تشغيل خارجية على سبيل المثال، يمكنك إعداد تطبيق مراقبة لإبلاغ الموظفين عند الطلب على إجراء محادثة عند تعطل أحد الخوادم لإرسال رسالة متزامنة باستخدام تطبيق Chat، يمكنك الاطّلاع على إرسال رسالة
مع هذا النوع من الهندسة التصميم، لا يمكن للمستخدمين التفاعل مع الرد التلقائي على الويب أو العناصر الخارجية التطبيق لأن التواصل أحادي الاتجاه. الردود التلقائية على الويب ليست محادثة. لا يمكنهم الرد على رسائل أو تلقّيها من المستخدمين أو أحداث التفاعل مع تطبيقات Chat للردّ على الرسائل، يُرجى اتّباع الخطوات التالية: إنشاء تطبيق في Chat بدلاً من الرد التلقائي على الويب.
على الرغم من أن الرد التلقائي على الويب ليس من الناحية الفنية تطبيق Chat — تعمل الردود التلقائية على الويب على ربط التطبيقات باستخدام طلبات HTTP: تشير هذه الصفحة إلى التطبيق على أنه تطبيق Chat التبسيط. لا يعمل كل ردّ تلقائي على الويب إلا في "مساحة Chat" في التي تم تسجيلها. تعمل الردود التلقائية الواردة على الويب في الرسائل المباشرة، ولكن فقط عندما لدى جميع المستخدمين تفعيل تطبيقات Chat لا يمكنك نشر الردود التلقائية على الويب في Google Workspace Marketplace.
يوضح الرسم البياني التالي بنية الرد التلقائي على الويب المتصل الدردشة:
في المخطّط السابق، يتضمّن تطبيق Chat ما يلي: تدفق المعلومات:
- يتلقّى منطق تطبيق Chat المعلومات من خدمات الجهات الخارجية الخارجية، مثل نظام إدارة المشروعات أو أداة بيع التذاكر.
- تتم استضافة منطق تطبيق Chat في سحابة إلكترونية أو نظام داخل الشركة يمكنه إرسال الرسائل من خلال استخدام عنوان URL للرد التلقائي على الويب إلى مساحة Chat محددة.
- يمكن للمستخدمين تلقّي الرسائل من تطبيق Chat في "مساحة Chat" هذه، ولكن لا يمكنهم التفاعل مع تطبيق Chat
المتطلبات الأساسية
Python
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat يجب أن تسمح مؤسستك على Google Workspace للمستخدمين. إضافة الردود التلقائية الواردة على الويب واستخدامها
- Python 3.6 أو أعلى
- أداة إدارة حزم pip
مكتبة
httplib2
. لتثبيت المكتبة، شغِّل الأمر التالي في واجهة سطر الأوامر:pip install httplib2
مساحة Google Chat لإنشاء حساب باستخدام Google Chat API، يُرجى الاطّلاع على أنشئ مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
Node.js
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat يجب أن تسمح مؤسستك على Google Workspace للمستخدمين. إضافة الردود التلقائية الواردة على الويب واستخدامها
- الإصدار 14 من Node.js أو الإصدارات الأحدث
- npm أداة إدارة الحِزم
- مساحة Google Chat لإنشاء حساب باستخدام Google Chat API، يُرجى الاطّلاع على أنشئ مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
Java
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat يجب أن تسمح مؤسستك على Google Workspace للمستخدمين. إضافة الردود التلقائية الواردة على الويب واستخدامها
- Java 11 أو إصدار أحدث
- أداة إدارة حزم Maven
- مساحة Google Chat لإنشاء حساب باستخدام Google Chat API، يُرجى الاطّلاع على أنشئ مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
برمجة تطبيقات
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat يجب أن تسمح مؤسستك على Google Workspace للمستخدمين. إضافة الردود التلقائية الواردة على الويب واستخدامها
- إنشاء مشروع "برمجة تطبيقات Google" مستقل وفعِّل خدمة المحادثة المتقدّمة.
- مساحة Google Chat لإنشاء حساب باستخدام Google Chat API، يُرجى الاطّلاع على أنشئ مساحة. لإنشاء تطبيق في Chat، اتّبِع الخطوات التالية: يُرجى زيارة مستندات مركز المساعدة
إنشاء ردّ تلقائي على الويب
لإنشاء ردّ تلقائي على الويب، سجِّله في مساحة Chat التي تريدها. لتلقي الرسائل، ثم كتابة نص برمجي يرسل الرسائل.
تسجيل الرد التلقائي الوارد على الويب
- في المتصفّح، افتح الدردشة لا يمكن ضبط الردود التلقائية على الويب من تطبيق Chat المتوافق مع الأجهزة الجوّالة.
- انتقِل إلى المساحة التي تريد إضافة ردّ تلقائي على الويب فيها.
- بجانب عنوان المساحة، انقر على الرمز سهم توسيع المزيد، ثم انقر على التطبيقات & عمليات الدمج.
انقر على
إضافة ردود تلقائية على الويب.في حقل الاسم، أدخِل
Quickstart Webhook
.في حقل عنوان URL للصورة الرمزية، أدخل
https://developers.google.com/chat/images/chat-product-icon.png
انقر على حفظ.
لنسخ عنوان URL للردّ التلقائي على الويب، انقر على
المزيد، ثم انقر على نسخ الرابط
كتابة نص الردّ التلقائي على الويب
يرسل مثال النص البرمجي للردّ التلقائي على الويب رسالة إلى المساحة التي يتم فيها الرد التلقائي على الويب
تم التسجيل عن طريق إرسال طلب POST
إلى عنوان URL للرد التلقائي على الويب. تشير رسالة الأشكال البيانية
تستجيب Chat API باستخدام مثيل
Message
اختَر لغة لمعرفة كيفية إنشاء نص برمجي للردّ التلقائي على الويب:
Python
في دليل العمل، أنشِئ ملفًا باسم "
quickstart.py
".في
quickstart.py
، الصق الرمز التالي:استبدِل قيمة المتغيّر
url
بعنوان URL للردّ التلقائي على الويب الذي الذي نسخته عند تسجيل الرد التلقائي على الويب.
Node.js
في دليل العمل، أنشِئ ملفًا باسم "
index.js
".في
index.js
، الصق الرمز التالي:استبدِل قيمة المتغيّر
url
بعنوان URL للردّ التلقائي على الويب الذي الذي نسخته عند تسجيل الرد التلقائي على الويب.
Java
في دليل العمل، أنشِئ ملفًا باسم "
pom.xml
".في
pom.xml
، انسخ والصق ما يلي:في دليل العمل، أنشِئ بنية الدليل التالية.
src/main/java
في دليل
src/main/java
، أنشِئ ملفًا باسمApp.java
.في
App.java
، الصق الرمز التالي:استبدِل قيمة المتغيّر
URL
بعنوان URL للردّ التلقائي على الويب الذي نسخته تم نسخه عند تسجيل الرد التلقائي على الويب.
برمجة تطبيقات
في المتصفِّح، انتقِل إلى برمجة التطبيقات:
انقر على مشروع جديد.
ألصق الرمز التالي:
استبدِل قيمة المتغيّر
url
بعنوان URL للردّ التلقائي على الويب الذي نسخته تم نسخه عند تسجيل الرد التلقائي على الويب.
تشغيل النص البرمجي للردّ التلقائي على الويب
في سطر الأوامر، شغِّل النص البرمجي:
Python
python3 quickstart.py
Node.js
node index.js
Java
mvn compile exec:java -Dexec.mainClass=App
برمجة تطبيقات
- انقر على تشغيل.
عند تشغيل الرمز، يرسل الرد التلقائي على الويب رسالة إلى المساحة التي سجّلته.
بدء سلسلة رسائل أو الرد عليها
يُرجى التحديد
spaces.messages.thread.threadKey
كجزء من نص طلب الرسالة. اعتمادًا على ما إذا كنت تبدأ أو الرد على سلسلة محادثات، واستخدام القيم التالية لـthreadKey
:في حال بدء سلسلة محادثات، اضبط السمة
threadKey
على سلسلة عشوائية، ولكن دوّن هذه القيمة لنشر رد على سلسلة المحادثات.في حال الردّ على سلسلة محادثات، حدِّد
threadKey
الذي تم ضبطه عند تم بدء سلسلة المحادثات. فعلى سبيل المثال، لنشر رد على سلسلة المحادثات حيث الرسالة الأولية المستخدمةMY-THREAD
، المجموعةMY-THREAD
.
يمكنك تحديد سلوك سلسلة المحادثات في حال عدم العثور على سمة
threadKey
المحدّدة:الرد على سلسلة محادثات أو بدء سلسلة محادثات جديدة إضافة
messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD
معلمة إلى عنوان URL للرد التلقائي على الويب. يؤدي تمرير مَعلمة عنوان URL هذه إلى تفعيل Chat. للبحث عن سلسلة محادثات حالية باستخدام القيمةthreadKey
المحددة. إذا كانت إحدى فسيتم العثور على مشاركات الرسالة كرد على سلسلة المحادثات هذه. إذا لم يكن أي منها عند العثور على الرسالة، تبدأ الرسالة سلسلة محادثات جديدة تتوافق مع ذلكthreadKey
الرد على سلسلة محادثات أو عدم اتخاذ أي إجراء إضافة مَعلمة
messageReplyOption=REPLY_MESSAGE_OR_FAIL
إلى عنوان URL للردّ التلقائي على الويب. يؤدي تمرير مَعلمة عنوان URL هذه إلى تفعيل Chat. للبحث عن سلسلة محادثات حالية باستخدام القيمةthreadKey
المحددة. إذا كانت إحدى فسيتم العثور على مشاركات الرسالة كرد على سلسلة المحادثات هذه. إذا لم يكن أي منها لذلك، فلن يتم إرسال الرسالة.
لمزيد من المعلومات، يُرجى الاطّلاع على
messageReplyOption
.
يبدأ نموذج الرمز التالي أو يرد على سلسلة محادثات: