Prérequis d’intégration

Avant de commencer le processus d’intégration Heedify, votre organisation doit satisfaire plusieurs prérequis. Heedify s’intègre avec Microsoft Teams Phone et Azure Communication Services, nécessitant des rôles administrateur spécifiques, des outils, des licences et des configurations de numéros de téléphone.

Complétez tous les éléments de cette liste avant de planifier votre session d’intégration avec l’équipe Heedify.

Compte Administrateur

Un compte Administrateur Global Microsoft 365 est requis pour :

  • Approuver les permissions d’application pour les applications d’entreprise Heedify
  • Accorder le consentement administrateur pour les permissions de l’API Microsoft Graph
  • Configurer les politiques et paramètres Teams Phone
  • Attribuer des licences aux comptes de ressources

L’Administrateur Global doit être disponible pendant la configuration initiale pour approuver les invites de consentement en temps réel.

PowerShell 7

Les scripts de provisionnement Heedify nécessitent PowerShell 7 ou version ultérieure. Les versions antérieures (Windows PowerShell 5.1) ne sont pas prises en charge.

Installation

  1. Téléchargez PowerShell 7 depuis la page officielle des versions GitHub.
  2. Exécutez l’installateur correspondant à votre système d’exploitation.
  3. Vérifiez l’installation :
pwsh --version

La sortie devrait afficher la version 7.x ou supérieure.

Module PowerShell Microsoft Teams

Installez le module PowerShell Microsoft Teams pour gérer la configuration Teams Phone :

Install-Module -Name MicrosoftTeams -Force -AllowClobber

Après l’installation, connectez-vous à votre tenant :

Connect-MicrosoftTeams

Vous devez exécuter PowerShell en tant qu’administrateur et utiliser le compte Administrateur Global pour vous connecter.

Module PowerShell Microsoft Graph

Installez le module PowerShell Microsoft Graph pour créer des applications d’entreprise et gérer les ressources Azure AD :

Install-Module Microsoft.Graph -Scope CurrentUser -Force

Après l’installation, connectez-vous à Microsoft Graph :

Connect-MgGraph -Scopes "Application.ReadWrite.All"

Le scope Application.ReadWrite.All est requis pour créer l’application d’entreprise Azure Communication Services.

Application d’entreprise Azure Communication Services

Heedify utilise Azure Communication Services (ACS) pour le contrôle des appels. Créez l’application d’entreprise ACS dans votre tenant via le Portail Azure ou PowerShell.

Utilisez le module PowerShell Microsoft Graph pour créer l’application d’entreprise :

  1. Créez l’application d’entreprise Azure Communication Services (principal de service) :
New-MgServicePrincipal -AppId "1fd5118e-2576-4f28-8961-8a9d2ed79f65"

L’App ID 1fd5118e-2576-4f28-8961-8a9d2ed79f65 est l’identifiant d’application connu pour l’intégration Azure Communication Services avec Teams.

  1. Vérifiez que le principal de service a été créé :
Get-MgServicePrincipal -Filter "appId eq '1fd5118e-2576-4f28-8961-8a9d2ed79f65'"

Cette étape est requise uniquement pour le modèle Unify. Les déploiements du modèle Extend utilisent un processus d’inscription d’application différent.

Licences Teams Phone Resource Account

Chaque standard automatique ou file d’attente utilisé par Heedify nécessite une licence Teams Phone Resource Account (également connue sous le nom de licence Microsoft Teams Phone Resource Account ou Utilisateur Virtuel).

Provisionnement des licences Resource Account

  1. Connectez-vous au Centre d’administration Microsoft 365.
  2. Naviguez vers Facturation > Acheter des services.
  3. Recherchez Microsoft Teams Phone Resource Account.
  4. Achetez le nombre de licences requis (une par compte de ressource).

Les licences Resource Account sont gratuites mais doivent être explicitement ajoutées à votre tenant. Elles ne sont pas incluses par défaut.

Attribution des licences aux comptes de ressources

  1. Dans le Centre d’administration Microsoft 365, allez dans Utilisateurs > Utilisateurs actifs.
  2. Sélectionnez le compte de ressource.
  3. Cliquez sur Licences et applications.
  4. Attribuez la licence Microsoft Teams Phone Resource Account.
  5. Enregistrez vos modifications.

Numéros de téléphone Teams avec utilisation Voice App

Heedify nécessite des numéros de téléphone avec des droits d’utilisation Voice App pour les attribuer aux standards automatiques et files d’attente.

Vérification des droits d’utilisation des numéros de téléphone

  1. Ouvrez le Centre d’administration Teams.
  2. Naviguez vers Voix > Numéros de téléphone.
  3. Localisez les numéros de téléphone destinés à Heedify.
  4. Vérifiez que la colonne Utilisation affiche Voice app ou Voice app, Utilisateur.

Acquisition de numéros de téléphone Voice App

Si vous n’avez pas de numéros de téléphone avec utilisation Voice App :

  1. Dans le Centre d’administration Teams, allez dans Voix > Numéros de téléphone.
  2. Cliquez sur Ajouter.
  3. Sélectionnez votre pays/région et le type de numéro.
  4. Sous Utilisation, sélectionnez Voice app (Standard automatique, File d’attente).
  5. Complétez le processus de commande.

Les numéros de téléphone attribués aux utilisateurs (type d’utilisation Utilisateur) ne peuvent pas être directement attribués aux standards automatiques ou files d’attente. Vous devez acquérir des numéros avec des droits d’utilisation Voice App.

Résumé de la liste de vérification d’intégration

Avant de continuer, confirmez :

Prérequis Statut
Compte Administrateur Global disponible ☐
PowerShell 7 installé ☐
Module PowerShell Microsoft Teams installé ☐
Module PowerShell Microsoft Graph installé ☐
Application Azure Communication Services créée (modèle Unify uniquement) ☐
Licences Teams Phone Resource Account provisionnées ☐
Numéros de téléphone avec utilisation Voice App disponibles ☐