Felsökning av anslutningsfel i inkorgen och kalendern

När du ansluter din Gmail-inkorg eller din Office 365-inkorg eller -kalender till HubSpot kan det hända att du stöter på ett fel under anslutningsprocessen. Läs mer om orsaken till dessa vanliga fel och hur du åtgärdar dem.

Fel med Office 365-inkorg och -kalender

Gå igenom felen nedan om du stöter på problem när du ansluter din Office 365-inkorg eller -kalender till HubSpot.

Behörigheter som krävs för att ansluta Office 365-inkorgen eller kalendern

Om du är IT-administratör bör du notera att HubSpot använder Microsoft Graph API för att integrera med din inkorg och kalender. HubSpot kräver följande behörighetsområden för att kunna ansluta:

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

Office 365-inkorg och kalender hittades inte

Det här felet innebär att ditt Office 365-konto inte har någon postlåda för den e-postadress du försöker ansluta. Du kan till exempel ha ett Office 365-konto som du använder för andra produkter som Word eller Excel, men din e-post hanteras av en annan e-postleverantör. Du måste välja rätt leverantör för att ansluta din kalender eller e-post.

Ej tillgängligt – API-åtkomst inte aktiverad för postlådan

Du ser detta fel i ditt HubSpot-konto som OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX. Det här felet kan orsakas av en av två saker:

• Det här felet kan tyda på att du just nu håller på att migreras från en outlook.com/hotmail eller annan tjänst till ett Office 365-konto. Migreringen kan ta en stund, och felet visas om du försöker ansluta medan migreringen pågår.
• Det här felet kan också betyda att din domän använder en hybridlösning med både en lokal Exchange-server och Office 365. Det innebär att du har ett Office 365-konto, men att du inte har en e-postlåda som hanteras direkt av Microsoft. Följaktligen kan HubSpot inte komma åt REST API:et för din e-postlåda. HubSpot kräver REST-API för att ansluta till ett Office 365-konto. Ett sätt att kontrollera att din e-postinkorg inte är hostad på Office 365 är att söka efter din e-postdomän i MX Toolbox, en extern webbplats som visar MX-poster. Denna MX-sökning visar till exempel att domänen sidekick.engineering är hostad av Office 365, men denna MX-sökning för mac.com visar ingen känd e-postleverantör.

Om du ser detta fel måste du ansluta via en annan e-postleverantör. Du kan till exempelansluta via IMAP eller via Exchange om du kör en Exchange-server.

Inkorgen är frånkopplad: Outlook-postlådan är inte aktiverad för åtkomst via REST API

Meddelandet”Denna Outlook-postlåda är inte aktiverad för åtkomst via REST API ” visas när Microsoft 365 blockerar HubSpots åtkomst till en postlåda via Microsoft Graph REST API. När detta inträffar kan en inkorg som är ansluten via Microsoft Outlook-anslutningsmetoden kopplas bort upprepade gånger, även om den återansluts under korta perioder. Detta fel indikerar vanligtvis ett konfigurations- eller licensproblem i Microsoft 365.

För att felsöka och åtgärda detta fel bör du samarbeta med din IT-administratör för att granska följande i din Microsoft 365-miljö: 

• Kontrollera var postlådan är hostad: Kontrollera att postlådan är hostad i Exchange Online.
  • Kontrollera att postlådan inte är hybrid, lokal eller befinner sig i ett delvis migrerat tillstånd.
  • Kontrollera att postlådan är fullständigt synkroniserad i den aktuella tenant.

• Kontrollera licenser: Kontrollera att postlådan har en aktiv Microsoft 365-licens som inkluderar Exchange Online.
  • Tilldela licensen på nytt eller uppdatera den om den har tagits bort eller har gått ut.

• Granska migreringar av hyresgäster: Kontrollera att migreringen är klar och att postlådans attribut har överförts.
  • Auktorisera anslutna appar på nytt, inklusive HubSpot Sales-appen.
  • Granska behörigheterna för Microsoft Entra ID och bekräfta att HubSpot har behörigheter för Graph API i den nya tenant.

• Återställ eller bevilja applikationsbehörigheter på nytt: se till i Microsoft Entra ID att HubSpot har åtkomst till Graph API.
  • Om API-åtkomsten avbröts under migreringen eller licensändringarna, bevilja behörigheterna för Graph API på nytt i Microsoft Entra ID.

När du har granskat konfigurationen av ditt Microsoft 365-konto ansluter du din inkorg till HubSpot igen med hjälp av anslutningsmetoden för Microsoft Outlook. Vi rekommenderar att du övervakar inkorgsanslutningen i 24–48 timmar. Om problemet kvarstår ska du granska dina Microsoft 365-granskningsloggar för att se om några Graph API-förfrågningar har blockerats.

Åtkomst till OData är inaktiverad

Om du får felmeddelandet”Åtkomst till OData är inaktiverad” betyder det att ditt Microsoft 365-konto blockerar anslutningen till HubSpot. Detta inträffar när policyer eller konfigurationer i ditt Microsoft 365-konto begränsar åtkomsten till Microsoft Graph API.

