Condividi tramite

Concetti sulle chat

Chat di Servizi di comunicazione di Azure permette di aggiungere comunicazioni di testo in tempo reale alle applicazioni multipiattaforma. Questa pagina riepiloga i principali concetti e funzionalità della libreria Chat. Per un elenco di SDK, linguaggi e piattaforme e un supporto dettagliato delle funzionalità, vedere Panoramica di Chat di Servizi di comunicazione - Software Development Kit (SDK).

Le API Chat forniscono un servizio di scalabilità automatica per le comunicazioni di testo e dati archiviate in modo permanente. Altre funzionalità chiave includono:

  • Identità personalizzata e gestione: Servizi di comunicazione di Azure fornisce identità generiche per gestire gli endpoint di comunicazione. I client usano queste identità per eseguire l'autenticazione nel servizio di Azure e comunicare tra loro nei chat threads controllati dall'utente.
  • Crittografia: i Chat SDK eseguono la crittografia del traffico e impediscono manomissioni durante il transito.
  • Riunioni di Microsoft Teams: i Chat SDK possono partecipare alle riunioni di Teams e comunicare con i messaggi chat di Teams.
  • Notifiche in tempo reale: i Chat SDK usano una connettività persistente efficiente (WebSocket) per ricevere notifiche in tempo reale, ad esempio quando un utente remoto digita qualcosa. Quando le app vengono eseguite in background, è disponibile la funzionalità predefinita per attivare le notifiche popup per informare gli utenti finali su nuovi thread e messaggi.
  • Estendibilità dei bot : è facile aggiungere bot di Azure al servizio Chat con l'integrazione di Azure Bot.

Panoramica della chat

Le conversazioni chat avvengono all'interno di thread chat. I thread chat presentano le proprietà seguenti:

  • Un'identità del thread chat è ChatThreadId.
  • I thread chat supportano da zero a 250 utenti come partecipanti in grado di inviare messaggi.
  • Un utente può far parte di un numero illimitato di thread chat.
  • Solo i partecipanti ai thread possono inviare o ricevere messaggi, aggiungere o rimuovere partecipanti.
  • Gli utenti vengono aggiunti come partecipanti a qualsiasi thread chat creato.

Accesso utente

Servizi di comunicazione di Azure supporta tre livelli di controllo degli accessi utente, attraverso i token chat. Per informazioni dettagliate, vedere Identità e token. I partecipanti non hanno accesso in scrittura ai messaggi inviati da altri partecipanti, il che significa che solo il mittente del messaggio può aggiornare o eliminare i messaggi inviati. Se un altro partecipante tenta di eseguire queste operazioni, riceve un errore.

Dati chat

Servizi di comunicazione di Azure archivia i thread chat in base ai criteri di conservazione dei dati in vigore quando viene creato un thread chat. Se necessario, è possibile aggiornare i criteri di conservazione durante il periodo di conservazione impostato. Dopo aver eliminato un thread chat (tramite criteri o una richiesta dell'API di eliminazione), non è possibile recuperarlo.

È possibile scegliere tra:

Tutti i thread creati prima dei nuovi criteri di conservazione non sono interessati, a meno che non si modifichino in modo specifico i criteri per quel thread. Se si invia una richiesta di supporto per un thread chat eliminato più di 30 giorni dopo l'eliminazione dei criteri di conservazione, il thread non potrà più essere recuperato e non saranno più disponibili informazioni su quel thread. Se necessario, aprire un ticket di supporto quanto prima all'interno della finestra di 30 giorni dopo aver creato un thread in modo da poter fornire assistenza.

I partecipanti al thread chat possono usare ListMessages per visualizzare la cronologia dei messaggi per un determinato thread. L'API ListMessages non può restituire la cronologia di un thread se quest'ultimo viene eliminato. Gli utenti rimossi da un thread chat possono visualizzare la cronologia dei messaggi precedente, ma non possono inviare o ricevere nuovi messaggi. I messaggi eliminati accidentalmente non sono recuperabili dal sistema. Per altre informazioni sui dati archiviati nel servizio Chat di Servizi di comunicazione di Azure, vedere Disponibilità a livello di area e residenza dei dati.

Per i clienti che usano Appuntamenti virtuali, fare riferimento alla privacy degli utenti di Interoperabilità di Teams per l'archiviazione dei messaggi chat nelle riunioni di Teams.

Limiti del servizio

  • Il numero massimo di partecipanti consentiti in un thread di chat è 250.
  • La dimensione massima consentita per i messaggi è circa 28 KB.
  • Per i thread chat con oltre 20 partecipanti le conferme di lettura e l'indicatore di digitazione non sono supportati.
  • Per gli scenari di interoperabilità di Teams, è il numero di utenti di Servizi di comunicazione di Azure, non gli utenti di Teams, che deve essere inferiore a 20 per poter supportare la funzionalità dell'indicatore di digitazione.
  • Quando si crea un thread chat, è possibile impostare i criteri di conservazione tra 30 e 90 giorni.
  • Inoltre, negli scenari di interoperabilità di Teams si applicano le limitazioni seguenti:
    • Il nome visualizzato dell'utente di Teams nell'evento indicatore di digitazione è vuoto.
    • La conferma di lettura non è supportata.
    • Alcune identità non sono supportate, ad esempio utenti Bot, utenti Skype, utenti non Enterprise e simili.

Architettura della chat

L'architettura della chat si compone di due parti centrali: 1) Servizio attendibile e 2) Applicazione client.

Diagramma che illustra l'architettura della chat di Servizi di comunicazione.

  • Servizio attendibile: per gestire correttamente una sessione di chat, è necessario un servizio che permette di connettersi a Servizi di comunicazione usando la stringa di connessione della risorsa. Questo servizio è responsabile della creazione di thread chat, dell'aggiunta e della rimozione di partecipanti e dell'emissione di token di accesso agli utenti. Per altre informazioni, vedere Avvio rapido: Creare e gestire token di accesso.
  • App client: l'applicazione client si connette al servizio attendibile e riceve i token di accesso di cui gli utenti necessitano per connettersi direttamente a Servizi di comunicazione. Dopo aver creato il thread chat e aggiunto partecipanti, questi possono usare l'applicazione client per connettersi al thread chat e inviare messaggi. I partecipanti possono usare le notifiche in tempo reale nell'applicazione client per sottoscrivere gli aggiornamenti di messaggi e thread d altri membri.

Creare esperienze di chat intelligenti basate sull'IA

È possibile usare Gli strumenti Foundry con il servizio Chat per compilare casi d'uso come:

  • Permettere a un agente di supporto di classificare in ordine di priorità i ticket rilevando una valutazione negativa di un messaggio in arrivo di un cliente.
  • Generare un riepilogo alla fine della conversazione da inviare al cliente via e-mail con i passaggi successivi o attività di follow-up da svolgere in una data futura.
  • Aggiungere un agente in un canale di Chat di Servizi di comunicazione di Azure con Azure Bot e un bot di inoltro.
  • Configurare un bot per l'esecuzione in uno o più canali social insieme al canale Chat.

Diagramma che mostra che Servizi di comunicazione di Azure può essere associato a Foundry Tools.

Tipi di messaggio

Come parte della cronologia messaggi, Chat condivide messaggi generati dall'utente e messaggi generati dal sistema.

I messaggi di sistema vengono generati quando

  • viene aggiornato un thread chat
  • viene aggiunto o rimosso un partecipante
  • è stato aggiornato l'argomento del thread chat.

Quando si chiama List Messages o Get Messages su un thread chat, il risultato contiene entrambi i tipi di messaggi in ordine cronologico. Per i messaggi generati dall'utente, il tipo di messaggio può essere impostato in SendMessageOptions quando si invia un messaggio al thread chat. Se non viene specificato alcun valore, per impostazione predefinita Servizi di comunicazione è configurato sul tipo text. L'impostazione di questo valore è importante quando si invia codice HTML. Quando si specifica html, Servizi di comunicazione corregge il contenuto per assicurarsi che venga reso in modo sicuro nei dispositivi client.

  • text: messaggio di testo normale composto e inviato da un utente nell'ambito di un thread chat.
  • html: messaggio formattato con html, composto e inviato da un utente nell'ambito di un thread chat.

Tipi di messaggi di sistema:

  • participantAdded: messaggio di sistema che indica che uno o più partecipanti sono presenti nel thread chat.
  • participantRemoved: messaggio di sistema che indica che un partecipante viene rimosso dal thread chat.
  • topicUpdated: messaggio di sistema che indica che l'argomento del thread è stato aggiornato.

Notifiche in tempo reale

JavaScript Chat SDK supporta le notifiche in tempo reale. Questa funzione consente ai client di rimanere in ascolto in Servizi di comunicazione in attesa di aggiornamenti in tempo reale e messaggi in arrivo in un thread chat senza dover eseguire il polling delle API.

L'app client può eseguire la sottoscrizione agli eventi seguenti:

  • chatMessageReceived: quando un nuovo messaggio viene inviato a un thread chat da un partecipante.
  • chatMessageEdited: quando un messaggio viene modificato in un thread chat.
  • chatMessageDeleted: quando un messaggio viene eliminato in un thread chat.
  • typingIndicatorReceived: quando un altro partecipante invia un indicatore di digitazione al thread chat.
  • readReceiptReceived: quando un altro partecipante invia una ricevuta di lettura per un messaggio letto.
  • chatThreadCreated: quando un utente di Servizi di comunicazione crea un thread chat.
  • chatThreadDeleted: quando un utente di Servizi di comunicazione elimina un thread chat.
  • chatThreadPropertiesUpdated: quando le proprietà del thread chat vengono aggiornate; attualmente è supportato solo l'aggiornamento dell'argomento per il thread.
  • participantsAdded: quando un utente viene aggiunto come partecipante del thread chat.
  • participantsRemoved: quando un partecipante esistente viene rimosso dal thread chat.
  • realTimeNotificationConnected: quando la notifica in tempo reale è connessa.
  • realTimeNotificationDisconnected: quando la notifica in tempo reale è disconnessa.

Note

Non usare le notifiche in tempo reale con applicazioni server.

Eventi server

Questa funzionalità permette alle applicazioni server di rimanere in attesa di eventi, ad esempio quando viene inviato un messaggio e quando un partecipante entra o esce dalla chat. Le applicazioni server possono reagire a questi eventi, aggiungendo/rimuovendo partecipanti alla chat, archiviando chat, eseguendo analisi e molti altri scenari per l'orchestrazione. Per vedere quali eventi chat sono disponibili agli sviluppatori, vedere Servizi di comunicazione di Azure come origine di Griglia di eventi di Azure.

Notifiche push

I Chat SDK per Android e iOS supportano le notifiche push. Per inviare notifiche push per i messaggi che i partecipanti si sono persi mentre erano assenti, connettere una risorsa Hub di notifica alla risorsa Servizi di comunicazione per inviare notifiche push. In questo modo, i partecipanti ricevono notifiche in merito a chat e messaggi in arrivo quando l'app per dispositivi mobili non è in esecuzione in primo piano.

Gli SKD per iOS e Android supportano gli eventi seguenti:

  • chatMessageReceived: quando un partecipante invia un nuovo messaggio a un thread chat.

Android SDK supporta eventi aggiuntivi:

  • chatMessageEdited: quando un partecipante modifica un messaggio in un thread chat.
  • chatMessageDeleted: quando un partecipante elimina un messaggio in un thread chat.
  • chatThreadCreated: quando un utente di Servizi di comunicazione crea un thread chat.
  • chatThreadDeleted: quando un utente di Servizi di comunicazione elimina un thread chat.
  • chatThreadPropertiesUpdated: quando si aggiornano le proprietà del thread chat; attualmente è supportato solo l'aggiornamento dell'argomento per il thread.
  • participantsAdded: quando si aggiunge un partecipante a un thread chat.
  • participantsRemoved: quando si rimuove un partecipante esistente dal thread chat.

Per altre informazioni, vedere Notifiche push.

Note

Attualmente l'invio di notifiche push chat con Hub di notifica è disponibile a livello generale in Android versione 1.1.0 e in IOS versione 1.3.0.

Passaggi successivi

Introduzione alle chat

  • Last updated on