Inbox- en kalenderverbindingsfouten oplossen

Wanneer je je Gmail inbox of je Office 365 inbox of agenda verbindt met HubSpot, kan er een fout optreden tijdens het verbindingsproces. Lees meer over de hoofdoorzaak van deze veelvoorkomende fouten en hoe je ze kunt oplossen.

Office 365 inbox en kalender fouten

Bekijk de onderstaande fouten als je problemen ondervindt bij het verbinden van je Office 365 inbox of agenda met HubSpot.

Vereiste machtigingen om Office 365 inbox of kalender te verbinden

Als je een IT-beheerder bent, weet dan dat HubSpot de Microsoft Graph API gebruikt om te integreren met je inbox en agenda. HubSpot heeft de volgende scopes nodig om te kunnen verbinden:

Mail.ReadWrite
Mail.Verzenden
Kalenders.Lezen
Kalenders.Lezen/Schrijven
offline_toegang
e-mail
openid
Gebruiker.lezen

Office 365-inbox en agenda niet gevonden

Deze foutmelding betekent dat uw Office 365 account geen postvak heeft voor het e-mailadres waarmee u verbinding probeert te maken. U kunt bijvoorbeeld een Office 365-account hebben dat u gebruikt voor andere producten zoals Word of Excel, maar uw e-mail wordt gehost bij een andere e-mailprovider. Je moet de juiste provider kiezen om je agenda of e-mail te verbinden.

Niet beschikbaar - API-toegang niet ingeschakeld voor mailbox

Je ziet deze foutmelding in je HubSpot account als OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX. Deze fout kan op twee manieren worden veroorzaakt:

• Deze fout kan een indicatie zijn dat je bezig bent met een migratie van een outlook.com/hotmail of andere service naar een Office 365 account. Deze migratie kan enige tijd duren en deze foutmelding verschijnt als u probeert verbinding te maken tijdens de migratie.
• Deze foutmelding kan ook betekenen dat je domein een hybride on-premises exchange en een Office 365 setup gebruikt. Dit betekent dat je een Office 365 account hebt, maar geen mailbox die direct door Microsoft wordt beheerd. Als gevolg hiervan heeft HubSpot geen toegang tot de REST API voor je mailbox. HubSpot heeft REST API nodig om verbinding te maken met een Office 365-account. Een manier om te controleren of je e-mailpostvak niet wordt gehost op Office 365 is door je e-maildomein op te zoeken in MX Toolbox, een externe site die MX-records weergeeft. Deze MX lookup laat bijvoorbeeld zien dat het domein sidekick.engineering wordt gehost door Office 365, maar deze MX lookup voor mac.com laat geen bekende e-mailprovider zien.

Als je deze foutmelding ziet, moet je verbinding maken met een andere e-mailprovider. Je kunt bijvoorbeeld verbinding maken via IMAP of via Exchange als je een Exchange-server gebruikt.

Inbox verbroken: Outlook-postvak is niet ingeschakeld voor REST API-toegang

Deze Outlook mailbox is niet ingeschakeld voor REST API-toegang treedt op wanneer Microsoft 365 HubSpot blokkeert voor toegang tot een mailbox via de Microsoft Graph REST API. Wanneer dit gebeurt, kan een inbox die is verbonden via de Microsoft Outlook-verbindingsmethode herhaaldelijk de verbinding verbreken, zelfs als deze voor korte tijd opnieuw wordt verbonden. Deze fout wijst meestal op een configuratie- of licentieprobleem van Microsoft 365.

Als u deze fout wilt oplossen, moet u samen met uw IT-beheerder het volgende controleren in uw Microsoft 365-omgeving:

• Controleer de postbushosting: controleer of de postbus wordt gehost in Exchange Online.
  • Controleer of de mailbox niet hybride, on-premise of gedeeltelijk gemigreerd is.
  • Controleer of de mailbox volledig is gesynchroniseerd in de huidige tenant.

• Controleer licenties: controleer of de mailbox een actieve Microsoft 365-licentie heeft die Exchange Online omvat.
  • Wijs de licentie opnieuw toe of werk deze bij als deze is verwijderd of verlopen.

• Controleer tenantmigraties: controleer of de migratie is voltooid en de mailboxattributen zijn overgenomen.
  • Herautoriseer verbonden apps, inclusief de HubSpot Sales app.
  • Controleer Microsoft Entra ID machtigingen en bevestig dat HubSpot Graph API machtigingen heeft in de nieuwe tenant.

• Stel de machtigingen voor applicaties opnieuw in of wijs ze opnieuw toe: zorg er in Microsoft Entra ID voor dat HubSpot toegang heeft tot de Graph API.
  • Als de API-toegang is verstoord tijdens de migratie of licentiewijzigingen, wijs de Graph API-machtigingen dan opnieuw toe in Microsoft Entra ID.

