Integrazione di applicazioni di terze parti nello spazio di lavoro dell’agente Amazon Connect

Apri la Connect Customer console ()https://console.aws.amazon.com/connect/.

Nel riquadro di navigazione a sinistra, scegli Integrazioni. Se questo menu non è presente, significa che non è disponibile nella tua Regione. Per scoprire in quali regioni è disponibile questa funzionalità, consulta Disponibilità delle Connect Customer funzionalità per regione.

Nella pagina Integrazioni, scegli Aggiungi integrazione.

Nella pagina Aggiungi integrazione, inserisci:

1. Informazioni di base

   1. Nome visualizzato: un nome descrittivo per l'integrazione. Questo nome verrà visualizzato nei profili di sicurezza e mostrato agli agenti nella scheda all’interno dello spazio di lavoro dell’agente. Puoi tornare indietro e cambiare questo nome.

   2. Descrizione (opzionale): puoi facoltativamente fornire qualsiasi descrizione per questa integrazione. Questa descrizione non verrà mostrata agli agenti.

   3. Tipo di integrazione: indica se l'integrazione è un'applicazione Web, un servizio o un server MCP standard. Ciò determina in che modo verrà effettuato l'accesso all'integrazione all'interno del sistema.

   4. Identificatore di integrazione: il nome ufficiale unico per le integrazioni di tipo applicazione o servizio standard. Se disponi di una sola applicazione per URL di accesso, è consigliabile utilizzare l'origine dell'URL di accesso. Questo nome non può essere modificato.

   5. Timeout di inizializzazione: il tempo massimo consentito per stabilire una connessione con lo spazio di lavoro. Il tempo consentito è espresso in millisecondi. Questa impostazione consente di gestire i problemi di connessione e garantisce l’avvio tempestivo dell’applicazione.

2. Dettagli dell'applicazione

   1. Ambito di contatto: indica se l'applicazione Web si aggiorna per ogni contatto o si aggiorna solo con ogni nuova sessione del browser. Questa impostazione influisce sulla frequenza con cui l’applicazione aggiorna i propri dati.

   2. Timeout di inizializzazione: il tempo massimo consentito per stabilire una connessione con lo spazio di lavoro. Il tempo consentito è espresso in millisecondi. Questa impostazione consente di gestire i problemi di connessione e garantisce l’avvio tempestivo dell’applicazione.

3. Accesso

   1. URL di accesso: l'URL in cui è ospitata l'applicazione. L’URL deve essere sicuro e iniziare con https, a meno che non si tratti di un host locale.

      Nota

      Non tutti URLs possono essere iframed. Ecco due modi per verificare se l'URL può essere racchiuso in iframe:

      1. Per verificare se un URL può essere racchiuso in iframe, è disponibile uno strumento di terze parti denominato Iframe Tester.

         1. Se un URL può essere racchiuso in iframe, ne verrà eseguito il rendering in anteprima in questa pagina.

         2. Se un URL non può essere racchiuso in iframe, verrà visualizzato un errore nell'anteprima di questa pagina.

            • È possibile che questo sito web visualizzi un errore e che sia comunque possibile racchiudere l'app in iframe nel workspace dell'agente. Questo perché lo sviluppatore dell'app può bloccare la propria app in modo che sia incorporabile solo nel workspace e da nessun'altra parte. Se questa app ti è stata fornita da uno sviluppatore di app, ti consigliamo di provare comunque a integrarla nel workspace dell'agente.

      2. Per gli utenti tecnici: controlla il contenuto della policy di sicurezza dell'applicazione che stai tentando di integrare.

         1. Firefox: menu con tre lineette > Altri strumenti > Strumenti per sviluppatori web > Rete

         2. Chrome: menu con tre puntini > Altri strumenti > Strumenti per sviluppatori > Rete

         3. Altri browser: individua le impostazioni di rete negli strumenti per sviluppatori.

         4. La direttiva Content-Security-Policy frame-ancestors dovrebbe essere. https://your-instance.my.connect.aws

            1. Se la direttiva è same origin odeny, allora questo URL non può essere iframed da Connect AWS/Amazon

      Ecco cosa puoi fare se l’app non può essere racchiusa in iframe:

      • Se controlli l’app/URL, puoi aggiornare la policy di sicurezza dei contenuti dell’app. Segui le best practice per gli sviluppatori di app nella sezione Assicurare che le app possano essere incorporate solo nello spazio di lavoro dell’agente di Amazon Connect, disponibile qui.

      • Se non controlli l’app/URL, puoi provare a contattare lo sviluppatore dell’app e chiedergli di aggiornare la policy di sicurezza dei contenuti dell’app.

   2. Origini approvate (opzionale): elenco di URLs indirizzi consentiti, se diversi dall'URL di accesso. L’URL deve essere sicuro e iniziare con https, a meno che non si tratti di un host locale.

4. Aggiungi autorizzazioni a eventi e richieste.

   Di seguito è riportato un esempio di come effettuare l’onboarding di una nuova applicazione e assegnare autorizzazioni ad essa utilizzando la Console di gestione AWS. In questo esempio, all'applicazione vengono assegnate sei diverse autorizzazioni.

   Fornire informazioni di base e dettagli di accesso

5. Associazione di istanze

   1. Puoi consentire l'accesso a questa applicazione da parte di qualsiasi istanza all'interno dell'account-regione.

   2. Sebbene l'associazione dell'integrazione a un'istanza sia facoltativa, non sarà possibile utilizzare questa applicazione finché non la si associa a una o più istanze.

      Nota

      Per i server MCP, è possibile selezionare solo l'istanza configurata con l'URL Discovery del Gateway selezionato.

Concessione delle autorizzazioni all'applicazione per l'integrazione dei dati del workspace

Configurazione di iframe

Scegli Aggiungi integrazione.

Se l'integrazione è stata creata correttamente, verrai indirizzato alla pagina dei dettagli dell'integrazione e vedrai un banner di successo.

Puoi modificare determinati attributi di un'app esistente, come Nome visualizzato, URL di accesso e Autorizzazioni.

1. Se si è verificato un errore durante la creazione dell'applicazione o l'associazione dell'applicazione a un'istanza, verrà visualizzato un messaggio di errore e sarà possibile eseguire l'azione corrispondente per correggere il problema.