Mambu
Mambu
Breadcrumbs

Collegare Mambu a Microsoft 365 per l'invio di email: guida passo passo

Collegare Mambu a Microsoft 365 per inviare email

Questa guida spiega come preparare Microsoft e collegare a Mambu una casella Microsoft 365.

Prima di iniziare

Servono:

  • L'indirizzo e la password della casella Microsoft 365 che Mambu userà per spedire le email. Durante il collegamento Microsoft potrà chiedere anche la verifica in due passaggi.

  • Un account autorizzato a creare applicazioni nel centro di amministrazione Microsoft Entra. In molte organizzazioni queste operazioni spettano al responsabile IT.

  • L'indirizzo di reindirizzamento di produzione comunicato da chi gestisce Mambu.

L'indirizzo ha questa forma:

https://esempio.mambu.cloud/mambu_be/setupEmailOAuth2.php

Sostituisci esempio.mambu.cloud con il dominio vero dell'organizzazione. Non usare localhost per il collegamento in produzione. Lo stesso indirizzo, identico, servirà sia nella console Microsoft sia durante il collegamento.

Parte 1: creare l'applicazione Microsoft

  1. Apri Microsoft Entra e accedi con l'account autorizzato dell'organizzazione.

  2. Nel menu, apri Entra ID > App registrations (in italiano può apparire come Registrazioni app).

  3. Premi New registration o Nuova registrazione.

  4. Inserisci un nome riconoscibile, per esempio Mambu - invio email.

  5. In Supported account types o Tipi di account supportati, scegli Accounts in this organizational directory only (solo account della directory di questa organizzazione). Questa scelta mantiene l'app limitata al tuo tenant; Mambu userà il Tenant ID specifico.

  6. In Redirect URI, scegli la piattaforma Web e incolla l'indirizzo comunicato dal responsabile Mambu, per esempio:

https://esempio.mambu.cloud/backend/setupEmailOAuth2.php

  1. Premi Register o Registra.

  2. Nella pagina Overview o Panoramica, copia sia Application (client) ID sia Directory (tenant) ID. In Mambu serviranno entrambi: il primo come Client ID, il secondo come Tenant ID Microsoft.

Parte 2: creare il Client Secret

  1. Nel menu dell'applicazione, apri Certificates & secrets o Certificati e segreti.

  2. Apri Client secrets e premi New client secret o Nuovo segreto client.

  3. Inserisci una descrizione, per esempio Mambu email, e scegli una durata secondo le regole dell'organizzazione.

  4. Premi Add o Aggiungi.

  5. Copia subito il valore della colonna Value. Questo è il Client Secret da inserire in Mambu. Non copiare Secret ID: non è il valore richiesto.

Il valore segreto potrebbe non essere più visibile dopo aver lasciato la pagina. Conservalo in un luogo sicuro e non inviarlo in chat o email. Se lo perdi, un amministratore dovrà crearne uno nuovo e aggiornare Mambu.

Parte 3: autorizzare l'invio con Microsoft Graph

  1. Nel menu dell'applicazione, apri API permissions o Autorizzazioni API.

  2. Premi Add a permission o Aggiungi un'autorizzazione.

  3. Seleziona Microsoft Graph.

  4. Scegli Delegated permissions o Autorizzazioni delegate. Mambu invierà come l'utente che effettua il collegamento.

  5. Cerca e seleziona Mail.Send.

  6. Conferma con Add permissions o Aggiungi autorizzazioni.

  7. Se il tenant richiede il consenso amministrativo, seleziona Grant admin consent o Concedi il consenso dell'amministratore.

Parte 4: inserire i dati in Mambu

  1. Accedi a Mambu con un utente autorizzato a modificare le impostazioni email.

  2. Apri Configurazione email.

  3. In Scegli modalità invio email, seleziona Microsoft 365.

  4. In Nome utente, inserisci l'indirizzo completo della casella che invierà le email, per esempio ufficio@example.it.

  5. Incolla il valore Application (client) ID nel campo Client ID.

  6. Incolla il valore Value del segreto nel campo Client Secret. Non inserire Secret ID.

  7. Incolla Directory (tenant) ID nel campo Tenant ID Microsoft.

  8. Premi SALVA e attendi il messaggio di conferma.

  9. Premi Collega account Microsoft 365.

  10. Nella finestra Microsoft, accedi con la stessa casella indicata in Nome utente.

  11. Se Microsoft mostra una richiesta di autorizzazione, controlla che l'app sia quella preparata per Mambu e conferma solo se l'organizzazione ha approvato il collegamento.

  12. Quando Mambu conferma il collegamento, la finestra si chiude. In configurazione email il pulsante mostrerà Ricollega account Microsoft 365.

Verifica

Per controllare che il collegamento funzioni, invia da Mambu una normale email di prova o esegui un'operazione che invia un'email. L'account che autorizza Mambu deve essere quello indicato in Nome utente.

Problemi comuni

  • Indirizzo di reindirizzamento non valido: il valore registrato in Microsoft deve coincidere esattamente con quello usato da Mambu, compresi https, dominio e percorso.

  • Microsoft dice che serve l'approvazione di un amministratore: è una regola dell'organizzazione. Invia la richiesta al responsabile IT Microsoft 365.

  • Errore di autorizzazione Graph: verifica che Mail.Send sia aggiunto sotto Microsoft Graph come autorizzazione delegata e poi ricollega l'account in Mambu.

  • Segreto non accettato o scaduto: crea un nuovo Client Secret, copia il suo Value e aggiorna il campo Client Secret in Mambu prima di ricollegare l'account.

  • Account Microsoft errato: chiudi la finestra, esci dagli altri account Microsoft nel browser oppure apri una finestra privata, poi ripeti usando l'indirizzo indicato in Mambu.

Pagine ufficiali