- Home
- /
- Articolo
Grazie per il feedback.
In questo articolo
Feedback?Creare e autenticare una risorsa digitale e-mail in Control Hub, quindi assegnarla a un servizio Webex come Webex Connect o Webex Contact Center.
Panoramica
Utilizza Digital Assets in Control Hub per configurare la casella di posta e l'autenticazione OAuth 2.0 utilizzate dai servizi Webex per le interazioni e-mail. Lei gestisce la risorsa in Control Hub e i carichi di lavoro Webex approvati vi accedono tramite il servizio di risorse digitali condivise.
Quando crea la risorsa, la assegni al servizio Webex che la utilizzerà. Una volta completata l'autenticazione, Control Hub genera un indirizzo di inoltro per la posta elettronica in entrata. Per Webex Contact Center, può quindi associare la risorsa a un punto di ingresso e-mail. Per un altro carico di lavoro Webex, continua la configurazione in quel carico di lavoro dopo aver creato la risorsa.
Prima che Lei cominci
- Accedi a Control Hub come amministratore completo, amministratore clienti o amministratore partner in grado di gestire le risorse digitali per la sua organizzazione.
- Utilizza un provider di posta elettronica supportato. Per l'integrazione con Webex Contact Center conWebex Connect, Gmail e Microsoft 365 sono i provider supportati. Per dettagli specifici del fornitore, vedere Email - WXCC.
- Prepari la casella di posta che desidera configurare. Se utilizza un account di servizio, si assicuri che possa inviare email e accedere a quella casella di posta.
- Collabori con l'amministratore del suo fornitore di identità per registrare un'applicazione OAuth, concedere il consenso e attivare le impostazioni del provider come SMTP AUTH o l'inoltro esterno.
- Si prepari a copiare l'URL di richiamo da Control Hub nell'URL di reindirizzamento dell'applicazione OAuth e a configurare l'inoltro automatico all'indirizzo generato per la risorsa email.
Preparare Gmail per OAuth 2.0
Per preparare un account Gmail per la risorsa email:
| 1 |
Accedi alla console Google Cloud e crea un progetto o seleziona un progetto esistente. |
| 2 |
Vai su API e servizi > schermata di consenso OAuth, seleziona Esterno e inserisci il nome dell'app, l'email dell'assistenza utente e le informazioni di contatto dello sviluppatore. |
| 3 |
Se l'app rimane in Testing, aggiunga la casella di posta o l'identità di generazione di token come utente di test. Un progetto può avere fino a 100 utenti di test. |
| 4 |
Vai su API e servizi > Credenziali, crea un ID client OAuth per un'applicazione Web e copia l'ID cliente e il segreto cliente. |
| 5 |
Quando Control Hub mostra l'URL di richiamo, ritorni al client OAuth e aggiunga quel valore come URI di reindirizzamento autorizzato. |
| 6 |
Per uso in produzione, pubblichi l'app OAuth e completi tutte le verifiche Google richieste per l'ambito richiesto. |
| 7 |
Registrare i seguenti valori del provider per la configurazione di Control Hub:
Per un'app Google OAuth esterna in Testing, le autorizzazioni degli utenti di test e i token di aggiornamento scadono sette giorni dopo il consenso. Pubblichi l'app per uso in produzione. Se Google non restituisce un token di aggiornamento, esegui nuovamente il flusso di consenso e seleziona Vorrei esaminare esplicitamente prima di fornire il consenso all'autenticazione quando tale opzione è disponibile. La documentazione SMTP OAuth di Google spiega l'ambito OAuth SMTP di Gmail. Le linee guida OAuth per il pubblico di Google spiegano i segmenti di pubblico interni ed esterni e il comportamento sullo stato di pubblicazione. |
Preparare Microsoft 365 per OAuth 2.0
Per preparare una casella di posta Microsoft 365 per la risorsa e-mail:
| 1 |
Nell'interfaccia di amministrazione di Microsoft Entra, vada su Registrazioni app, selezioni Nuova registrazione e registri l'applicazione per i tipi di account consentiti dalla sua organizzazione. |
| 2 |
Registrare l'ID dell'applicazione (cliente) e l'ID della rubrica (tenant). |
| 3 |
In Autenticazione, aggiunga una piattaforma Web. Quando Control Hub mostra l'URL di richiamo, aggiunga quel valore come URI di reindirizzamento. |
| 4 |
In Certificati e segreti, crei un segreto per il cliente e ne copia il valore prima di lasciare la pagina. |
| 5 |
Per il flusso di codice di autorizzazione interattivo utilizzato quando seleziona Genera token, aggiunga l'autorizzazione delegata di Office 365 Exchange Online SMTP.send (https://outlook.office.com/SMTP.Send) e richieda l'ambito offline_access. Concedi il consenso dell' amministratore se la politica di consenso della sua organizzazione lo richiede. |
| 6 |
Nell'interfaccia di amministrazione di Microsoft 365, vai su Utenti > Utenti attivi, seleziona l'utente della casella di posta, seleziona Posta > Gestisci app di posta elettronica, attiva l'SMTP autenticato per quella casella di posta e salva le modifiche. |
| 7 |
Registrare i seguenti valori del fornitore. Sostituisci {tenant-id} con l'ID Directory (tenant) dalla registrazione dell'app:
Usa l'ambito delegato https://outlook.office.com/SMTP.Send con offline_access per questo flusso di token interattivo. Abilita SMTP AUTH solo per la casella di posta che ne ha bisogno. Se la sua organizzazione ha recentemente modificato le impostazioni di consenso di Microsoft Entra, attenda che le modifiche abbiano effetto prima di generare i token. Le linee guida SMTP OAuth di Microsoft riguardano SMTP.send e offline_access delegati. La configurazione SMTP AUTH di Microsoft spiega come abilitare SMTP AUTH per una casella di posta specifica. |
Configurare la risorsa e-mail in Control Hub
Per configurare una risorsa email:
| 1 |
Accedi a Control Hub. |
| 2 |
Vai a Servizi > Risorse digitali. |
| 3 |
Seleziona Crea risorsa. |
| 4 |
Nella sezione Configura i dettagli degli asset, inserisca i valori nei seguenti campi:
|
| 5 |
In Provider di posta elettronica > Mailbox, inserisca l'indirizzo email della casella di posta utilizzata dalla risorsa. |
| 6 |
Nella sezione Autenticazione OAuth 2.0, inserisca i valori nei seguenti campi:
|
| 7 |
Nel suo provider di identità, aggiunga l'URL di richiamo da Control Hub all'applicazione OAuth, salvi la configurazione del provider e confermi che l'URI di reindirizzamento corrisponda esattamente. |
| 8 |
Se la persona che concede il consenso utilizza un indirizzo email diverso dalla casella di posta, seleziona Genera token utilizzando un indirizzo email diverso dall'indirizzo della casella di posta e inserisci quell'identità. Cassetta postale condivisa: una casella di posta condivisa non ha le proprie credenziali di accesso . Genera token con un utente che può accedere alla casella di posta condivisa e dispone dell'autorizzazione Invia come; l'utente non ha bisogno dell'accesso come amministratore. Seleziona Genera token utilizzando un indirizzo email diverso dall'indirizzo della casella di posta quando l' indirizzo dell'utente è diverso dalla casella di posta. |
| 9 |
Seleziona Genera token, completa il flusso di accesso e consenso del fornitore di identità e torna a Control Hub. Una volta completata la generazione del token, i campi Token di accesso, Refresh token e Validità vengono compilati automaticamente. Restrizione del consenso: se il suo provider blocca il consenso dell'utente, chiaro che vorrei esaminare esplicitamente prima di fornire il consenso all'autenticazione. L'opzione può far fallire l'autenticazione perché l' utente non può concedere il consenso richiesto. Chieda invece all'amministratore del fornitore di concedere il consenso richiesto. Se la generazione di token non funziona: per Gmail, si assicuri che l'utente possa autorizzare l'app e che l'app abbia lo stato di pubblicazione corretto. Per Microsoft 365, controlli l'ambito offline_access, la politica di consenso, l'URI di reindirizzamento e le impostazioni di autenticazione SMTP. Corregge la configurazione del provider e poi genera nuovamente i token. Rinnovo dei token: il servizio aggiorna i token prima che scadano. Se il proprietario di un inquilino riceve un'email automatica che richiede la rigenerazione dei token, apra l' asset e seleziona nuovamente Genera token. |
| 10 |
Una volta completata la generazione del token, seleziona Crea. Se la risorsa è assegnata al Webex Contact Center, selezionare Vai ai punti di ingresso e continuare la configurazione del Contact Center. Per un altro carico di lavoro Webex, chiuda la pagina di conferma e continui la configurazione con quel carico di lavoro. |
Configurare l'inoltro delle email in entrata
Innanzitutto, copi l'indirizzo di inoltro generato per la risorsa:
| 1 |
In Digital Assets, apra la risorsa email e seleziona Impostazioni. |
| 2 |
In Provider di posta elettronica > Cassetta postale, copi l'indirizzo di inoltro associato all'indirizzo email della casella di posta. |
Configurare l'inoltro in Gmail
Per inoltrare i messaggi di Gmail in arrivo alla risorsa email:
| 1 |
Se utilizza Google Workspace, si assicuri che il suo amministratore consenta l'inoltro automatico per l'unità organizzativa della casella di posta in App > Google Workspace > Gmail > Accesso utente finale. |
| 2 |
Accedi alla casella di posta di assistenza in Gmail e vai su Impostazioni > Visualizza tutte le impostazioni > Inoltro e POP/IMAP. |
| 3 |
Seleziona Aggiungi un indirizzo di inoltro, incolla l'indirizzo di inoltro da Control Hub e poi completa le istruzioni di conferma. Gmail invia un link o un codice di verifica all'indirizzo generato. |
| 4 |
Recupera il link o il codice di verifica dal payload Outbound Webhook per le email in entrata Webex Connect o dal corpo completo dell'email nei log di debug decrittografati della risorsa email. Quindi completi la verifica di Gmail. |
| 5 |
Tornare alle impostazioni di inoltro di Gmail, aggiorna la pagina, seleziona Inoltra una copia della posta in arrivo a, scelga cosa deve fare Gmail con la sua copia e seleziona Salva modifiche. |
Configurare l'inoltro in Microsoft 365
Per inoltrare i messaggi Microsoft 365 in arrivo alla risorsa email:
| 1 |
Configura l'inoltro della casella di posta o una regola di posta in arrivo per la casella di posta di supporto in modo che i nuovi messaggi vengano inviati all'indirizzo di inoltro da Control Hub. |
| 2 |
Nel portale Microsoft Defender, riveda la politica sullo spam in uscita che si applica alla casella di posta. Imposta le regole di inoltro automatico su Attivato - L'inoltro è abilitato in una politica con ambito ristretto che il suo amministratore della sicurezza ha approvato. |
| 3 |
In Exchange Online, si assicuri che l'impostazione del dominio remoto applicabile consenta l'inoltro automatico al dominio dell'indirizzo di inoltro. |
| 4 |
Riveda le regole del flusso di posta di Exchange e si assicuri che nessuna regola blocchi i messaggi inoltrati automaticamente. Se ha bisogno di un'eccezione, la limiti alla casella di posta dell'assistenza e alla destinazione approvata. |
| 5 |
Salva la configurazione di inoltro e concedi il tempo necessario affinché le modifiche alla politica di Microsoft 365 abbiano effetto. Obbligatorio: l'email in entrata non raggiungerà il carico di lavoro Webex assegnato finché l'inoltro non sarà abilitato. In Microsoft 365, una politica di blocco dello spam in uscita, un'impostazione di dominio remoto o una regola del flusso di posta hanno la precedenza su un'impostazione che consente l'inoltro. Limite di allegati: gli allegati e-mail in entrata sono limitati a 25 MB. Se un messaggio non va a buon fine perché i suoi allegati sono troppo grandi, il mittente riceve un messaggio di mancato recapito e deve inviarlo nuovamente con allegati più piccoli. Immagini in linea: le immagini in linea arrivano come allegati sul desktop dell'agente. Se la scansione PCI è abilitata, quelle immagini sono bloccate. Microsoft Outlookallegati: Un'email in entrata con un allegato .msg potrebbe arrivare senza i file incorporati in quel .msg a causa di una limitazione. Microsoft Outlook |
Testare la risorsa di posta elettronica
Per verificare il percorso email completo:
| 1 |
Da un account e-mail esterno, invii un messaggio alla casella di posta di supporto configurata e si assicuri che il messaggio raggiunga il carico di lavoro Webex assegnato. |
| 2 |
Dal carico di lavoro Webex assegnato, invii un nuovo messaggio o risponda al messaggio in entrata e si assicuri che il destinatario esterno lo riceva. Stato di consegna: le email inviate tramite il canale SMTP non includono il monitoraggio della consegna e il servizio non riceve notifiche di mancata consegna . Confermi la consegna dalla casella di posta del destinatario durante il test. |
| 3 |
Se la consegna in entrata non funziona, controlli la conferma dell'indirizzo di inoltro del fornitore, la regola di inoltro e le politiche di inoltro dell'organizzazione. |
| 4 |
Se l'invio in uscita non funziona, controlli il server e la porta SMTP, le autorizzazioni del provider, le credenziali del cliente, il consenso, l'impostazione di autenticazione SMTP di Microsoft 365 e lo stato del token. Risolve il problema e genera nuovamente i token se necessario. |
