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 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
Posta.Invia
Calendari.Leggere
Calendari.LeggereScrivere
accesso_offline
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, si può 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 l'e-mail.

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 elettronica. 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 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. 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.

Per 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 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 elettronica 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à generata una 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

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.