- Accueil
- /
- Article
Merci pour votre commentaire.
Dans cet article
Un commentaire ?Créez et authentifiez un contenu numérique de messagerie dans Control Hub, puis attribuez-le à un service Webex tel que Webex Connect ou Webex Contact Center.
Vue d'ensemble
Utilisez les actifs numériques dans Control Hub pour configurer la boîte aux lettres et l'authentification OAuth 2.0 que les services Webex utilisent pour les interactions par e-mail. Vous gérez l'actif dans Control Hub et les charges de travail Webex approuvées y accèdent via le service de ressources numériques partagées.
Lorsque vous créez la ressource, attribuez-la au service Webex qui l'utilisera. Une fois l'authentification réussie, Control Hub génère une adresse de transfert pour les e-mails entrants. Pour Webex Contact Center, vous pouvez ensuite associer l'actif à un point d'entrée de messagerie. Pour une autre charge de travail Webex, poursuivez la configuration de cette charge de travail après avoir créé la ressource.
Avant de commencer
- Connectez-vous à Control Hub en tant qu'administrateur à part entière, administrateur client ou administrateur partenaire capable de gérer les actifs numériques de votre organisation.
- Utilisez un fournisseur de messagerie compatible. En ce qui concerne l'intégration du centre de contact Webex à Gmail et Microsoft 365 sont les fournisseurs pris en charge. Webex Connect Pour les informations spécifiques aux fournisseurs, voir E-mail - WXCC.
- Préparez la boîte aux lettres que vous souhaitez configurer. Si vous utilisez un compte de service, assurez-vous qu'il peut envoyer des e-mails et accéder à cette boîte aux lettres.
- Travaillez avec l'administrateur de votre fournisseur d'identité pour enregistrer une application OAuth, donner votre consentement et activer les paramètres du fournisseur tels que SMTP AUTH ou le transfert externe.
- Soyez prête à copier l'URL de rappel depuis Control Hub dans l'URL de redirection de l'application OAuth et à configurer le transfert automatique vers l'adresse générée pour la ressource e-mail.
Préparez Gmail pour OAuth 2.0
Pour créer un compte Gmail pour la messagerie électronique :
| 1 |
Connectez-vous à la console Google Cloud et créez un projet ou sélectionnez un projet existant. |
| 2 |
Accédez à API et services > Écran de consentement OAuth, sélectionnez Externe et saisissez le nom de l'application, l'adresse e-mail du support utilisateur et les coordonnées du développeur. |
| 3 |
Si l'application reste dans Testing, ajoutez la boîte aux lettres ou l'identité de génération de jetons en tant qu'utilisateur de test. Un projet peut avoir jusqu'à 100 utilisateurs de test. |
| 4 |
Accédez à API et services > Identifiants, créez un identifiant client OAuth pour une application Web et copiez l'ID client et le secret client. |
| 5 |
Lorsque Control Hub affiche l'URL de rappel, retournez au client OAuth et ajoutez cette valeur en tant qu'URI de redirection autorisé. |
| 6 |
Pour une utilisation en production, publiez l'application OAuth et effectuez toutes les vérifications Google requises pour la portée demandée. |
| 7 |
Enregistrez les valeurs de fournisseur suivantes pour la configuration du Control Hub :
Pour une application Google OAuth externe en cours de test, les autorisations des utilisateurs de test et les jetons d'actualisation expirent sept jours après le consentement. Publiez l'application pour une utilisation en production. Si Google ne renvoie pas de jeton d'actualisation, relancez le flux de consentement et sélectionnez Je voudrais vérifier explicitement avant de donner votre consentement à l'authentification lorsque cette option sera disponible. La documentation SMTP OAuth de Google explique la portée du protocole SMTP OAuth de Gmail. Le guide d'audience OAuth de Google explique les audiences internes et externes et leur comportement en matière de statut de publication. |
Préparez Microsoft 365 pour OAuth 2.0
Pour préparer une boîte aux lettres Microsoft 365 pour la messagerie électronique :
| 1 |
Dans le centre d'administration Microsoft Entra, accédez à Inscriptions des applications, sélectionnez Nouvelle inscription et enregistrez l'application pour les types de comptes autorisés par votre organisation. |
| 2 |
Enregistrez l'identifiant de l'application (client) et l'identifiant du répertoire (locataire). |
| 3 |
Dans Authentification, ajoutez une plateforme Web. Lorsque Control Hub affiche l'URL de rappel, ajoutez cette valeur comme URI de redirection. |
| 4 |
Dans Certificates & secrets, créez un secret client et copiez sa valeur avant de quitter la page. |
| 5 |
Pour le flux de code d'autorisation interactif utilisé lorsque vous sélectionnez Générer des jetons, ajoutez l'autorisation d'envoi SMTP.Send déléguée à Office 365 Exchange Online (https://outlook.office.com/SMTP.Send) et demandez la portée offline_access. Accordez le consentement de l'administrateur si la politique de consentement de votre organisation l'exige. |
| 6 |
Dans le centre d'administration Microsoft 365, allez dans Utilisateurs > Utilisateurs actifs, sélectionnez l'utilisateur de la boîte aux lettres, sélectionnez Mail > Gérer les applications de messagerie, activez le SMTP authentifié pour cette boîte aux lettres et enregistrez vos modifications. |
| 7 |
Enregistrez les valeurs de fournisseur suivantes. Remplacez {tenant-id} par l'identifiant du répertoire (locataire) lors de l'enregistrement de l'application :
Utilisez la portée déléguée https://outlook.office.com/SMTP.Send avec offline_access pour ce flux de jetons interactif. Activez SMTP AUTH uniquement pour la boîte aux lettres qui en a besoin. Si votre organisation a récemment modifié les paramètres de consentement de Microsoft Entra, attendez que les modifications prennent effet avant de générer des jetons. Le guide SMTP OAuth de Microsoft couvre le SMTP.Send délégué et l'accès hors ligne. La configuration SMTP AUTH de Microsoft explique comment activer SMTP AUTH pour une boîte aux lettres spécifique. |
Configurer la messagerie dans Control Hub
Pour configurer un actif de messagerie :
| 1 |
Connectez-vous à Control Hub. |
| 2 |
Accédez à Services > Actifs numériques. |
| 3 |
Sélectionnez Créer un actif. |
| 4 |
Dans la section Configurer les informations relatives aux actifs, saisissez des valeurs dans les champs suivants :
|
| 5 |
Dans Fournisseur de messagerie > Boîte aux lettres, saisissez l'adresse e-mail de la boîte aux lettres utilisée par l'actif. |
| 6 |
Dans la section Authentification OAuth 2.0, saisissez des valeurs dans les champs suivants :
|
| 7 |
Dans votre fournisseur d'identité, ajoutez l'URL de rappel depuis Control Hub à l'application OAuth, enregistrez la configuration du fournisseur et vérifiez que l'URI de redirection correspond exactement. |
| 8 |
Si la personne qui donne son consentement utilise une adresse e-mail différente de celle de la boîte aux lettres, sélectionnez Générer des jetons en utilisant une adresse e-mail différente de celle de la boîte aux lettres et saisissez cette identité. Boîte aux lettres partagée : une boîte aux lettres partagée ne possède pas ses propres informations de connexion. Générez des jetons auprès d'un utilisateur qui peut accéder à la boîte aux lettres partagée et qui possède l'autorisation Envoyer en tant que ; l'utilisateur n'a pas besoin d'un accès administrateur. Sélectionnez Générer des jetons en utilisant une adresse e-mail différente de celle de la boîte aux lettres lorsque l' adresse de cet utilisateur est différente de celle de la boîte aux lettres. |
| 9 |
Sélectionnez Générer des jetons, complétez le flux de connexion et de consentement du fournisseur d'identité, puis retournez à Control Hub. Une fois le jeton généré, les champs du jeton d'accès, du jeton d'actualisation et de validité sont remplis automatiquement. Restriction de consentement : si votre fournisseur bloque le consentement de l'utilisateur, clairement, je voudrais le vérifier explicitement avant de donner son consentement à l'authentification. Cette option peut entraîner l'échec de l'authentification car l' utilisateur ne peut pas accorder le consentement demandé. Demandez plutôt à l'administrateur du fournisseur d'accorder le consentement requis. Si la génération de jetons ne fonctionne pas : pour Gmail, assurez-vous que l'utilisateur peut autoriser l'application et que celle-ci a le bon statut de publication. Pour Microsoft 365, vérifiez la portée de offline_access, la politique de consentement, l'URI de redirection et le paramètre SMTP AUTH. Corrigez la configuration du fournisseur, puis générez à nouveau les jetons. Renouvellement des jetons : le service actualise les jetons avant leur expiration. Si un locataire reçoit un e-mail automatique lui demandant de régénérer des jetons, ouvrez l' actif et sélectionnez à nouveau Générer des jetons. |
| 10 |
Une fois le jeton généré, sélectionnez Créer. Si l'actif est attribué au centre d'appels Webex, sélectionnez Accéder aux points d'entrée et poursuivez la configuration du centre d'appels. Pour une autre charge de travail Webex, fermez la page de confirmation et poursuivez la configuration de cette charge de travail. |
Configurer le transfert des e-mails entrants
Tout d'abord, copiez l'adresse de transfert générée pour l'actif :
| 1 |
Dans Digital Assets, ouvrez la messagerie et sélectionnez Paramètres. |
| 2 |
Dans Fournisseur de messagerie > Boîte aux lettres, copiez l'adresse de transfert associée à l'adresse e-mail de la boîte aux lettres. |
Configurer le transfert dans Gmail
Pour transférer les messages Gmail entrants vers la messagerie électronique :
| 1 |
Si vous utilisez Google Workspace, assurez-vous que votre administrateur autorise le transfert automatique vers l'unité organisationnelle de la boîte aux lettres sous Applications > Google Workspace > Gmail > Accès utilisateur final. |
| 2 |
Connectez-vous à la boîte aux lettres d'assistance de Gmail et accédez à Réglages > Afficher tous les paramètres > Transfert et POP/IMAP. |
| 3 |
Sélectionnez Ajouter une adresse de transfert, collez l' adresse de transfert depuis Control Hub, puis répondez aux instructions de confirmation. Gmail envoie un lien ou un code de vérification à l'adresse générée. |
| 4 |
Récupérez le lien ou le code de vérification depuis la charge utile du Webhook sortant pour les e-mails entrants Webex Connect ou depuis le corps complet de l'e-mail dans les journaux de débogage déchiffrés de la ressource e-mail. Terminez ensuite la vérification de Gmail. |
| 5 |
Retournez aux paramètres de transfert de Gmail, actualisez la page, sélectionnez Transférer une copie du courrier entrant vers, choisissez ce que Gmail doit en faire et sélectionnez Enregistrer les modifications. |
Configurer le transfert dans Microsoft 365
Pour transférer les messages Microsoft 365 entrants vers la messagerie électronique :
| 1 |
Configurez le transfert de boîte aux lettres ou une règle de boîte de réception pour la boîte aux lettres d'assistance afin que les nouveaux messages soient envoyés à l'adresse de transfert depuis Control Hub. |
| 2 |
Sur le portail Microsoft Defender, consultez la politique en matière de spam sortant qui s'applique à la boîte aux lettres. Activez les règles de transfert automatique. Le transfert est activé dans le cadre d'une politique restreinte approuvée par votre administrateur de sécurité. |
| 3 |
Dans Exchange Online, assurez-vous que le paramètre de domaine distant applicable autorise le transfert automatique vers le domaine de l'adresse de transfert. |
| 4 |
Passez en revue les règles de flux de messagerie d'Exchange et assurez-vous qu'aucune règle ne bloque les messages transférés automatiquement. Si vous avez besoin d'une exception, limitez-la à la boîte aux lettres d'assistance et à la destination approuvée. |
| 5 |
Enregistrez la configuration de transfert et attendez que les modifications apportées aux règles de Microsoft 365 prennent effet. Obligatoire : les e-mails entrants n'atteindront pas la charge de travail Webex assignée tant que le transfert ne sera pas activé. Dans Microsoft 365, une politique de blocage du spam sortant, un paramètre de domaine distant ou une règle de flux de messagerie ont priorité sur un paramètre autorisant le transfert. Limite de pièces jointes : les pièces jointes des e-mails entrants sont limitées à 25 Mo. Si un message échoue parce que ses pièces jointes sont trop volumineuses, l'expéditeur reçoit un message d'échec de livraison et doit le renvoyer avec des pièces jointes plus petites. Images intégrées : Les images intégrées arrivent en pièce jointe sur le bureau de l'agent. Si la numérisation PCI est activée, ces images sont bloquées. Microsoft Outlookpièces jointes : Un e-mail entrant contenant une pièce jointe .msg peut arriver sans que les fichiers ne soient intégrés dans ce fichier .msg pour des raisons de limitation. Microsoft Outlook |
Testez le contenu de la messagerie
Pour vérifier le chemin complet des e-mails :
| 1 |
Depuis un compte de messagerie externe, envoyez un message à la boîte aux lettres d'assistance configurée et assurez-vous que le message atteint la charge de travail Webex assignée. |
| 2 |
À partir de la charge de travail Webex assignée, envoyez un nouveau message ou répondez au message entrant et assurez-vous que le destinataire externe le reçoit. État de livraison : Les e-mails envoyés via le canal SMTP n' incluent pas le suivi des livraisons, et le service ne reçoit pas de notifications d'échec de livraison. Confirmez la livraison depuis la boîte aux lettres du destinataire pendant les tests. |
| 3 |
Si la livraison entrante ne fonctionne pas, vérifiez la confirmation de l'adresse de réexpédition, les règles de réexpédition et les politiques de réexpédition de l'organisation du fournisseur. |
| 4 |
Si l'envoi sortant ne fonctionne pas, vérifiez le serveur et le port SMTP, les autorisations du fournisseur, les informations d'identification du client, le consentement, le paramètre SMTP AUTH de Microsoft 365 et l'état du jeton. Réglez le problème et générez à nouveau des jetons si nécessaire. |
