Share via

مفاهيم الدردشة

  • مقالة

يمكن أن تساعدك Azure Communication Services Chat في إضافة اتصال نصي في الوقت الحقيقي إلى تطبيقاتك عبر الأنظمة الأساسية. تلخص هذه الصفحة مفاهيم الدردشة الرئيسية وقدراتها. راجع نظرة عامة على Communication Services Chat Software Development Kit (SDK) للحصول على قوائم SDKs واللغات والأنظمة الأساسية ودعم الميزات التفصيلي.

توفر واجهات برمجة تطبيقات الدردشة خدمة تحجيم تلقائي لاتصالات النصوص والبيانات المخزنة باستمرار. وتشمل الميزات الرئيسية الأخرى ما يلي:

  • الهوية والعنوان المخصصان - توفر Azure Communication Services هويات عامة لمعالجة نقاط نهاية الاتصال. يستخدم العملاء هذه الهويات للمصادقة على خدمة Azure والتواصل مع بعضهم البعض في chat threads التحكم.
  • التشفير - تشفر Chat SDKs نسبة استخدام الشبكة وتمنع العبث على السلك.
  • اجتماعات Microsoft Teams - يمكن ل Chat SDKs الانضمام إلى اجتماعات Teams والتواصل مع رسائل دردشة Teams.
  • الإعلامات في الوقت الحقيقي - تستخدم مجموعات SDK للدردشة اتصالا مستمرا فعالا (WebSockets) لتلقي إعلامات في الوقت الفعلي مثل عندما يكتب مستخدم بعيد. عند تشغيل التطبيقات في الخلفية، تتوفر الوظائف المضمنة لإطلاق الإعلامات المنبثقة ("الإعلامات المنبثقة") لإعلام المستخدمين النهائيين بمؤشرات الترابط والرسائل الجديدة.
  • إمكانية توسعة الروبوت - من السهل إضافة روبوتات Azure إلى خدمة الدردشة مع تكامل Azure Bot.

نظرة عامة على الدردشة

محادثات الدردشة تحدث داخل سلاسل رسائل الدردشة. تحتوي سلاسل رسائل الدردشة على الخصائص التالية:

  • هوية مؤشر ترابط الدردشة هي ChatThreadId.
  • تحتوي مؤشرات ترابط الدردشة على ما بين صفر إلى 250 مستخدما كمشاركين يمكنهم إرسال رسائل إليها.
  • يمكن أن يكون المستخدم جزءا من عدد غير محدود من مؤشرات ترابط الدردشة.
  • يمكن فقط للمشاركين في مؤشر الترابط إرسال رسائل أو تلقيها أو إضافة مشاركين أو إزالة المشاركين.
  • تتم إضافة المستخدمين كمشارك إلى أي مؤشرات ترابط دردشة يقومون بإنشائها.

وصول المستخدم

تدعم Azure Communication Services ثلاثة مستويات من التحكم في وصول المستخدم، باستخدام رموز الدردشة المميزة. راجع الهوية والرموز المميزة للحصول على التفاصيل. لا يملك المشاركون حق الوصول للكتابة إلى الرسائل المرسلة من قبل مشاركين آخرين، مما يعني أن مرسل الرسائل فقط يمكنه تحديث الرسائل المرسلة أو حذفها. إذا حاول مشارك آخر القيام بذلك، يحصل على خطأ.

بيانات الدردشة

تخزن Azure Communication Services مؤشرات ترابط الدردشة وفقا لنهج استبقاء البيانات الساري عند إنشاء مؤشر الترابط. يمكنك تحديث نهج الاستبقاء إذا لزم الأمر أثناء فترة الاستبقاء التي قمت بتعيينها. بعد حذف مؤشر ترابط دردشة (حسب النهج أو بواسطة طلب حذف واجهة برمجة التطبيقات)، لا يمكن استرداده.

هام

