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

L'édition PBX 3CX v16 de Pro et Enterprise offre une intégration complète avec les applications Office 365. En particulier, implémenté:

• Synchronisez les utilisateurs d'Office 365 et les extensions 3CX (utilisateurs).
  
• Synchronisez les contacts personnels entre les utilisateurs d'Office et votre carnet d'adresses personnel 3CX.
  
• Synchronisez l'état du calendrier utilisateur Office 365 (occupé) et l'état de l'extension 3CX.
  

Pour effectuer des appels sortants à partir de l'interface Web de l'application Office, 3CX utilise l'extension Click to Call 3CX pour les navigateurs Chrome et Firefox . Vous pouvez également utiliser des raccourcis clavier dans l'application Windows 3CX .

Pour commencer, vous aurez besoin d'un abonnement Office 3CX et des informations d'identification d'administrateur du portail Office avec des privilèges d'administrateur général.

Certains abonnements Office 365 ont une intégration 3CX limitée ou pas du tout:

• Abonnements sans gestion des utilisateurs, c.-à-d. tous les abonnements à domicile.
  
• 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 les rapports d'état en temps réel. S'il n'est pas possible de fournir une connexion permanente, 3CX effectuera toujours la synchronisation quotidienne.

Veuillez noter que la synchronisation n'est qu'une seule façon - d'Office 365 à 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é à partir d'Office 365 est supprimé ou modifié via l'interface 3CX, il reviendra à l'état précédent lors de la prochaine synchronisation manuelle ou automatique.

Application d'authentification Microsoft Azure

La première étape pour connecter l' intégration Office 365 consiste à créer une application personnalisée dans votre compte pour autoriser l'intégration.

1. Dans l'interface de gestion 3CX, accédez à Paramètres - Office 365 - onglet Paramètres - section Étape 3 et copiez l'URL de redirection.
   
2. Connectez-vous au portail Office 365 avec les informations d'identification de l'administrateur global et accédez à la page d' inscription à l'application Microsoft Azure .
   
3. Cliquez sur Nouvel enregistrement et entrez 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 ce répertoire d'organisation uniquement
   
5. Dans la section URI de redirection (facultatif), spécifiez le type Web et insérez l'URI de redirection à partir de la section d'interface 3CX: Paramètres> Intégration Office 365> onglet Paramètres> section Étape 3. Plate-forme et autorisations, par exemple, company.3cx.eu : 5001 / oauth2office2
   
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 de l'ID d'application (client) et collez-la dans le champ correspondant de l'interface de gestion 3CX, Paramètres> Intégration avec Office 365> onglet Paramètres> Étape 1. Configurez l'ID d'application.
   

Clés d'authentification

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

1. Dans l'interface 3CX (Paramètres> Intégration avec Office 365> onglet Paramètres), 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 d'application dans la section Certificats et secrets. Cliquez sur Soumettre le certificat et téléchargez la clé générée.
   

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 accède à votre compte Office 365.

1. Accédez à la section Autorisations API, cliquez sur Ajouter une autorisation et sélectionnez Microsoft Graph.
   
2. Ajoutez des autorisations API dans la section Autorisations d'application: Calendriers> Calendars.Read, Contacts> Contacts.Read, Répertoire> Directory.Read.All, puis 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.
   

Fonctions 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 3CX (numéros de poste). Dans l'interface de gestion 3CX, les utilisateurs synchronisés sont hébergés dans un groupe d'organisation Azure AD.
  
• Synchronisation des contacts - Les contacts personnels d'Office 365 sont synchronisés avec votre carnet d'adresses 3CX. L'utilisateur voit ces contacts dans les applications 3CX pour toutes les plateformes.
  
• Synchronisation de calendrier - Modifiez automatiquement le statut de l'extension 3CX en fonction de votre charge de travail sur le calendrier Office 365:
  

Une fois l'événement terminé sur le calendrier Office 365, le statut d'utilisateur 3CX est également synchronisé et revient à son état précédent.

Tous les éléments de synchronisation peuvent être configurés pour tous les utilisateurs d'Office 365 ainsi que pour les utilisateurs sélectionnés.



Ceci termine l'intégration.