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

Quando si collega la casella di posta Gmail o la casella di posta 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.

Errori della casella di posta e del calendario di Office 365

Esaminate gli errori riportati di seguito se riscontrate problemi durante la connessione della casella di posta elettronica o del calendario di Office 365 a HubSpot.

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

Se siete un amministratore IT, tenete presente che HubSpot utilizza l'API Microsoft Graph per integrarsi con la casella di posta e il calendario. HubSpot richiede i seguenti ambiti per connettersi:

Mail.ReadWrite
Posta.Invia
Calendari.Leggere
Calendari.LeggereScrivere
accesso_offline
email
openid
User.Read

Posta in arrivo 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, si potrebbe avere un account Office 365 che si utilizza per altri prodotti come Word o Excel, ma la posta elettronica è ospitata da un altro provider. È necessario scegliere il provider corretto per collegare il calendario o la posta elettronica.

Non disponibile: l'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 elettronica. HubSpot richiede l'API REST per connettersi a un account Office 365. Un modo per verificare che la casella di posta elettronica non sia ospitata su Office 365 è quello di 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 tramite IMAP o tramite Exchange se si utilizza un server Exchange.

Posta in arrivo scollegata: La casella postale di Outlook non è abilitata all'accesso all'API REST.

La disconnessionedella casella di posta Outlook non è abilitata all'accesso all'API REST si verifica quando Microsoft 365 blocca l'accesso di HubSpot a una casella di posta tramite l'API REST di Microsoft Graph. Quando ciò accade, una casella di posta connessa tramite il metodo di connessione di Microsoft Outlook può disconnettersi ripetutamente, anche se si riconnette per brevi periodi di tempo. Questo errore indica in genere un problema di configurazione o di licenza di Microsoft 365.

Per risolvere questo errore, collaborate con l'amministratore IT per verificare quanto segue nel vostro ambiente Microsoft 365:

• Verificare l'hosting della cassetta postale: verificare che la cassetta postale sia ospitata in Exchange Online.
  • Verificare che la casella di posta elettronica non sia ibrida, on-premises o in stato di migrazione parziale.
  • Verificare che la casella e-mail sia completamente sincronizzata nel tenant corrente.

• Controllare le licenze: verificare che la casella e-mail abbia una licenza Microsoft 365 attiva che include Exchange Online.
  • Riassegnare o aggiornare la licenza se è stata rimossa o è scaduta.

• Esaminare le migrazioni dei tenant: verificare che la migrazione sia stata completata e che gli attributi delle caselle postali si siano propagati.
  • Riautorizzare le app collegate, compresa l'app HubSpot Sales.
  • Esaminare le autorizzazioni di Microsoft Entra ID e confermare che HubSpot abbia le autorizzazioni Graph API nel nuovo tenant.

• Reimpostare o concedere nuovamente i permessi delle applicazioni: in Microsoft Entra ID, assicurarsi che HubSpot abbia accesso all'API Graph.
  • Se l'accesso all'API è stato interrotto durante la migrazione o la modifica della licenza, concedere nuovamente i permessi Graph API in Microsoft Entra ID.

Dopo aver rivisto la configurazione dell'account Microsoft 365, ricollegare la casella di posta a HubSpot utilizzando il metodo di connessione di Microsoft Outlook. Si consiglia di monitorare la connessione alla casella di posta per 24-48 ore. Se il problema persiste, controllare i registri di controllo di Microsoft 365 per verificare la presenza di richieste Graph API bloccate.

L'accesso a OData è disabilitato

Se si riceve l'errore Access to OData is Disabled, significa che l'account Microsoft 365 sta bloccando la connessione a HubSpot. Ciò si verifica quando le policy o le configurazioni dell'account Microsoft 365 limitano l'accesso a Microsoft Graph API.

Per risolvere questo errore, collaborare con l'amministratore IT per rivedere e aggiornare le seguenti configurazioni dell'account Microsoft 365:

• Criteri di accesso alle applicazioni: se i criteri di accesso limitano l'accesso di HubSpot a specifiche caselle di posta, aggiornare i criteri per consentire l'accesso o rimuovere la restrizione.
• User-agent allowlist: se il vostro account Microsoft 365 applica una allowlist, assicuratevi che l'user-agent di HubSpot sia incluso. Aggiungete o modificate le voci della allowlist se necessario per consentire l'accesso all'API di Microsoft Graph.

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

Quando si collega una casella di posta elettronica di Office 365, è possibile che venga visualizzato outlook_[stringa_di_caratteri]@outlook.com invece del proprio indirizzo e-mail. Questo perché HubSpot non supporta l'uso di un alias primario non di dominio Microsoft. Ciò può causare problemi nell'invio o nella 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. Per saperne di più sull'assegnazione degli 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.

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

• Aggiornare le impostazioni del consenso dell'utente: seguite i passaggi riportati nella documentazione di Microsoft su Azure per attivare l'impostazione Consenti il consenso dell'utente per le applicazioni di editori verificati, per 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'endpoint delconsenso 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.
  • Una volta accettato il consenso all'applicazione, potrebbe verificarsi un errore. Questo errore può essere ignorato.

• • 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/User.Read+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

Protezione avanzata di Google

Se l'account Google è iscritto al Programma di protezione avanzata di Google, le app che richiedono un accesso elevato a Gmail e Google Drive vengono automaticamente bloccate per impostazione predefinita. Affinché l'integrazione Gmail di HubSpot funzioni correttamente, è necessario l'accesso per leggere e scrivere le e-mail per conto dell'utente, che Google classifica come accesso ad alto rischio.

Per risolvere questo problema e collegare la vostra casella di posta a HubSpot, potete contattare il vostro amministratore di Google Workspace e chiedergli di aggiungere HubSpot all'elenco delle app affidabili nelle impostazioni di Workspace della vostra organizzazione. Per sapere come impostare un elenco di app affidabili, consultate questo articolo del Centro assistenza Google.

Per saperne di più sul Programma di protezione avanzata di Google.