الوظائف الموضحة في هذه المقالة موجودة حاليا في المعاينة العامة. يجري توفير إصدار المعاينة هذا دون اتفاقية على مستوى الخدمة، ولا نوصي باستخدامه لأحمال عمل الإنتاج. بعض الميزات ربما لا تكون مدعمة أو بها بعض القدرات المقيدة. لمزيد من المعلومات، راجع ⁧⁩شروط الاستخدام التكميلية لمعاينات Microsoft Azure⁧⁩.

يمكنك الاختيار بين استبقاء مؤشر الترابط إلى أجل غير مسمى، أو الحذف التلقائي بين 30 و90 يوما عبر نهج الاستبقاء على واجهة برمجة تطبيقات إنشاء مؤشر ترابط الدردشة، أو الحذف الفوري باستخدام واجهات برمجة التطبيقات حذف رسالة الدردشة أو حذف مؤشر ترابط الدردشة.

لا يتأثر أي مؤشر ترابط تم إنشاؤه قبل نهج الاستبقاء الجديد إلا إذا قمت بتغيير نهج مؤشر الترابط هذا على وجه التحديد. إذا قمت بإرسال طلب دعم لمحادثة محادثة محذوفة بعد أكثر من 30 يوما من حذف نهج الاستبقاء لسلسلة الرسائل هذه، فلن يمكن استردادها ولن تتوفر أي معلومات حول مؤشر الترابط هذا. إذا لزم الأمر، افتح تذكرة دعم في أسرع وقت ممكن ضمن نافذة 30 يوما بعد إنشاء مؤشر ترابط حتى نتمكن من مساعدتك.

يمكن للمشاركين في سلسلة رسائل الدردشة استخدام ListMessages لعرض محفوظات الرسائل لسلسلة معينة. ListMessages لا يمكن لواجهة برمجة التطبيقات إرجاع محفوظات مؤشر ترابط إذا تم حذف مؤشر الترابط. يمكن للمستخدمين الذين تمت إزالتهم من مؤشر ترابط الدردشة عرض محفوظات الرسائل السابقة ولكن لا يمكنهم إرسال رسائل جديدة أو تلقيها. لا يمكن للنظام استرداد الرسائل المحذوفة عن طريق الخطأ. لمعرفة المزيد حول البيانات التي يتم تخزينها في خدمة دردشة Azure Communication Services، راجع موقع البيانات وصفحة الخصوصية.

بالنسبة للعملاء الذين يستخدمون المواعيد الظاهرية، راجع خصوصية المستخدم في Teams Interoperability لتخزين رسائل الدردشة في اجتماعات Teams.

حدود الخدمة

  • الحد الأقصى لعدد المشاركين المسموح به في سلسلة رسائل دردشة هو 250.
  • الحد الأقصى لحجم الرسالة المسموح به هو 28 كيلوبايت تقريباً.
  • بالنسبة إلى سلاسل الرسائل الخاصة بالدردشة التي تضم أكثر من 20 مشاركاً، لا يتم دعم إيصالات القراءة وميزات مؤشر الكتابة.
  • بالنسبة لسيناريوهات Teams Interop، يجب أن يكون عدد مستخدمي Azure Communication Services، وليس مستخدمي Teams، أقل من 20 حتى يتم دعم ميزة مؤشر الكتابة.
  • عند إنشاء مؤشر ترابط دردشة، يمكنك تعيين نهج الاستبقاء بين 30 و90 يوما.
  • بالنسبة لسيناريوهات Teams Interop، قد يحتوي حدث مؤشر الكتابة على اسم عرض فارغ عند إرساله من مستخدم Teams.
  • بالنسبة لسيناريوهات Teams Interop، لا يتم دعم إيصالات القراءة لمستخدمي Teams.

بنية الدردشة

هناك جزأان أساسيان لبنية الدردشة: 1) خدمة موثوق بها و2) تطبيق العميل.

