Risoluzione degli errori di connessione alla casella di posta e al calendario di Office 365

Quando si collega la casella di posta elettronica o il calendario di Office 365 a HubSpot, è possibile che si verifichi un errore durante il processo di connessione. Scoprite la causa di questi errori comuni e come risolverli.

Autorizzazioni necessarie per collegare la casella di posta o il calendario di Office 365

Se sei una risorsa IT, tieni presente che HubSpot utilizza Graph API per Microsoft 365 per integrarsi con la tua casella di posta. Per il calendario di Office 365, HubSpot utilizza l'API REST di Outlook. HubSpot richiede i seguenti ambiti per connettersi:

Mail.ReadWrite
Mail.Send
Calendars.Read
Calendars.ReadWrite
offline_access
email
openid

Casella di posta e calendario di Office 365 non trovati

Questo errore significa che l'account Office 365 non dispone di una casella di posta elettronica per l'indirizzo e-mail che si sta cercando di collegare. Ad esempio, è possibile che si disponga di un account Office 365 utilizzato per altri prodotti come Word o Excel, ma che la posta elettronica sia ospitata da un provider diverso. È necessario scegliere il provider corretto per collegare il calendario o l'e-mail.

HubSpot si collega automaticamente all'e-mail sbagliata

Se si nota che HubSpot si connette automaticamente all'indirizzo e-mail sbagliato, verificare che non si sia scelto di rimanere iscritti al proprio account Office 365.

Per risolvere il problema:

• Accedere alla homepage di Office 365.
• In alto a destra, fare clic sull'immagine del proprio profilo, quindi selezionare Esci.
• Dopo aver effettuato la disconnessione, tornare alle impostazioni dell'integrazione e-mail di HubSpot e seguire i passaggi per collegare la casella di posta o il calendario di Office 365 a HubSpot.
  

Non disponibile - Accesso API non abilitato per la casella e-mail

Questo errore viene visualizzato nell'account HubSpot come OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX. Questo errore può essere causato in due modi:

• Questo errore può indicare che è in corso la migrazione da un servizio outlook.com/hotmail o di altro tipo a un account Office 365. La migrazione può richiedere del tempo e questo errore viene visualizzato se si tenta di connettersi durante la migrazione.
• Questo errore può anche significare che il vostro dominio sta utilizzando una configurazione ibrida di Exchange on-premises e Office 365. Ciò significa che si dispone di un account Office 365, ma non di una casella di posta elettronica gestita direttamente da Microsoft. Di conseguenza, HubSpot non può accedere all'API REST per la casella di posta. HubSpot richiede l'API REST per collegarsi a un account Office 365. Un modo per verificare che la casella di posta elettronica non sia ospitata su Office 365 è cercare il proprio dominio e-mail in MX Toolbox, un sito esterno che visualizza i record MX. Ad esempio, questo MX lookup mostra che il dominio sidekick.engineering è ospitato da Office 365, ma questo MX lookup per mac.com non mostra alcun provider di posta elettronica conosciuto.

Se viene visualizzato questo errore, è necessario connettersi utilizzando un altro provider di posta elettronica. Ad esempio, è possibile connettersi via IMAP o via Exchange se si utilizza un server Exchange.

La casella di posta connessa di Office 365 viene visualizzata come outlook_[stringa_di_caratteri]@outlook.com

Quando si collega una casella di posta Office 365, è possibile che venga visualizzato outlook_[stringa_di_caratteri]@outlook.com al posto del proprio indirizzo e-mail. Questo perché HubSpot non supporta l'uso di un alias primario non di dominio Microsoft. Ciò può causare problemi con l'invio o la sincronizzazione delle e-mail dalla casella di posta collegata. Per saperne di più su questo problema e sulla soluzione consigliata da Microsoft.

Errore di interazione richiesta

Se viene visualizzato un errore "Interazione necessaria" durante la connessione della casella di posta Office 365, significa che l'utente deve accedere all'applicazione HubSpot Sales in Azure AD. Potrebbe essere necessario collaborare con l'amministratore della posta elettronica per ottenere l'accesso. Ulteriori informazioni sull'assegnazione di utenti a un'applicazione in Azure AD.

Serve l'approvazione dell'amministratore

Questo errore si verifica quando l'amministratore IT ha configurato restrizioni all'installazione di applicazioni nell'ambiente Azure Active Directory locale.

Ter risolvere questo errore e poter procedere alla connessione dell'integrazione Office 365 di HubSpot, l'amministratore può adottare uno dei seguenti approcci:

• Aggiornare le impostazioni di consenso dell'utente: seguire i passaggi indicati nella documentazione di Microsoft su Azure per attivare l'opzione Consenti utente per le app di editori verificati, per le autorizzazioni selezionate (consigliato) . Poiché HubSpot è un editore verificato, gli utenti del vostro account saranno in grado di connettere le caselle di posta senza ulteriori interventi una volta che l'amministratore avrà attivato questa impostazione.
• Abilitare il flusso di lavoro del consenso dell'amministratore: seguite le istruzioni descritte nella documentazione di Microsoft su Azure per attivare l'impostazione Gli utenti possono richiedere il consenso dell'amministratore per le app a cui non possono dare il consenso. Una volta attivata questa impostazione, un amministratore riceverà notifiche via e-mail che lo inviteranno ad approvare la richiesta di un utente di installare un'applicazione di terze parti. Gli amministratori possono anche rivedere e approvare le richieste in sospeso nella pagina Richieste di consenso dell'amministratore .
• Consenso alle autorizzazioni per il tenant: utilizzare l'endpointdelconsenso dell'amministratore della piattaforma di identità Microsoft :
  • Copiare e incollare l'ID del tenant nell'URL sottostante, quindi navigare nell'URL risultante in un browser web. In questo modo verrà generato un prompt di richiesta di autorizzazione con l'opzione di acconsentire all'applicazione per il tenant di Office 365.
  • Dopo aver ottenuto il consenso, l'amministratore dovrà aggiungere manualmente gli utenti all'app HubSpot Sales dalle applicazioni Enterprise.

https://login.microsoftonline.com/{TENANT_ID}/v2.0/adminconsent?client_id=450987b3-a09a-4f14-9b2c-4f301d1e15f5&scope=https://graph.microsoft.com/Calendars.Read+https://graph.microsoft.com/Mail.Send+https://graph.microsoft.com/calendars.readwrite+https://graph.microsoft.com/mail.readwrite+https://graph.microsoft.com/offline_access+https://graph.microsoft.com/openid+https://graph.microsoft.com/email+https://graph.microsoft.com/profile&redirect_uri=https://app.hubspot.com/oauthor/v1/office365/verify&state=12345