Intégration de 3CX avec Office 365 via l'API Azure

Les éditions PBX 3CX v16 Pro et Enterprise offrent une intégration complète avec les applications Office 365. En particulier, les éléments suivants sont implémentés :

  • Synchronisation des utilisateurs Office 365 et des extensions 3CX (utilisateurs).
  • Synchronisation des contacts personnels des utilisateurs d'Office et du carnet d'adresses personnel de 3CX.
  • Synchronisation des statuts du calendrier utilisateur Office 365 (occupé) et du statut du numéro de poste 3CX.   

Pour passer des appels sortants depuis l'interface web des applications Office, 3CX utilise l'extension 3CX Cliquez pour appeler pour les navigateurs Chrome и Firefox. Vous pouvez également utiliser des raccourcis clavier dans Application 3CX pour Windows.

Pour commencer, vous aurez besoin d'un abonnement Office 3CX et d'informations d'identification d'administrateur du portail Office avec les privilèges « Administrateur global ».

Certains abonnements Office 365 ont une intégration limitée ou inexistante avec 3CX :

  • Abonnements sans gestion des utilisateurs, c'est-à-dire tous les abonnements « maison ».
  • Les abonnements sans Exchange ne peuvent pas synchroniser les contacts et le calendrier (Office 365 Business et Office 365 Pro Plus).

Les serveurs Office 365 doivent avoir une connexion directe à votre serveur 3CX pour transmettre les statuts en temps réel. Si une connexion persistante n'est pas possible, 3CX effectuera quand même une synchronisation quotidienne.

Veuillez noter que la synchronisation s'effectue dans un seul sens : d'Office 365 vers 3CX. Pour une synchronisation réussie, les utilisateurs d'Office 365 doivent avoir l'attribut « UserType » défini sur « Member » (défini dans Active Directory). Si un utilisateur synchronisé depuis Office 365 est supprimé ou modifié via l'interface 3CX, il revient à l'état précédent lors de la prochaine synchronisation manuelle ou automatique.

Application d'authentification Microsoft Azure

Intégration de 3CX avec Office 365 via l'API Azure

Première étape de connexion Intégration d'Office 365 — création d'une application individuelle dans votre compte pour autoriser l'intégration.

  1. Dans l'interface de gestion de 3CX, allez dans Paramètres - Office 365 - Onglet Paramètres - Section Étape 3 et copiez l'URL de redirection.
  2. Connectez-vous au portail Office 365 avec vos informations d'identification d'administrateur global et accédez à Inscriptions d'applications Microsoft Azure.
  3. Cliquez sur Nouvel enregistrement et spécifiez le nom de l'application, par exemple, 3CX PBX Office 365 Sync App.
  4. Dans la section Types de comptes pris en charge, laissez l'option par défaut Comptes dans cet annuaire d'organisation uniquement.
  5. Dans la section URI de redirection (facultatif), sélectionnez le type Web et collez l'URI de redirection depuis la section de l'interface 3CX : Paramètres > Intégration Office 365 > onglet Paramètres > Étape 3. Section Plateforme et autorisations, par ex. entreprise.3cx.eu:5001/oauth2bureau2
  6. Cliquez sur S'inscrire et l'application sera créée.
  7. La page des paramètres de l'application créée s'ouvre. Copiez la valeur App ID (Client) et collez-la depuis le champ approprié dans l'interface de gestion 3CX, Paramètres > Intégration Office 365 > onglet Options > Étape 1. Configurez l'App ID.

Intégration de 3CX avec Office 365 via l'API Azure

Clés d'authentification

Vous devez maintenant établir une confiance de clé publique entre votre système 3CX v16 et l'application créée dans le portail Office 365.

  1. Dans l'interface 3CX (Paramètres > Intégration Office 365 > onglet Options), cliquez sur Générer une nouvelle paire de clés et enregistrez la clé public_key.pem.
  2. Accédez à la page des paramètres de l'application dans la section Certificats et secrets. Cliquez sur Télécharger le certificat et téléchargez la clé générée.

Intégration de 3CX avec Office 365 via l'API Azure
Intégration de 3CX avec Office 365 via l'API Azure

Autorisations d'application

La dernière étape de configuration consiste à définir les autorisations API dans la section Autorisations API. Ces autorisations déterminent comment votre système 3CX peut accéder à votre compte Office 365.

  1. Accédez à Autorisations API, cliquez sur Ajouter une autorisation et sélectionnez Microsoft Graph.
  2. Ajoutez des autorisations API sous Autorisations d'application : Calendriers > Calendriers.Read, Contacts > Contacts.Read, Répertoire > Répertoire.Read.All et cliquez sur Ajouter des autorisations.
  3. Dans la section Accorder le consentement, cliquez sur Accorder le consentement de l'administrateur pour... pour activer les autorisations.
  4. Attendez environ 10 minutes pour que les modifications prennent effet correctement.
  5. Basculez vers l'interface 3CX et dans la section Intégration avec Office 365, cliquez sur Se connecter à Office 365. Confirmez les autorisations pour l'application créée et la connexion entre les systèmes sera établie.

Intégration de 3CX avec Office 365 via l'API Azure

Capacités de synchronisation

La synchronisation entre 3CX et Office 365 est configurée dans trois onglets :

  • Synchronisation des utilisateurs - Les utilisateurs d'Office 365 sont synchronisés avec les utilisateurs de 3CX (extensions). Dans l’interface de gestion 3CX, les utilisateurs synchronisés sont placés dans le groupe organisationnel Azure AD.
  • Synchronisation des contacts - Les contacts personnels d'Office 365 sont synchronisés avec le carnet d'adresses 3CX. L'utilisateur voit ces contacts dans les applications 3CX pour toutes les plateformes.
  • Synchronisation du calendrier - change automatiquement le statut d'une extension 3CX selon qu'elle est occupée ou non dans le calendrier Office 365 :

Une fois qu'un événement dans le calendrier Office 365 est terminé, le statut de l'utilisateur 3CX est également synchronisé et renvoyé à son état précédent.

Tous les éléments de synchronisation peuvent être configurés à la fois pour tous les utilisateurs d'Office 365 et pour les utilisateurs sélectionnés.

Intégration de 3CX avec Office 365 via l'API Azure

Ceci termine l’intégration.

Source: habr.com

Ajouter un commentaire