رسم تخطيطي يوضح بنية الدردشة لخدمات الاتصالات.

  • خدمة موثوق بها: لإدارة جلسة دردشة بشكل صحيح، تحتاج إلى خدمة تساعدك على الاتصال بخدمات الاتصال باستخدام سلسلة اتصال المورد. هذه الخدمة مسؤولة عن إنشاء سلاسل رسائل الدردشة وإضافة المشاركين وإزالتها وإصدار رموز الوصول المميزة للمستخدمين. لمزيد من المعلومات، راجع التشغيل السريع: إنشاء وإدارة رموز الوصول المميزة .
  • تطبيق العميل: يتصل تطبيق العميل بالخدمة الموثوق بها ويتلقى رموز الوصول المميزة التي يحتاجها المستخدمون للاتصال مباشرة بخدمات الاتصالات. بعد إنشاء مؤشر ترابط الدردشة وإضافة مشاركين، يمكنهم استخدام تطبيق العميل للاتصال بسلسلة رسائل الدردشة وإرسال الرسائل. يمكن للمشاركين استخدام الإعلامات في الوقت الحقيقي في تطبيق العميل للاشتراك في تحديثات الرسائل والرسائل من الأعضاء الآخرين.

بناء تجارب دردشة ذكية الذكاء الاصطناعي تعمل بالطاقة

يمكنك استخدام خدمات Azure الذكاء الاصطناعي مع خدمة الدردشة لإنشاء حالات استخدام مثل:

  • مساعدة عامل الدعم على تحديد أولويات التذاكر من خلال اكتشاف شعور سلبي برسالة واردة من أحد العملاء.
  • أنشئ ملخصا في نهاية المحادثة لإرساله إلى العميل عبر البريد الإلكتروني باستخدام الخطوات التالية أو المتابعة في وقت لاحق.
  • أضف Power Virtual Agent (PVA) في قناة دردشة Azure Communication Services باستخدام Azure Bot وروبوت ترحيل.
  • تكوين روبوت للتشغيل على قناة اجتماعية واحدة أو أكثر إلى جانب قناة الدردشة.

رسم تخطيطي يوضح إمكانية إقران Azure Communication Services بخدمات Azure الذكاء الاصطناعي.

أنواع الرسائل

كجزء من محفوظات الرسائل، تشارك الدردشة الرسائل التي أنشأها المستخدم والرسائل التي أنشأها النظام.

يتم إنشاء رسائل النظام عند

  • يتم تحديث مؤشر ترابط الدردشة
  • تمت إضافة مشارك أو إزالته
  • تم تحديث موضوع مؤشر ترابط الدردشة.

عند الاتصال List Messages أو Get Messages على مؤشر ترابط دردشة، تحتوي النتيجة على نوعي الرسائل بترتيب زمني. بالنسبة للرسائل التي أنشأها المستخدم، يمكن تعيين SendMessageOptions نوع الرسالة عند إرسال رسالة إلى مؤشر ترابط الدردشة. إذا لم يتم توفير أي قيمة، فإن Communication Services افتراضيا للكتابة text . يعد تعيين هذه القيمة مهماً عند إرسال HTML. عند html تحديدها، تقوم Communication Services بتعقيم المحتوى للتأكد من أنه يتم عرضه بأمان على أجهزة العميل.

  • text: رسالة نصية عادية يتم تأليفها وإرسالها من قبل مستخدم كجزء من سلسلة دردشة.
  • html: رسالة منسقة باستخدام html، يتم تأليفها وإرسالها من قبل مستخدم كجزء من موضوع الدردشة.

أنواع رسائل النظام:

  • participantAdded: رسالة النظام التي تشير إلى وجود مشارك واحد أو أكثر في مؤشر ترابط الدردشة.
  • participantRemoved: رسالة من النظام تُشير إلى إزالة مشارك من سلسلة رسائل الدردشة.
  • topicUpdated: رسالة النظام التي تشير إلى تحديث موضوع مؤشر الترابط.

الإخطارات في الوقت الحقيقي

يدعم JavaScript Chat SDK الإعلامات في الوقت الحقيقي. تتيح هذه الميزة للعملاء الاستماع إلى خدمات الاتصال للحصول على تحديثات في الوقت الفعلي والرسائل الواردة إلى سلاسل رسائل الدردشة دون الحاجة إلى استقصاء واجهات برمجة التطبيقات.

