Vai al contenuto principale

Guida all’integrazione Mail e Calendario - Microsoft Entra ID (Azure AD)↔ TAC

Questa integrazione consente a TAC di sincronizzare email e eventi di calendario associati ai contatti, permettendo di visualizzare lo storico completo delle attività (comunicazioni email e inviti a call) direttamente nel profilo del contatto.


1. Accesso a Microsoft Entra ID

  1. Accedi al portale di Microsoft Entra

  2. Assicurati di avere permessi amministrativi sulla directory.


2. Registrazione dell’applicazione

  1. Vai in Applications → App registrations

  2. Clicca su New registration

  3. Compila i campi principali:

    • Name: TAC – Mail & Calendar Integration

    • Supported account types: Single tenant (consigliato)

    • Redirect URI:

      • Tipo: Web

      • URL:

        <https://app.touchandcontact.com/>
  4. Opzionalmente, abilita "ID tokens" e "Live SDK support" solo se necessario a seconda della configurazione della directory del cliente.


3. Configurazione dei permessi API

Accedi alla sezione API permissions dell’app appena creata.

3.1 Permessi dell’applicazione (Application permissions)

Aggiungi i seguenti permessi:

  • Directory.Read.All

  • Group.Read.All

  • GroupMember.Read.All

  • User.Read

  • User.Read.All

  • Mail.Read

  • Calendars.Read

  • Mail.Send

Questi permessi permettono a TAC di:

  • leggere utenti, gruppi e ruoli

  • accedere alle email

  • leggere gli eventi di calendario (inviti a call, meeting, ecc.)

3.2 Permessi delegati (Delegated permissions)

Aggiungi:

  • email

  • offline_access

  • openid

  • profile

3.3 Consenso amministrativo

Clicca su: Grant admin consent for Directory predefinita

⚠️ Questo passaggio è fondamentale affinché l’integrazione funzioni correttamente per tutti gli utenti.


4. Certificati e segreti

  1. Vai in Certificates & secrets

  2. Crea un nuovo Client Secret

  3. Copia subito il valore del secret (verrà mostrato una sola volta)

Conserva:

  • Tenant ID

  • Client ID

  • Client Secret


5. Configurazione nel portale TAC

  1. Accedi al portale TAC:

  2. Vai in Integrazioni

  3. Inserisci i parametri richiesti:

    • Tenant ID

    • Client ID

    • Client Secret

  4. Abilita le funzionalità:

    • Importa email

    • Sincronizzazione calendario

    • ✅ Invio email

Salva la configurazione.


6. Risultato dell’integrazione

Una volta completata l’integrazione:

  • TAC sincronizza email inviate e ricevute

  • TAC sincronizza eventi di calendario e inviti a call

  • Ogni contatto mostra uno storico attività completo, utile per:

    • avere contesto prima di una call

    • tracciare follow-up

    • migliorare collaborazione e continuità commerciale

Hai ricevuto la risposta alla tua domanda?