För att lösa detta fel ska du samarbeta med din IT-administratör för att granska och uppdatera följande konfigurationer i ditt Microsoft 365-konto:

• Åtkomstpolicy för applikationer: om din åtkomstpolicy hindrar HubSpot från att komma åt specifika e-postkonton ska du uppdatera policyn för att bevilja åtkomst eller ta bort begränsningen.
• Tillåtna användaragenter: om ditt Microsoft 365-konto använder en tillåtningslista, se till att användaragenten för HubSpot ingår. Lägg till eller justera posterna i tillåtningslistan efter behov för att tillåta åtkomst till Microsoft Graph API.

En

ansluten Office 365-inkorg visas som outlook_[sträng_av_tecken]@outlook

.com Det kan hända att outlook_[sträng_av_tecken]@outlook.com visas istället för din e-postadress när du ansluter en Office 365-inkorg. Detta beror på att HubSpot inte stöder användning av ett primärt alias som inte tillhör en Microsoft-domän. Detta kan orsaka problem med att skicka eller synkronisera dina e-postmeddelanden från din anslutna inkorg. Läs mer om detta problem och Microsofts rekommenderade lösning.

Fel

: Interaktion

krävs Om du ser felmeddelandet ”Interaktion krävs”när du ansluter din Office 365-inkorg betyder det att din användare behöver åtkomst till HubSpot Sales-applikationen i Azure AD. Du kan behöva kontakta din e-postadministratör för att få åtkomst. Läs mer om hur du tilldelar användare till en applikation i Azure AD. 

Godkännande från administratören krävs

Det här felet uppstår när din IT-administratör har begränsat appinstallationer i din Microsoft Azure Active Directory-miljö. Godkännandebegäran kommer från Microsoft, inte från HubSpot.

För att lösa det här felet så att du kan fortsätta med att ansluta HubSpots Office 365-integration kan din administratör vidta någon av följande åtgärder:

• Uppdatera inställningarna för användarens samtycke: följ dessa steg i Microsofts Azure-dokumentation för att aktivera alternativet Tillåt användarens för appar från verifierade utgivare, för valda behörigheter (rekommenderas)”. Eftersom HubSpot är en verifierad utgivare kommer användare i ditt konto att kunna ansluta inkorgar utan ytterligare ingripande så snart din administratör har aktiverat denna inställning.
• Aktivera arbetsflödet för administratörsgodkännande: följ dessa instruktioner i Microsofts Azure-dokumentation för att aktivera inställningen ”Användare kan begära administratörsgodkännande för appar som de inte själva kan godkänna ”. När denna inställning är aktiverad kommer en administratör att få e-postmeddelanden med uppmaning att godkänna en begäran från en användare om att installera en tredjepartsapp. Administratörer kan också granska och godkänna väntande begäranden påsidan ”Begäranden om administratörsgodkännande”.
• Godkänn behörigheter för hyresgästen: använd Microsoft Identity Platforms ändpunkt föradministratörsgodkännande:
  • Kopiera och klistra in deras tenant-ID i URL:en nedan och gå sedan till den resulterande URL:en i en webbläsare. Detta genererar en begäran om behörighetmed alternativet att godkänna appen för Office 365-tenant.
  • När du har godkänt appen kan det hända att ett felmeddelande visas. Detta felmeddelande kan ignoreras.

• • När samtycket har beviljats måste din administratör manuellt lägga till användare till HubSpot Sales -appen från Enterprise-applikationer.

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

Godkännande krävs

I likhet med felet ”Behöver administratörens godkännande” uppstår felet ”Godkännande krävs” när din IT-administratör har konfigurerat begränsningar för installation av applikationer i din lokala Azure Active Directory-miljö, men har aktiverat arbetsflödet för administratörens samtycke.

För att åtgärda detta fel anger du en motivering i den angivna textrutan för att skicka en begäran till din IT-administratör. Din administratör måste godkänna begäran för att du ska kunna installera en tredjepartsapp. Administratörer kan också granska och godkänna väntande förfrågningar påsidan Förfrågningar om administratörsgodkännande.

Google Advanced Protection

Om ditt Google-konto är registrerat i Googles Advanced Protection-program blockeras appar som kräver utökad åtkomst till Gmail och Google Drive automatiskt som standard. För att HubSpots Gmail-integration ska fungera korrekt krävs åtkomst för att läsa och skriva e-postmeddelanden å dina vägnar, vilket Google klassificerar som åtkomst med hög risk.

För att lösa detta problem och ansluta din inkorg till HubSpot kan du kontakta din Google Workspace-administratör och be denne lägga till HubSpot i listan över betrodda appar i organisationens Workspace-inställningar. Läs mer om hur du skapar en lista över betrodda appar i den här artikeln i Googles hjälpcenter.

Läs mer om Googles program för avancerat skydd.