يمكن لتطبيق العميل الاشتراك في الأحداث التالية:

  • chatMessageReceived - عندما يتم إرسال رسالة جديدة إلى موضوع دردشة من قبل أحد المشاركين.
  • chatMessageEdited - عندما يتم تحرير رسالة في سلسلة رسائل الدردشة.
  • chatMessageDeleted - عند حذف رسالة في سلسلة رسائل الدردشة.
  • typingIndicatorReceived - عندما يرسل مشارك آخر مؤشر الكتابة إلى سلسلة رسائل الدردشة.
  • readReceiptReceived - عندما يرسل مشارك آخر إيصال قراءة لرسالة قرأها.
  • chatThreadCreated - عندما يقوم مستخدم Communication Services بإنشاء مؤشر ترابط دردشة.
  • chatThreadDeleted - عندما يحذف مستخدم Communication Services مؤشر ترابط دردشة.
  • chatThreadPropertiesUpdated - عندما يتم تحديث خصائص سلسلة رسائل الدردشة؛ حالياً، يتم فقط اعتماد تحديث الموضوع لسلسلة الرسائل.
  • participantsAdded - عندما تتم إضافة مستخدم كمشارك في موضوع سلسلة رسائل الدردشة.
  • participantsRemoved - عند إزالة مشارك موجود من سلسلة رسائل الدردشة.
  • realTimeNotificationConnected - عند توصيل الإعلام في الوقت الحقيقي.
  • realTimeNotificationDisconnected -عند قطع اتصال الإعلام في الوقت الحقيقي.

إشعار

لا يتم استخدام الإعلامات في الوقت الحقيقي مع تطبيقات الخادم.

أحداث الخادم

تتيح هذه الميزة لتطبيقات الخادم الاستماع إلى أحداث مثل وقت إرسال رسالة وعندما ينضم أحد المشاركين إلى الدردشة أو يغادرها. يمكن أن تتفاعل تطبيقات الخادم مع هذه الأحداث، وإضافة/إزالة المشاركين إلى الدردشة، وأرشفة الدردشات، وإجراء التحليل، والعديد من السيناريوهات الأخرى للتنسيق. لمعرفة أنواع أحداث الدردشة التي يمكن للمطورين استخدامها، راجع أحداث الخادم.

الإعلامات

تدعم Android وiOS Chat SDKs الإعلامات المنبثقة. لإرسال إعلامات مؤقتة للرسائل الفائتة من قبل المشاركين أثناء وجودهم بالخارج، قم بتوصيل مورد مركز الإعلامات بمورد Communication Services لإرسال إعلامات مؤقتة. يؤدي القيام بذلك إلى إعلام المشاركين في التطبيق بالدردشات والرسائل الواردة عندما لا يكون تطبيق الأجهزة المحمولة قيد التشغيل في المقدمة.

يدعم IOS وAndroid SDK الحدث أدناه:

  • chatMessageReceived - عندما يرسل مشارك رسالة جديدة إلى مؤشر ترابط دردشة.

يدعم Android SDK الأحداث الإضافية:

  • chatMessageEdited - عندما يقوم أحد المشاركين بتحرير رسالة في مؤشر ترابط دردشة.
  • chatMessageDeleted - عندما يحذف أحد المشاركين رسالة في مؤشر ترابط دردشة.
  • chatThreadCreated - عندما يقوم مستخدم Communication Services بإنشاء مؤشر ترابط دردشة.
  • chatThreadDeleted - عندما يحذف مستخدم Communication Services مؤشر ترابط دردشة.
  • chatThreadPropertiesUpdated - عند تحديث خصائص مؤشر ترابط الدردشة؛ حاليا، يتم دعم تحديث موضوع مؤشر الترابط فقط.
  • participantsAdded - عند إضافة مشارك إلى مؤشر ترابط دردشة.
  • participantsRemoved - عند إزالة مشارك موجود من مؤشر ترابط الدردشة.

لمزيد من المعلومات، راجع الإعلامات المنبثقة.

إشعار

يتوفر حاليا إرسال إعلامات دفع الدردشة باستخدام Notification Hub بشكل عام في إصدار Android 1.1.0 وفي إصدار IOS 1.3.0.

الخطوات التالية

بدء العمل مع الدردشة