Come posso integrare Amazon Connect con Amazon Kinesis?

Breve descrizione

L'attivazione dello streaming di dati nell'istanza Amazon Connect consente di trasmettere gli eventi degli agenti e i CTR ad Amazon Kinesis Data Firehose o al flusso di dati Amazon Kinesis. Gli eventi degli agenti forniscono rapporti quasi in tempo reale sull'attività degli agenti all'interno dell'istanza. I CTR forniscono dati quasi in tempo reale su eventi di contatto come chiamate vocali, chat e attività nell'istanza.

Per integrare Amazon Connect con Kinesis Data Firehose o con il flusso di dati Amazon Kinesis, completa i seguenti passaggi:

1. Crea un flusso di distribuzione Kinesis Data Firehose o un flusso di dati Kinesis.
2. Attiva lo streaming dei dati per l'istanza.
3. Testa la configurazione.

Risoluzione

Crea un flusso di distribuzione Kinesis Data Firehose

Per integrare Amazon Connect con Kinesis Data Firehose, completa i seguenti passaggi:

1. Configura l'origine, la destinazione e il nome del flusso di distribuzione Kinesis Data Firehose.
   Nota: Direct PUT consente di creare un flusso di distribuzione Kinesis Data Firehose in grado di trasmettere dati da Amazon Connect senza dover creare un flusso di dati Kinesis. L'utilizzo del flusso Kinesis richiede invece la creazione di un flusso di dati Kinesis per i dati Amazon Connect.
2. (Facoltativo) Configura il flusso di distribuzione Kinesis Data Firehose per trasformare e convertire i dati dei record.
3. (Facoltativo) Configura il backup e le impostazioni avanzate per il flusso di distribuzione Kinesis Data Firehose.
4. Attiva lo streaming dei dati per l'istanza.
5. Testa il flusso di distribuzione utilizzando dati di esempio.

Crea un flusso di dati Kinesis

Per integrare Amazon Connect con il flusso di dati Kinesis, completa i seguenti passaggi:

1. Crea un flusso utilizzando la Console di gestione AWS.
2. Attiva lo streaming dei dati per l'istanza.
3. Per testare la configurazione, completa una delle seguenti serie di passaggi a seconda del caso d'uso:

Hai attivato lo streaming di dati per gli eventi di contatto:

1. Effettua una chiamata in uscita o in entrata per creare un record di contatto nell'istanza.
2. Conferma che il record del contatto sia stato generato nell'interfaccia utente di ricerca dei contatti.
3. Verifica l'evento del record del contatto nella destinazione configurata nel flusso di distribuzione. Gli eventi di contatto vengono consegnati in blocco. Potresti vedere più ID di contatto consegnati alla destinazione contemporaneamente. Per vedere un esempio, consulta la sezione Sample contact event for when a voice call is connected to an agent (Esempio di evento di contatto quando una chiamata vocale è connessa a un agente).

-oppure-

Hai attivato lo streaming di dati per gli eventi degli agenti:

1. Modifica lo stato di un agente o collegalo a un contatto per creare un evento dell'agente.
2. Verifica l'evento dell'agente nella destinazione configurata per il flusso di dati Kinesis. L'ARN dell'agente è la chiave di partizione utilizzata quando i dati vengono inviati al flusso di dati. Tutti gli eventi per un singolo agente vengono inviati alla stessa partizione e gli eventuali eventi di resharding nel flusso vengono ignorati. Per vedere un esempio, consulta la sezione Sample agent event stream (Esempio di flusso di eventi dell'agente).

Identificazione e risoluzione degli errori

Non vedo i dati pubblicati nella destinazione del mio flusso di distribuzione Kinesis.

Per risolvere il problema della mancata visualizzazione dei dati pubblicati, esegui una o più delle seguenti azioni:

• Verifica che il flusso di dati Kinesis selezionato sia attivato per la crittografia lato server. Se la crittografia lato server è attivata, Amazon Connect non può pubblicare i dati nel flusso a causa della mancanza dell'autorizzazione a chiamare kms:GenerateDataKey. Per risolvere questo problema, segui i passaggi indicati nella pagina Using server-side encryption for Kinesis stream (Utilizzo della crittografia lato server per il flusso Kinesis).
• Testa il flusso di distribuzione utilizzando l'opzione Test demo data (Test dei dati dimostrativi) in Kinesis Data Firehose per verificare che il flusso di distribuzione sia configurato come previsto.
• Controlla la frequenza di consegna dei dati per Kinesis Data Firehose. La frequenza di consegna dei dati può variare a seconda della destinazione selezionata. Se passano cinque minuti e i dati non vengono consegnati, esamina le metriche del flusso di distribuzione per i record in entrata. È possibile configurare la registrazione degli errori per Kinesis Data Firehose al fine di acquisire gli errori di consegna dei dati.

Non riesco a selezionare il flusso di distribuzione Kinesis Data Firehose o il flusso di dati Kinesis che ho creato quando ho attivato il flusso di dati per Amazon Connect.

Innanzitutto, verifica che il flusso Kinesis Data Firehose o il flusso di dati Kinesis esista nella stessa Regione AWS dell'istanza Amazon Connect. Se i servizi si trovano nella stessa Regione, potrebbe mancare un'autorizzazione che consente di elencare il flusso. Verifica che siano concesse le seguenti autorizzazioni: ListDeliveryStreams per Kinesis Data Firehose o ListStreams per il flusso di dati Kinesis.

Puoi anche utilizzare il comando dell'Interfaccia della linea di comando AWS (AWS CLI) associate-instance-storage-config per attivare lo streaming dei dati.

Nota: se ricevi messaggi di errore durante l'esecuzione dei comandi dell'Interfaccia della linea di comando AWS (AWS CLI), assicurati di utilizzare la versione più recente di AWS CLI.

Dove posso accedere agli eventi dell'agente o ai record di tracciamento dei contatti (CTR)?

Se gli eventi dell'agente e i CTR vengono inviati al flusso di dati Kinesis, utilizza il visualizzatore di dati nella console Kinesis per visualizzare i dati. Inoltre, puoi configurare un consumatore per elaborare i dati dal flusso di dati Kinesis. Ad esempio, è possibile creare un flusso Kinesis Data Firehose per utilizzare i dati dal flusso di dati Kinesis per gli eventi dell'agente.

Se i CTR vengono inviati a Kinesis Data Firehose, saranno accessibili nella destinazione configurata per il flusso di distribuzione. Ad esempio, se la destinazione è un bucket Amazon Simple Storage Service (Amazon S3), puoi accedere ai CTR nel bucket S3 scelto. Scegli il bucket di destinazione Amazon S3 quando crei il flusso Kinesis Data Firehose.

Posso configurare più di un flusso di distribuzione Kinesis per i record di tracciamento dei contatti (CTR)?

Per impostazione predefinita, per i CTR è supportato un solo flusso di distribuzione. Tuttavia, è possibile utilizzare più consumatori per disporre di più flussi di distribuzione dei CTR verso un flusso di dati Kinesis Data Stream. Per utilizzare questa configurazione, il flusso di dati Kinesis deve fungere da produttore dei dati CTR. Quindi, puoi configurare più consumatori per importare i dati. Per ulteriori informazioni sui consumatori del flusso di dati Amazon Kinesis, consulta la pagina Reading data from Amazon Kinesis Data Streams (Lettura dei dati dal flusso di dati Amazon Kinesis).

Vedo dati duplicati di Amazon Connect pubblicati nella mia applicazione del flusso di dati Amazon Kinesis.

I dati duplicati possono verificarsi a causa di nuovi tentativi di distribuzione da parte del produttore e del consumatore. È consigliabile che la destinazione dei dati finali gestisca i duplicati in modo da essere resiliente ai nuovi tentativi di distribuzione.

---

Informazioni correlate

Amazon Connect agent event streams (Flussi di eventi dell'agente Amazon Connect)

Amazon Connect contact events (Eventi di contatto Amazon Connect)

What Is Amazon Kinesis Data Streams? (Cos'è il flusso di dati Amazon Kinesis?)

What Is Amazon Kinesis Data Firehose? (Cos'è Amazon Kinesis Data Firehose?)