Megosztás a következőn keresztül:


Csevegéssel kapcsolatos alapfogalmak

Az Azure Communication Services Chat segítségével valós idejű szöveges kommunikációt adhat a platformfüggetlen alkalmazásokhoz. Ez a lap a csevegés legfontosabb fogalmait és képességeit foglalja össze. Az SDK-k, a nyelvek, a platformok és a funkciók részletes támogatásának listáját a Communication Services csevegőszoftver-fejlesztői készlet (SDK) áttekintésében találja.

A Csevegő API-k automatikus skálázási szolgáltatást biztosítanak az állandóan tárolt szövegekhez és adatkommunikációhoz. További fontos funkciók:

  • Egyéni identitás és címzés – Az Azure Communication Services általános identitásokat biztosít a kommunikációs végpontok kezeléséhez. Az ügyfelek ezeket az identitásokat használják az Azure-szolgáltatásban való hitelesítéshez és az Ön által felügyelt egymással való kommunikációhoz chat threads .
  • Titkosítás – A csevegési SDK-k titkosítják a forgalmat, és megakadályozzák a vezeték illetéktelen illetéktelen használatát.
  • Microsoft Teams-értekezletek – A csevegési SDK-k csatlakozhatnak a Teams-értekezletekhez, és kommunikálhatnak a Teams csevegőüzeneteivel.
  • Valós idejű értesítések – A csevegési SDK-k hatékony állandó kapcsolatot (WebSocketeket) használnak valós idejű értesítések fogadásához, például amikor egy távoli felhasználó gépel. Ha az alkalmazások a háttérben futnak, a beépített funkciókkal előugró értesítéseket ("bejelentéseket") hozhat létre, hogy tájékoztassa a végfelhasználókat az új szálakról és üzenetekről.
  • Robot bővíthetősége – Azure-robotok egyszerűen hozzáadhatóak a csevegőszolgáltatáshoz az Azure Bot-integrációval.

Csevegés áttekintése

A csevegések csevegési szálakon belül zajlnak. A csevegési szálak a következő tulajdonságokkal rendelkeznek:

  • A csevegési szál identitása az .ChatThreadId
  • A csevegési szálak résztvevői nulla és 250 felhasználó között lehetnek, akik üzeneteket küldhetnek neki.
  • A felhasználó korlátlan számú csevegési szál része lehet.
  • Csak a szál résztvevői küldhetnek vagy fogadhatnak üzeneteket, adhatnak hozzá résztvevőket vagy távolíthatnak el résztvevőket.
  • A rendszer résztvevőként hozzáadja a felhasználókat az általuk létrehozott csevegési szálakhoz.

Felhasználói hozzáférés

Az Azure Communication Services három szintű felhasználói hozzáférés-vezérlést támogat a csevegési jogkivonatok használatával. Részletekért tekintse meg az identitást és a jogkivonatokat . A résztvevők nem rendelkeznek írási hozzáféréssel a többi résztvevő által küldött üzenetekhez, ami azt jelenti, hogy csak az üzenet feladója frissítheti vagy törölheti az elküldött üzeneteket. Ha egy másik résztvevő megpróbálja ezt megtenni, hibaüzenetet kap.

Csevegési adatok

Az Azure Communication Services a csevegési szálakat a szál létrehozásakor érvényben lévő adatmegőrzési szabályzatnak megfelelően tárolja. Szükség esetén frissítheti a megőrzési szabályzatot a beállított megőrzési idő alatt. Miután törölt egy csevegési szálat (szabályzat vagy DELETE API-kérés alapján), nem kérhető le.

Fontos

A cikkben ismertetett funkciók jelenleg nyilvános előzetes verzióban érhetőek el. Ez az előzetes verzió szolgáltatásszintű szerződés nélkül érhető el, és éles számítási feladatokhoz nem javasoljuk. Előfordulhat, hogy néhány funkció nem támogatott, vagy korlátozott képességekkel rendelkezik. További információ: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.

A csevegési szál létrehozása API megőrzési szabályzatán keresztül 30 és 90 nap közötti automatikus törlés, vagy azonnali törlés között választhat a csevegőüzenet törlése vagy a csevegési szál törlése API-k használatával.

Az új adatmegőrzési szabályzat előtt létrehozott szálakra csak akkor lesz hatással, ha kifejezetten módosítja az adott szálra vonatkozó házirendet. Ha a törölt csevegőszálra vonatkozó támogatási kérelmet több mint 30 nappal azután küldi el, hogy az adatmegőrzési szabályzat törölte a szálat, az többé nem kérhető le, és nem áll rendelkezésre információ a szálról. Szükség esetén a szál létrehozása után a lehető leggyorsabban nyisson meg egy támogatási jegyet a 30 napos ablakban, hogy segíthessünk Önnek.

A csevegőszál résztvevői ListMessages megtekinthetik egy adott szál üzenetelőzményeit. Az ListMessages API nem tudja visszaadni egy szál előzményeit, ha a szál törölve van. A csevegőszálból eltávolított felhasználók megtekinthetik a korábbi üzenetelőzményeket, de nem tudnak új üzeneteket küldeni vagy fogadni. A véletlenül törölt üzeneteket a rendszer nem tudja helyreállítani. Az Azure Communication Services csevegőszolgáltatásban tárolt adatokkal kapcsolatos további információkért tekintse meg az adattárolási és adatvédelmi oldalt.

A virtuális találkozókat használó ügyfelek számára tekintse meg a Teams együttműködési felhasználói adatvédelmi nyilatkozatát a csevegőüzenetek Teams-értekezletekben való tárolásához.

Szolgáltatáskorlátok

  • A csevegési szálakban engedélyezett résztvevők maximális száma 250.
  • Az üzenet maximális mérete körülbelül 28 KB.
  • A 20-nál több résztvevőt tartalmazó csevegési szálak esetében az olvasási visszaigazolások és a gépelésjelző funkciók nem támogatottak.
  • A Teams Interop-forgatókönyvek esetében az Azure Communication Services-felhasználók száma, nem pedig a Teams-felhasználók száma, amelyeknek 20 alatt kell lenniük ahhoz, hogy a gépelésjelző funkció támogatott legyen.
  • Csevegési szál létrehozásakor 30 és 90 nap között állíthatja be a megőrzési szabályzatot.
  • Teams Interop-forgatókönyvek esetén a gépelésjelző esemény üres megjelenítendő nevet tartalmazhat, amikor a Teams-felhasználó elküldi.
  • A Teams Interop-forgatókönyvek esetében az olvasási visszaigazolások nem támogatottak a Teams-felhasználók számára.

Csevegési architektúra

A csevegési architektúra két alapvető részből áll: 1) Megbízható szolgáltatás és 2) ügyfélalkalmazás.

A Communication Services csevegési architektúráját bemutató ábra.

  • Megbízható szolgáltatás: A csevegési munkamenetek megfelelő kezeléséhez olyan szolgáltatásra van szüksége, amely segít csatlakozni a Communication Serviceshez az erőforrás-kapcsolati sztring használatával. Ez a szolgáltatás feladata csevegőszálak létrehozása, résztvevők hozzáadása és eltávolítása, valamint hozzáférési jogkivonatok kiállítása a felhasználók számára. További információ : Rövid útmutató: Hozzáférési jogkivonatok létrehozása és kezelése – rövid útmutató.
  • Ügyfélalkalmazás: Az ügyfélalkalmazás csatlakozik a megbízható szolgáltatáshoz, és megkapja azokat a hozzáférési jogkivonatokat, amelyeket a felhasználóknak közvetlenül a Communication Serviceshez kell csatlakozniuk. Miután létrehozta a csevegési szálat, és hozzáadta a résztvevőket, az ügyfélalkalmazás használatával csatlakozhatnak a csevegési szálhoz, és üzeneteket küldhetnek. A résztvevők valós idejű értesítéseket használhatnak az ügyfélalkalmazásban, hogy feliratkozzanak más tagok üzenet- és szálfrissítéseire.

Intelligens, AI-alapú csevegési élmények létrehozása

Az Azure AI-szolgáltatásokat a Csevegés szolgáltatással használhatja az alábbi használati esetek létrehozásához:

  • Segítsen egy támogatási ügynöknek a jegyek rangsorolásában azáltal, hogy észleli az ügyféltől érkező üzenetek negatív hangulatát.
  • Hozzon létre egy összegzést a beszélgetés végén, hogy e-mailben elküldhesse az ügyfélnek a következő lépésekkel, vagy nyomon követheti egy későbbi időpontban.
  • Power Virtual Agent (PVA) hozzáadása egy Azure Communication Services-csevegési csatornához egy Azure Bottal és egy továbbítórobottal.
  • Konfiguráljon egy robotot úgy, hogy egy vagy több közösségi csatornán fusson a csevegési csatorna mellett.

Az Azure Communication Services azure AI-szolgáltatásokkal párosítható diagramja.

Üzenettípusok

Az üzenetelőzmények részeként a csevegés megosztja a felhasználó által létrehozott üzeneteket és a rendszer által létrehozott üzeneteket.

A rendszerüzenetek akkor jönnek létre, ha

  • a csevegőszál frissül
  • résztvevő hozzáadása vagy eltávolítása
  • a csevegési téma témaköre frissült.

Hívás List Messages vagy Get Messages csevegés során az eredmény mindkét típusú üzenetet időrendi sorrendben tartalmazza. A felhasználó által létrehozott üzenetek esetében az üzenettípus beállítható SendMessageOptions , amikor csevegőszálba küld üzenetet. Ha nincs megadva érték, a Communication Services alapértelmezés szerint beírja a text szöveget. Ennek az értéknek a beállítása fontos a HTML-küldés során. Ha html meg van adva, a Communication Services megtisztítja a tartalmat, hogy biztonságosan jelenítse meg az ügyféleszközökön.

  • text: Egyszerű szöveges üzenet, amelyet egy felhasználó egy csevegési szál részeként állított össze és küldött el.
  • html: Egy html formátumú üzenet, amelyet egy felhasználó a csevegési szál részeként állított össze és küldött el.

A rendszerüzenetek típusai:

  • participantAdded: Rendszerüzenet, amely azt jelzi, hogy egy vagy több résztvevő szerepel a csevegési szálban.
  • participantRemoved: Rendszerüzenet, amely azt jelzi, hogy egy résztvevő el lett távolítva a csevegési szálból.
  • topicUpdated: A tématéma frissítését jelző rendszerüzenet.

Valós idejű értesítések

A JavaScript Chat SDK támogatja a valós idejű értesítéseket. Ez a funkció lehetővé teszi az ügyfelek számára, hogy valós idejű frissítéseket és bejövő üzeneteket hallgassanak meg egy csevegési szálon anélkül, hogy le kellene kérdezniük az API-kat.

Az ügyfélalkalmazás a következő eseményekre tud előfizetni:

  • chatMessageReceived - amikor egy résztvevő új üzenetet küld egy csevegési szálnak.
  • chatMessageEdited - ha egy üzenet egy csevegőszálban van szerkesztve.
  • chatMessageDeleted - amikor egy üzenet törlődik egy csevegési szálból.
  • typingIndicatorReceived - amikor egy másik résztvevő gépelésjelzőt küld a csevegési szálnak.
  • readReceiptReceived - amikor egy másik résztvevő olvasási visszaigazolást küld egy elolvasott üzenetről.
  • chatThreadCreated - amikor egy Communication Services-felhasználó létrehoz egy csevegési szálat.
  • chatThreadDeleted - amikor egy Communication Services-felhasználó töröl egy csevegési szálat.
  • chatThreadPropertiesUpdated - a csevegőszál tulajdonságainak frissítésekor; jelenleg csak a téma témakörének frissítése támogatott.
  • participantsAdded - amikor egy felhasználót hozzáadnak csevegőszál-résztvevőként.
  • participantsRemoved - ha egy meglévő résztvevőt eltávolít a csevegési szálból.
  • realTimeNotificationConnected - ha a valós idejű értesítés csatlakoztatva van.
  • realTimeNotificationDisconnected -ha a valós idejű értesítés megszakad.

Feljegyzés

A valós idejű értesítések nem használhatók kiszolgálóalkalmazásokkal.

Kiszolgálói események

Ez a funkció lehetővé teszi a kiszolgálóalkalmazások számára, hogy olyan eseményeket hallgassanak, mint például az üzenet küldésekor, illetve amikor egy résztvevő csatlakozik vagy kilép a csevegésből. A kiszolgálóalkalmazások reagálhatnak ezekre az eseményekre, hozzáadhatják/eltávolíthatják a résztvevőket a csevegéshez, archiválhatják a csevegéseket, elemzéseket végezhetnek, és számos más vezénylési forgatókönyvet is végrehajthatnak. Annak megtekintéséhez, hogy a fejlesztők milyen típusú csevegőeseményeket használhatnak, tekintse meg a Kiszolgálói események című témakört.

Leküldéses értesítések

Az Android és az iOS Chat SDK támogatja a leküldéses értesítéseket. Ha leküldéses értesítéseket szeretne küldeni a résztvevők által nem fogadott üzenetekről, amíg távol voltak, csatlakoztassa a Notification Hub-erőforrást a Communication Services-erőforráshoz leküldéses értesítések küldéséhez. Ezzel értesíti az alkalmazás résztvevőit a bejövő csevegésekről és üzenetekről, ha a mobilalkalmazás nem fut az előtérben.

Az IOS és az Android SDK az alábbi eseményt támogatja:

  • chatMessageReceived - amikor egy résztvevő új üzenetet küld egy csevegési szálnak.

Az Android SDK támogatja a további eseményeket:

  • chatMessageEdited - amikor egy résztvevő csevegőszálban szerkeszt egy üzenetet.
  • chatMessageDeleted - ha egy résztvevő töröl egy üzenetet egy csevegési szálból.
  • chatThreadCreated - amikor egy Communication Services-felhasználó létrehoz egy csevegési szálat.
  • chatThreadDeleted - amikor egy Communication Services-felhasználó töröl egy csevegési szálat.
  • chatThreadPropertiesUpdated - a csevegési szál tulajdonságainak frissítésekor; jelenleg csak a téma témakörének frissítése támogatott.
  • participantsAdded - amikor hozzáad egy résztvevőt egy csevegési szálhoz.
  • participantsRemoved - ha eltávolít egy meglévő résztvevőt a csevegési szálból.

További információ: Leküldéses értesítések.

Feljegyzés

Jelenleg a Notification Hub használatával történő csevegéses leküldéses értesítések küldése általánosan elérhető az Android 1.1.0-s és az IOS 1.3.0-s verziójában.

Következő lépések