Nadat je de configuratie van je Microsoft 365 account hebt gecontroleerd, maak je opnieuw verbinding tussen je inbox en HubSpot met behulp van de Microsoft Outlook verbindingsmethode. Het wordt aanbevolen om de inboxverbinding 24-48 uur te controleren. Als het probleem zich blijft voordoen, controleer dan je Microsoft 365 auditlogboeken voor geblokkeerde Graph API-verzoeken.

Toegang tot OData is uitgeschakeld

Als je de foutmelding Access to OData is Disabled ontvangt, geeft dit aan dat je Microsoft 365-account de verbinding met HubSpot blokkeert. Dit gebeurt wanneer beleidsregels of configuraties in je Microsoft 365-account de Microsoft Graph API-toegang beperken.

Om deze foutmelding op te lossen, moet je samen met je IT-beheerder de volgende configuraties in je Microsoft 365-account controleren en bijwerken:

• Toepassingstoegangsbeleid: als uw toegangsbeleid HubSpot beperkt in de toegang tot specifieke mailboxen, werkt u het beleid bij om toegang te verlenen of de beperking te verwijderen.
• User-agent allowlist: als je Microsoft 365 account een allowlist afdwingt, zorg er dan voor dat de user-agent voor HubSpot is opgenomen. Voeg vermeldingen in de toestemmingslijst toe of pas deze aan als dat nodig is om Microsoft Graph API-toegang toe te staan.

Verbonden Office 365 inbox wordt weergegeven als outlook_[string_of_characters]@outlook.com

Het kan zijn dat outlook_[string_of_characters]@outlook.com wordt weergegeven in plaats van je e-mailadres wanneer je verbinding maakt met een Office 365 inbox. Dit komt omdat HubSpot het gebruik van een primaire alias buiten het Microsoft-domein niet ondersteunt. Dit kan problemen veroorzaken bij het verzenden of synchroniseren van je e-mails vanuit je verbonden inbox. Lees meer over dit probleem en de aanbevolen oplossing van Microsoft.

Fout interactie vereist

Als je een "Interactie vereist"-fout ziet bij het koppelen van je Office 365-inbox, betekent dit dat je gebruiker toegang nodig heeft tot de HubSpot Sales-applicatie in Azure AD. Mogelijk moet je samenwerken met je e-mailbeheerder om toegang te krijgen. Meer informatie over het toewijzen van gebruikers aan een applicatie in Azure AD.

Goedkeuring van beheerder nodig

Deze fout treedt op wanneer je IT-beheerder beperkingen heeft geconfigureerd voor het installeren van applicaties op je lokale Azure Active Directory omgeving.

Om deze foutmelding op te lossen zodat je verder kunt gaan met het aansluiten van HubSpot's Office 365 integratie, kan je beheerder een van de volgende benaderingen volgen:

• Werk de instellingen voor gebruikerstoestemming bij: volg deze stappen in de Azure-documentatie van Microsoft om de instelling Gebruikerstoestemming toestaan voor apps van geverifieerde uitgevers, voor geselecteerde machtigingen (Aanbevolen) in te schakelen. Aangezien HubSpot een geverifieerde uitgever is, kunnen gebruikers in je account inboxen koppelen zonder verdere tussenkomst zodra je beheerder deze instelling inschakelt.
• Schakel de admin consent workflow in: volg deze instructies in de Azure documentatie van Microsoft om de instelling Users can request admin consent to apps they are unable to consent to aan te zetten. Zodra deze instelling is ingeschakeld, ontvangt een beheerder e-mailmeldingen om hem te vragen een verzoek van een gebruiker om een app van derden te installeren goed te keuren. Beheerders kunnen ook in behandeling zijnde verzoeken bekijken en goedkeuren op de pagina Toestemmingsverzoeken voor beheerders .
• Toestemming geven voor machtigingen voor de tenant: gebruik het Microsoft identity platform admin consent endpoint:
  • Kopieer en plak hun tenant ID in de onderstaande URL en navigeer vervolgens naar de resulterende URL in een webbrowser. Dit genereert een Permission requested prompt met de optie om toestemming te geven voor de app voor de Office 365 tenant.
  • Zodra u toestemming geeft voor de app, kan er een foutmelding verschijnen. Deze fout kan genegeerd worden.

• • Nadat deze toestemming is verleend, moet je beheerder handmatig gebruikers toevoegen aan de HubSpot Sales app vanuit Enterprise applications.

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

Google Geavanceerde Bescherming

Als je Google-account is aangemeld voor het Advanced Protection Program van Google, worden apps die verhoogde toegang tot Gmail en Google Drive vereisen standaard automatisch geblokkeerd. Om de Gmail-integratie van HubSpot correct te laten werken, is toegang nodig om namens jou e-mails te lezen en te schrijven, wat Google classificeert als toegang met een hoog risico.

Om dit probleem op te lossen en je inbox te verbinden met HubSpot, kun je contact opnemen met je Google Workspace admin en HubSpot laten toevoegen aan de lijst met vertrouwde apps in de Workspace-instellingen van je organisatie. Lees in dit artikel in het Google Helpcentrum hoe je een lijst met vertrouwde apps instelt.

Meer informatie over het geavanceerde beschermingsprogramma van Google.