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à.
Configura i flussi di eventi di Amazon Connect Cases
In questo argomento viene descritto come configurare e utilizzare i flussi di eventi dei casi. Alcune delle fasi di onboarding richiedono di chiamare Amazon Connect Cases. APIs
Passaggio 1: creazione di un'istanza Amazon Connect e abilitazione di Profili cliente
-
Assicurati di avere un'istanza Amazon Connect funzionante in uno dei casi Regioni AWS in cui è disponibile. Per informazioni, consulta Disponibilità di Casi per regione.
-
Abilita Profili cliente Amazon Connect. Per istruzioni, consulta Abilita i profili cliente per la tua istanza Amazon Connect.
Il servizio Profili cliente è necessario per Casi Amazon Connect perché ogni caso deve essere associato a un profilo cliente di quel servizio.
Passaggio 2: aggiunta di un dominio di Casi all'istanza Amazon Connect
Per istruzioni, consulta Abilita i casi utilizzando la console Amazon Connect.
Se desideri aggiungere un case domain utilizzando ilAPI, consulta Amazon Connect Cases API Reference. CreateDomainAPI
Passaggio 1: creazione di un modello di caso
Crea un modello di caso da utilizzare nel Passaggio 6: test dei flussi di eventi dei casi.
Se desideri creare un modello di caso utilizzando ilAPI, consulta il CreateTemplateAPIdocumento Amazon Connect Cases API Reference.
Passaggio 4: abilita i flussi di eventi dei casi e configura la configurazione per ricevere gli eventi in una coda SQS
Esegui il comando riportato sotto per abilitare i flussi di eventi dei casi per il tuo dominio di Casi. Dopo l'esecuzione di questo comando, quando i casi vengono creati o aggiornati, viene pubblicato un evento nel bus predefinito del EventBridge servizio dell'account (deve trovarsi nello stesso Regione AWS dominio Cases).
aws connectcases put-case-event-configuration --domain-id
dad5efb6-8485-4a55-8241-98a88EXAMPLE
--event-bridge enabled=true
Per impostazione predefinita, gli eventi pubblicati da Casi Amazon Connect contengono solo metadati relativi a un caso, ad esempio templateId
, caseId
, caseArn
, approximateChangeTime
e così via. Puoi eseguire il comando riportato sotto per includere nell'evento maggiori informazioni sul caso (al momento della generazione dell'evento).
Nota
Se desideri includere nell'evento un campo personalizzato, utilizza l'ID relativo. Per istruzioni su come trovare l'ID del campo personalizzato, consulta Ricerca dell'ID del campo personalizzato.
# You can include any other field defined in your cases domain in the fields section. # To list the fields that are defined in your cases domain, call the Cases ListFields API. # To include case fields that you create (custom fields) in the event, enter the custom field ID.
aws connectcases put-case-event-configuration --domain-idYOUR_CASES_DOMAIN_ID
--event-bridge "{ \"enabled\": true, \"includedData\": { \"caseData\": { \"fields\": [ { \"id\": \"status\" }, { \"id\": \"title\" }, { \"id\": \"customer_id\" }, { \"id\": \"your custom field ID
\" } ] }, \"relatedItemData\": { \"includeContent\": true } } }"
Quindi, crea una SQS coda Amazon e impostala come destinazione per gli eventi Amazon Connect Cases sul tuo EventBridge bus in modo che tutti gli eventi dei casi vengano inviati alla SQS coda per l'elaborazione successiva.
# Create an SQS queue aws sqs create-queue --queue-name case-events-queue --attributes "{\"Policy\": \"{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": [{ \\\"Sid\\\": \\\"case-event-subscription\\\", \\\"Effect\\\": \\\"Allow\\\", \\\"Principal\\\": { \\\"Service\\\": \\\"events.amazonaws.com\\\"}, \\\"Action\\\": \\\"SQS:SendMessage\\\", \\\"Resource\\\": \\\"*\\\"}]}\"}" # Create an rule on the EventBridge defualt bus that represents the case events aws events put-rule --name case-events-to-sqs-queue --event-pattern "{\"source\": [\"aws.cases\"]}" --state ENABLED # Ask event bridge to publish case events to the SQS queue. aws events put-targets --rule case-events-to-sqs-queue --target "[{ \"Id\": \"target-1\", \"Arn\": \"arn:aws:sqs:
The AWS Region of your Amazon Connect instance
:your AWS account ID
:case-events-queue\" }]"
Passaggio 5: test dei flussi di eventi dei casi
Utilizza l'applicazione degli agenti Amazon Connect per:
-
Accettare un contatto tramite chat.
-
Creare un profilo cliente e associarlo al contatto tramite chat.
-
Creare un caso.
Nota
Il pulsante Crea caso nella scheda Casi diventerà attivo solo dopo che avrai accettato un contatto e lo avrai associato a un profilo cliente.
Accedi alla SQS console Amazon e verifica che un evento del caso (tipo:CASE.CREATED
) per il caso appena creato sia disponibile nella tua SQS coda. Allo stesso modo, puoi modificare il caso creato sopra e inserire un evento case corrispondente (tipo:CASE.UPDATED
) nella tua SQS coda. associare il contatto al caso e lasciare un commento su quest'ultimo (anche in questo caso, verranno mostrati eventi relativi a tali azioni).
Passaggio 6: utilizzo di casi per i flussi di eventi dei casi
I flussi di eventi dei casi pubblicano eventi ogni volta che un caso viene creato o aggiornato, oppure quando ad esso viene associato un contatto o aggiunto un commento. Puoi utilizzare questi eventi per:
-
Metriche, analisi e dashboard
-
App che avvisino gli utenti (ad esempio, tramite l'invio di e-mail)
-
Azioni automatiche che vengono attivate in base a determinati tipi di aggiornamenti dei casi
Ad esempio, puoi utilizzare SQS target on EventBridge (come mostrato nel passaggio 4) per archiviare temporaneamente gli eventi dei casi nella SQS coda e utilizzare le funzioni Lambda per elaborare gli eventi per creare applicazioni personalizzate come SQS l'invio di e-mail al cliente quando il caso viene aggiornato, la risoluzione automatica di tutte le attività collegate al caso e altro ancora. Allo stesso modo, puoi utilizzare il target Firehose EventBridge per archiviare gli eventi dei casi in un bucket S3 e quindi utilizzare for AWS Glue , ETL Athena per analisi ad hoc e Amazon per dashboard. QuickSight