توضِّح هذه الصفحة كيفية إعداد ردّ تلقائي على الويب لإرسال رسائل غير متزامنة إلى مساحة Chat باستخدام عوامل تشغيل خارجية. على سبيل المثال، يمكنك ضبط تطبيق مراقبة لإبلاغ الموظفين المسجَّلين على Chat عند تعطُّل الخادم. لإرسال رسالة متزامنة باستخدام تطبيق Chat، راجِع مقالة إرسال رسالة.
باستخدام هذا النوع من تصميم البنية، لا يمكن للمستخدمين التفاعل مع الرد التلقائي على الويب أو التطبيق الخارجي المرتبط لأن التواصل أحادي الاتجاه. الردّ التلقائي على الويب ليس حواريًا. لا يمكن للمستخدمين الرد على الرسائل أو تلقّيها من المستخدمين أو أحداث التفاعل مع تطبيق Chat. للرد على الرسائل، عليك إنشاء تطبيق Chat بدلاً من ردّ تلقائي على الويب.
على الرغم من أنّ الردّ التلقائي على الويب ليس من تطبيقات Chat من الناحية الفنية، تربط الردود التلقائية على الويب التطبيقات باستخدام طلبات HTTP العادية، إلا أنّ هذه الصفحة تشير إليه على أنّه تطبيق Chat للتبسيط. لا يعمل كل ردّ تلقائي على الويب إلا في "مساحة Chat" التي يتم تسجيله فيها. تعمل الردود التلقائية الواردة على الويب في الرسائل المباشرة، ولكن فقط عند تفعيل تطبيقات Chat لجميع المستخدمين. لا يمكنك نشر الردود التلقائية على الويب في Google Workspace Marketplace.
يعرض المخطّط التالي بنية الرد التلقائي على الويب المرتبط بـ Chat:
في المخطّط السابق، يتضمّن تطبيق Chat تدفق المعلومات التالي:
- يتلقّى منطق تطبيق Chat معلومات من خدمات خارجية، مثل نظام إدارة مشاريع أو أداة تذاكر.
- تتم استضافة منطق تطبيق Chat إمّا في سحابة إلكترونية أو نظام داخل المؤسسة يمكنه إرسال الرسائل باستخدام عنوان URL للردّ التلقائي على الويب إلى مساحة Chat محدّدة.
- ويمكن للمستخدمين تلقّي الرسائل من تطبيق Chat في مساحة Chat المحدّدة هذه، ولكن لا يمكنهم التفاعل مع تطبيق Chat.
المتطلبات الأساسية
Python
- حساب على Google Workspace يمكنه الوصول إلى Chat على مؤسستك في Google Workspace السماح للمستخدمين بإضافة الردود التلقائية الواردة على الويب واستخدامها.
- Python 3.10.7 أو أحدث.
مكتبة "
httplib2
" إذا لزم الأمر، شغِّل أمر واجهة سطر الأوامر (CLI) التالي لتثبيت المكتبة باستخدامpip
:pip install httplib2
مساحة Chat حالية
Node.js
- حساب على Google Workspace يمكنه الوصول إلى Chat على مؤسستك في Google Workspace السماح للمستخدمين بإضافة الردود التلقائية الواردة على الويب واستخدامها.
- Node.js وnpm تم تثبيته.
- مساحة Chat حالية
Java
- حساب على Google Workspace يمكنه الوصول إلى Chat تسمح مؤسستك في Google Workspace للمستخدمين بإضافة الردود التلقائية الواردة على الويب واستخدامها.
- Java 11 أو إصدار أحدث.
- Apache Maven
- مساحة Chat حالية
برمجة تطبيقات
- حساب على Google Workspace يمكنه الوصول إلى Chat تسمح مؤسستك في Google Workspace للمستخدمين بإضافة الردود التلقائية الواردة على الويب واستخدامها.
- مساحة Chat حالية
إنشاء ردّ تلقائي على الويب
لإنشاء ردّ تلقائي على الويب، عليك تسجيله في "مساحة 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
.
يبدأ نموذج الرمز البرمجي التالي في سلسلة رسائل أو يرد عليها: