Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Accesso all’analisi di Contact Lens per i contatti vocali e tramite chat utilizzando il flusso di dati Amazon Kinesis I flussi di segmenti di analisi dei contatti consentono di accedere all’analisi di Contact Lens per i contatti vocali e tramite chat. [Lo streaming supera i limiti di scalabilità delle analisi esistenti di chiamate e chat. APIs](contact-lens-api.md) Per i contatti vocali, fornisce inoltre l’accesso a un segmento di dati chiamato `Utterance` che consente di accedere a trascrizioni parziali. Questo permette di soddisfare i requisiti di latenza estremamente bassa per supportare gli agenti nelle chiamate in tempo reale. Questa sezione spiega come effettuare l’integrazione con il flusso di dati Amazon Kinesis per lo streaming. Con lo streaming, puoi ricevere i seguenti tipi di evento: + Eventi STARTED pubblicati all’inizio di una sessione di analisi dei contatti. + Eventi SEGMENTS pubblicati durante le sessioni di analisi dei contatti. Questi eventi contengono un elenco di segmenti con le informazioni analizzate. + Eventi COMPLETED o FAILED pubblicati al termine di una sessione di analisi dei contatti. **Topics** + [Abilitazione dei flussi di segmenti di analisi dei contatti](enable-contact-analysis-segment-streams.md) + [Voce: modello di dati per flussi di segmenti di analisi delle conversazioni](real-time-contact-analysis-segment-streams-data-model.md) + [Modello di dati per flussi di segmenti di analisi delle conversazioni](chat-real-time-contact-analysis-segment-streams-data-model.md) + [Voice: flusso di segmenti di analisi delle conversazioni di esempio](sample-real-time-contact-analysis-segment-stream.md) + [Chat: flusso di segmenti di analisi delle conversazioni di esempio](chat-sample-real-time-contact-analysis-segment-stream.md) # Abilitazione dei flussi di segmenti di analisi dei contatti per analizzare le conversazioni Contact Lens I flussi di segmenti di analisi dei contatti non sono abilitati per impostazione predefinita. In questo argomento viene descritto come abilitarli. ## Passaggio 1: Creare un flusso Amazon Kinesis Crea il flusso di dati nello stesso account e nella stessa regione in cui risiede la tua istanza Amazon Connect. Per istruzioni, consulta [Passaggio 1: Creare un flusso di dati](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-create-stream.html) nella *Guida per gli sviluppatori del flusso di dati Amazon Kinesis*. **Suggerimento** È consigliabile creare un flusso separato per ogni tipo di dati. Sebbene sia possibile utilizzare lo stesso flusso per i flussi dei segmenti di analisi dei contatti, gli eventi degli agenti e i record dei contatti, è molto più semplice gestire e ottenere dati dal flusso quando si utilizza un flusso separato per ognuno di essi. Per ulteriori informazioni, consulta la [Guida per gli sviluppatori di Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html). ## Passaggio 2: Configurare la crittografia lato server per il flusso Kinesis (facoltativo ma consigliato) Esistono vari modi per eseguire questa operazione. + Opzione 1: utilizzare la Chiave gestita da AWS di Kinesis (`aws/kinesis`). Funziona senza alcuna configurazione aggiuntiva. + Opzione 2: utilizzare la stessa chiave gestita dal cliente per le registrazioni delle chiamate, le trascrizioni delle chat o i report esportati nell'istanza Amazon Connect. Abilita la crittografia e utilizza una chiave gestita dal cliente per le registrazioni delle chiamate, le trascrizioni delle chat o i report esportati nella tua istanza Amazon Connect. Quindi scegli la stessa chiave KMS per il flusso di dati Kinesis. Questa chiave dispone già dell'autorizzazione (concessione) necessaria per il suo utilizzo. + Opzione 3: utilizzare un'altra chiave gestita dal cliente. Usa una chiave gestita dal cliente esistente o creane una nuova e aggiungi le autorizzazioni necessarie per l'utilizzo della chiave da parte del ruolo Amazon Connect. Per aggiungere le autorizzazioni utilizzando le concessioni AWS KMS , consulta l'esempio seguente: ``` aws kms create-grant \ --key-id your key ID \ --grantee-principal arn:aws:iam::your AWS account ID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_11111111111111111111 \ --operations GenerateDataKey \ --retiring-principal arn:aws:iam::your AWS account ID:role/adminRole ``` Dov'è `grantee-principal` è l'ARN del ruolo collegato al servizio associato alla tua istanza Amazon Connect. Per trovare l'ARN del ruolo collegato al servizio, nella console Amazon Connect vai a **Panoramica**, **Impostazioni di distribuzione**, **Ruolo collegato al servizio**. ## Passaggio 3: Associare il flusso Kinesis Utilizza l'[AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)API Amazon Connect per associare i seguenti tipi di risorse: + Per i contatti vocali, utilizza `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` + Per i contatti tramite chat, utilizza `REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS` **Nota** `REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` è obsoleto, ma è comunque supportato e si applica solo ai contatti vocali. Utilizza `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` per i contatti vocali in futuro. Se in precedenza hai associato un flusso con `REAL_TIME_CONTACT_ANALYSIS_SEGMENTS`, non è necessaria alcuna azione per aggiornare lo flusso a `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`. Specifica il flusso Kinesis in cui verranno pubblicati i segmenti di analisi dei contatti in tempo reale. Avrai bisogno dell'ID istanza e dell'ARN del flusso Kinesis. Il codice seguente mostra un esempio: ``` // Build request const request: Connect.Types.AssociateInstanceStorageConfigRequest = { InstanceId: 'your Amazon Connect instance ID', ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS or REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS', StorageConfig: { StorageType: 'KINESIS_STREAM', KinesisStreamConfig: { StreamArn: 'the ARN of your Kinesis stream', }, } }; ``` ### AWS CLI L’esempio seguente riguarda i contatti tramite chat. **Suggerimento** Se non includi la AWS regione (`--region`), utilizza la regione predefinita basata sul profilo CLI. Il valore del parametro `--storage-config` non deve essere incluso tra virgolette singole (‘). Altrimenti genera un errore. ``` aws connect associate-instance-storage-config \ --region "us-west-2" \ --instance-id your Amazon Connect instance ID \ --resource-type REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS \ --storage-config StorageType=KINESIS_STREAM,KinesisStreamConfig={StreamArn=the ARN of your Kinesis stream} ``` ### AWS SDK L’esempio seguente riguarda i contatti vocali. ``` import { Connect } from 'aws-sdk'; async function associate (): Promise { const clientConfig: Connect.ClientConfiguration = { region: 'the Region of your Amazon Connect instance', }; const connect = new Connect(clientConfig); // Build request const request: Connect.Types.AssociateInstanceStorageConfigRequest = { InstanceId: 'your Amazon Connect instance ID', ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS', StorageConfig: { StorageType: 'KINESIS_STREAM', KinesisStreamConfig: { StreamArn: 'the ARN of your Kinesis stream', }, } }; try { // Execute request const response: Connect.Types.AssociateInstanceStorageConfigResponse = await connect.associateInstanceStorageConfig(request).promise(); // Process response console.log('raw response: ${JSON.stringify(response, null, 2)}'); } catch (err) { console.error('Error calling associateInstanceStorageConfig. err.code: ${err.code},' + 'err.message: ${err.message}, err.statusCode: ${err.statusCode}, err.retryable: ${err.retryable}'); } } associate().then(r => console.log('Done')); ``` ## Fase 4: abilitare Contact Lens per un’istanza Amazon Connect Per istruzioni, consulta [Abilitazione dell’analisi delle conversazioni in Amazon Connect Contact Lens](enable-analytics.md). ## Passaggio 5 (facoltativo): Esaminare un flusso di segmenti di esempio Ti consigliamo di esaminare un flusso di segmenti di esempio [vocale](sample-real-time-contact-analysis-segment-stream.md) o tramite [chat](chat-sample-real-time-contact-analysis-segment-stream.md) per acquisire familiarità. # Modello di dati per i flussi di segmenti di analisi delle conversazioni per analizzare i contatti vocali in Contact Lens I flussi di segmenti di analisi dei contatti in tempo reale vengono generati in JSON. I blob JSON degli eventi vengono pubblicati nel flusso associato per ogni contatto per cui è abilitata l’analisi delle conversazioni in tempo reale. È possibile pubblicare i seguenti tipi di eventi per una sessione di analisi delle conversazioni per un contatto vocale: + Eventi STARTED: ogni sessione di analisi delle conversazioni pubblica un evento STARTED all’inizio della sessione. + Eventi SEGMENTS: ogni sessione di analisi delle conversazioni può pubblicare zero o più eventi SEGMENTS durante la sessione. Questi eventi contengono un elenco di segmenti con le informazioni analizzate. Per i contatti vocali, l’elenco dei segmenti può includere segmenti “`Utterance`”, “`Transcript`”, “`Categories`” o “`PostContactSummary`”. + Eventi COMPLETED o FAILED: ogni sessione di analisi delle conversazioni pubblica un evento COMPLETED o FAILED alla fine della sessione. ## Proprietà comuni incluse in tutti gli eventi per i contatti vocali Ogni evento include le seguenti proprietà: **Versione** La versione dello schema dell'evento. Tipo: String **Canale** Il tipo del canale per il contatto. Tipo: String Valori validi: `VOICE`, `CHAT`, `TASK` Per ulteriori informazioni sui canali, consulta [Canali e simultaneità per il routing dei contatti in Amazon Connect](channels-and-concurrency.md). **AccountId** L'identificatore dell'account in cui avviene questo contatto. Tipo: String **ContactId** L'identificatore del contatto analizzato. Tipo: String **InstanceId** L'identificatore dell'istanza in cui avviene questo contatto. Tipo: String **LanguageCode** Il codice della lingua associato a questo contatto. Tipo: String Valori validi: il codice della lingua per una delle [lingue supportate per l’analisi delle chiamate in tempo reale di Contact Lens](supported-languages.md#supported-languages-contact-lens). **EventType** Il tipo di evento pubblicato. Tipo: String Valori validi: `STARTED`, `SEGMENTS`, `COMPLETED`, `FAILED` ## Evento STARTED Gli eventi `STARTED` includono solo le proprietà comuni: + Versione + Canale + AccountId + ContactId + LanguageCode + EventType: INIZIATO ## Evento SEGMENTS Gli eventi `SEGMENTS` includono le proprietà seguenti: + Versione + Canale + AccountId + ContactId + LanguageCode + EventType: SEGMENTI + Segmenta: oltre alle proprietà comuni, gli eventi `SEGMENTS` includono un elenco di segmenti con le informazioni analizzate. Type: array di oggetti [Segment](#segment) + PostContactSummary: Informazioni sul riepilogo successivo al contatto per un segmento di contatto vocale. Tipo: oggetti [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) Obbligatorio: no **Segment** Un segmento analizzato per una sessione di analisi in tempo reale. Ogni segmento è un oggetto con le seguenti proprietà opzionali. È presente solo una di queste proprietà, a seconda del tipo di segmento: + Utterance + Transcript + Categories + PostContactSummary **Utterance** L'enunciato analizzato. Obbligatorio: no + **Id** L'identificatore dell'enunciato. Tipo: String + ** TranscriptId** L'identificatore della trascrizione associata a questo enunciato. Tipo: String + **ParticipantId** L'identificatore del partecipante. Tipo: String + ** ParticipantRole** Il ruolo del partecipante. Ad esempio, un cliente, un agente o un sistema. Tipo: String + ** PartialContent** Il contenuto dell'enunciato. Tipo: String + ** BeginOffsetMillis** L'offset iniziale nel contatto per questa trascrizione. Tipo: numero intero + ** EndOffsetMillis** L'offset finale nel contatto per questa trascrizione. Tipo: numero intero **Transcript** La trascrizione analizzata. Tipo: oggetto [Transcript](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Transcript.html) Obbligatorio: no **Categories** Le regole della categoria corrispondente. Tipo: oggetto [Categories](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Categories.html) Obbligatorio: no **PostContactSummary** Informazioni sul riepilogo post-contatto per un segmento di contatto vocale. Tipo: oggetto [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) Obbligatorio: no ## Eventi COMPLETED Gli eventi `COMPLETED` includono solo le seguenti proprietà comuni: + Versione + Canale + AccountId + ContactId + LanguageCode + EventType: COMPLETATO ## Evento FAILED Gli eventi `FAILED` includono solo le seguenti proprietà comuni: + Versione + Canale + AccountId + ContactId + LanguageCode + EventType: FALLITO # Modello di dati per i flussi di segmenti di analisi delle conversazioni per analizzare le chat in Contact Lens I flussi di segmenti di analisi delle conversazioni per i contatti tramite chat vengono generati in JSON. I blob JSON degli eventi vengono pubblicati nel flusso associato per ogni contatto per cui è abilitata l’analisi delle conversazioni in tempo reale. È possibile pubblicare i seguenti tipi di eventi per una sessione di analisi delle conversazioni per un contatto tramite chat: + Eventi STARTED: ogni sessione di analisi delle conversazioni pubblica un evento STARTED all’inizio della sessione. + Eventi SEGMENTS: ogni sessione di analisi delle conversazioni può pubblicare zero o più eventi SEGMENTS durante la sessione. Questi eventi contengono un elenco di segmenti con le informazioni analizzate. Per i contatti tramite chat, l’elenco dei segmenti può includere i segmenti “`Attachments`”, “`Transcript`”, “`Categories`”, “`Events`”, “`Issues`” o “`PostContactSummary`”. + Eventi COMPLETED o FAILED: ogni sessione di analisi delle conversazioni pubblica un evento COMPLETED o FAILED alla fine della sessione. ## Proprietà comuni incluse in tutti gli eventi per i contatti tramite chat Ogni evento include le seguenti proprietà: **Versione** La versione dello schema dell’evento. Per i contatti tramite chat, questa è la versione 2.0.0. Tipo: String **Canale** Il tipo del canale per il contatto. Tipo: String Valori validi: `VOICE`, `CHAT`, `TASK` Per ulteriori informazioni sui canali, consulta [Canali e simultaneità per il routing dei contatti in Amazon Connect](channels-and-concurrency.md). **AccountId** L'identificatore dell'account in cui avviene questo contatto. Tipo: String **InstanceId** L'identificatore dell'istanza in cui avviene questo contatto. Tipo: String **ContactId** L'identificatore del contatto analizzato. Tipo: String **StreamingEventType** Il tipo di evento pubblicato. Tipo: String Valori validi: `STARTED`, `SEGMENTS`, `COMPLETED`, `FAILED` **StreamingSettings** Le impostazioni di Contact Lens per questo contatto Tipo: oggetto [StreamingSettings](#streamingsettingsobject) ## StreamingSettings oggetto **LanguageCode** Il codice della lingua associato a questo contatto. Tipo: String Valori validi: il codice della lingua per una delle [lingue supportate per l’analisi delle chiamate in tempo reale di Contact Lens](supported-languages.md#supported-languages-contact-lens). **Output** Il tipo di output di Contact Lens abilitato per questo contatto. Tipo: String Valori validi: `Raw`, `Redacted`, `RedactedAndRaw` **RedactionTypes** Il tipo di redazione abilitato per questo contatto. Tipo: array di stringhe Valori validi: `PII` **RedactionTypesMetadata** I metadati di redazione per ogni tipo di redazione. Tipo: RedactionType da stringa a [RedactionMetadata](#redactionmetadata)oggetto Valori validi: `PII` ## RedactionMetadata oggetto Fornisce informazioni sulle impostazioni di redazione. **RedactionMaskMode** Impostazione Sostituzione dei dati oscurati Tipo: String Valori validi: `PII`, `EntityType` ## Evento STARTED Gli eventi `STARTED` includono solo le proprietà comuni: + Versione + Canale + AccountId + ContactId + StreamingEventType: INIZIATO + StreamingSettings ## Evento SEGMENTS Gli eventi `SEGMENTS` includono le proprietà seguenti: + Versione + Canale + AccountId + OutputType + Il tipo di output di Contact Lens del segmento corrente + Tipo: String + Valori validi: `Raw`, `Redacted` + ContactId + StreamingEventType: SEGMENTI + StreamingSettings + Segmenti + Un elenco di segmenti con le informazioni analizzate. + Type: array di oggetti [Segment](#chat-segment) **Segment** Un segmento analizzato per una sessione di analisi in tempo reale. Ogni segmento è un oggetto con le seguenti proprietà opzionali. È presente solo una di queste proprietà, a seconda del tipo di segmento: + [Allegati](#chat-attachments) + [Categorie](#chat-category) + [Evento](#chat-event) + [Problemi](#chat-issues) + [Trascrizione](#chat-transcript) + [PostContactSummary](#chat-postcontactsummary) **Allegati** Gli allegati analizzati. Obbligatorio: no Tipo: oggetto [RealTimeContactAnalysisSegmentAttachments](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentAttachments.html) **Categories** Le regole della categoria corrispondente. Tipo: oggetto [RealTimeContactAnalysisSegmentCategories](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentCategories.html) Obbligatorio: no **Event** Tipo di segmento che descrive un evento di contatto. Tipo: oggetto [RealTimeContactAnalysisSegmentEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentEvent.html) Obbligatorio: no **Problemi** Tipo di segmento contenente un elenco di problemi rilevati. Tipo: oggetto [RealTimeContactAnalysisSegmentIssues](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentIssues.html) Obbligatorio: no **Transcript** Il segmento di trascrizione analizzato. Tipo: oggetto [RealTimeContactAnalysisSegmentTranscript](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentTranscript.html) Obbligatorio: no **PostContactSummary** Informazioni sul riepilogo post-contatto per un segmento di contatto in tempo reale per la chat. Tipo: oggetto [RealTimeContactAnalysisSegmentPostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentPostContactSummary.html) Obbligatorio: no ## Eventi COMPLETED Gli eventi `COMPLETED` includono solo le seguenti proprietà comuni: + Versione + Canale + AccountId + InstanceId + ContactId + StreamingEventType: COMPLETATO + StreamingSettings ## Evento FAILED Gli eventi `FAILED` includono solo le seguenti proprietà comuni: + Versione + Canale + AccountId + InstanceId + ContactId + StreamingEventType: FALLITO + StreamingSettings # Flusso di segmenti di analisi delle conversazioni di esempio per analizzare le chiamate utilizzando Contact Lens Questo argomento fornisce i flussi di segmenti di esempio per gli eventi STARTED, SEGMENTS, COMPLETED e FAILED che possono verificarsi durante un contatto vocale. ## Evento STARTED di esempio + EventType: AVVIATO + Pubblicato all’inizio della sessione di analisi delle conversazioni. ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "STARTED" } ``` ## Evento SEGMENTS di esempio + EventType: SEGMENTI + Pubblicato durante una sessione di analisi delle conversazioni. Questo evento contiene un elenco di segmenti con le informazioni analizzate. L’elenco dei segmenti può includere i segmenti “`Utterance`”, “`Transcript`”, “`Categories`” o “`PostContactSummary`”. ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "SEGMENTS", "Segments": [ { "Utterance": { "Id": "7b48ca3d-73d3-443a-bf34-a9e8fcc01747", "TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a", "ParticipantId": "AGENT", "ParticipantRole": "AGENT", "PartialContent": "Hello, thank you for calling Example Corp. My name is Adam.", "BeginOffsetMillis": 19010, "EndOffsetMillis": 22980 } }, { "Utterance": { "Id": "75acb743-2154-486b-aaeb-c960ae290e88", "TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a", "ParticipantId": "AGENT", "ParticipantRole": "AGENT", "PartialContent": "How can I help you?", "BeginOffsetMillis": 23000, "EndOffsetMillis": 24598 } }, { "Transcript": { "Id": "121d1581-905f-4169-9804-b841bb4df04a", "ParticipantId": "AGENT", "ParticipantRole": "AGENT", "Content": "Hello, thank you for calling Example Corp. My name is Adam. How can I help you?", "BeginOffsetMillis": 19010, "EndOffsetMillis": 24598, "Sentiment": "NEUTRAL" } }, { "Transcript": { "Id": "4295e927-43aa-4447-bbfc-8fccc2027530", "ParticipantId": "CUSTOMER", "ParticipantRole": "CUSTOMER", "Content": "I'm having trouble submitting the application, number AX876293 on the portal. I tried but couldn't connect to my POC on the portal. So, I'm calling on this toll free number", "BeginOffsetMillis": 19010, "EndOffsetMillis": 22690, "Sentiment": "NEGATIVE", "IssuesDetected": [ { "CharacterOffsets": { "BeginOffsetChar": 0, "EndOffsetChar": 81 } } ] } }, { "Categories": { "MatchedCategories": [ "CreditCardRelated", "CardBrokenIssue" ], "MatchedDetails": { "CreditCardRelated": { "PointsOfInterest": [ { "BeginOffsetMillis": 19010, "EndOffsetMillis": 22690 } ] }, "CardBrokenIssue": { "PointsOfInterest": [ { "BeginOffsetMillis": 25000, "EndOffsetMillis": 29690 } ] } } } }, { "PostContactSummary": { "Content": "Customer contacted Example Corp because of an issue with their application", "Status": "COMPLETED" } } ] } ``` ## Evento COMPLETED di esempio + EventType: COMPLETATO + Pubblicato al termine della sessione di analisi delle conversazioni se l’analisi è stata completata correttamente. ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "COMPLETED" } ``` ## Evento FAILED di esempio + EventType: FALLITO + Pubblicato al termine della sessione di analisi delle conversazioni se l’analisi non è riuscita. ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "FAILED" } ``` # Esempi di flussi di analisi delle conversazioni per analizzare le chat in Contact Lens Questo argomento fornisce i flussi di segmenti di esempio per gli eventi STARTED, SEGMENTS, COMPLETED e FAILED che si verificano durante un contatto tramite chat. ## Evento STARTED di esempio + EventType: AVVIATO + Pubblicato all’inizio della sessione di analisi delle conversazioni. ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "StreamingEventType": "STARTED", "StreamingSettings": { "LanguageCode": "en-US", // the language code of the contact "Output": "RedactedAndRaw", "RedactionTypes": [ "PII" ], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } } } ``` ## Evento SEGMENTS di esempio + EventType: [SEGMENTI](chat-real-time-contact-analysis-segment-streams-data-model.md#chat-segment-streams-data-model-segments-event) + Pubblicato durante una sessione di analisi delle conversazioni. Questo evento contiene un elenco di [RealtimeContactAnalysisSegment](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealtimeContactAnalysisSegment.html)oggetti con informazioni analizzate. L'elenco dei segmenti può includere segmenti `"Transcript"``"Categories"`,`"Issue"`,`"Event"`,`"Attachment"`, o PostContactSummary "». ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "OutputType": "Redacted", "StreamingEventType": "SEGMENTS", "StreamingSettings": { "LanguageCode": "en-US", // the language code of the contact "Output": "RedactedAndRaw", "RedactionTypes": [ "PII" ], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } }, "Segments": [{ "Transcript": { "Id": "07a2d668-5c9e-4f69-b2fe-986261b0743a", "ParticipantId": "a309ac1e-ca87-44ca-bb5d-197eca8ed77a", "ParticipantRole": "AGENT", "DisplayName": "[PII]", "Content": "Hello, thank you for contacting Example Corp. My name is Ray.", "ContentType": "text/markdown", "Time": { "AbsoluteTime": "2024-03-14T19:39:26.715Z" }, "Sentiment": "NEUTRAL" } }, { "Categories": { "MatchedDetails": { "Hi": { "PointsOfInterest": [{ "TranscriptItems": [{ "Id": "5205b050-8aa9-4645-a381-a308801649ab", "CharacterOffsets": { "BeginOffsetChar": 0, "EndOffsetChar": 40 } }] }] } } } }, { "Issues": { "IssuesDetected": [{ "TranscriptItems": [{ "Content": "I have an issue with my bank account", "Id": "0e5574a7-2aeb-4eab-8bb5-3a7f66a2284a", "CharacterOffsets": { "BeginOffsetChar": 7, "EndOffsetChar": 43 } }] }] } }, { "Attachments": { "Id": "06ddc1eb-2302-4a8e-a73f-37687fe41aa9", "ParticipantId": "7810b1de-cca8-4153-b522-2498416255af", "ParticipantRole": "CUSTOMER", "DisplayName": "Customer", "Attachments": [{ "AttachmentName": "Lily.jpg", "ContentType": "image/jpeg", "AttachmentId": "343e34da-391a-4541-8b7e-3909d931fcfa", "Status": "APPROVED" }], "Time": { "AbsoluteTime": "2024-03-14T19:39:26.715Z" } } }, { "Event": { "Id": "fbe61c5f-d0d8-4345-912a-4e81f5734d3b", "ParticipantId": "7810b1de-cca8-4153-b522-2498416255af", "ParticipantRole": "CUSTOMER", "DisplayName": "Customer", "EventType": "application/vnd.amazonaws.connect.event.participant.left", "Time": { "AbsoluteTime": "2024-03-14T19:40:00.614Z" } } }, { "PostContactSummary": { "Content": "Customer contacted Example Corp because of an issue with their bank account", "Status": "COMPLETED" } }] } ``` ## Evento COMPLETED di esempio + EventType: COMPLETATO + Pubblicato al termine della sessione di analisi delle conversazioni se l’analisi è stata completata correttamente. ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "StreamingEventType": "COMPLETED", "StreamingEventSettings": { "LanguageCode": "en-US", // the language code of the contact "Output": "RedactedAndRaw", "RedactionTypes": ["PII"], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } } } ``` ## Evento FAILED di esempio + EventType: FALLITO + Pubblicato al termine della sessione di analisi delle conversazioni se l’analisi non è riuscita. ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "StreamingEventType": "FAILED", "StreamingEventSettings": { "LanguageCode": "en-US", "Output": "RedactedAndRaw", "RedactionTypes": ["PII"], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } } } ```