Problemen oplossen met Office 365 inbox en agenda verbindingsfouten

Wanneer u uw Office 365-inbox of agenda verbindt met HubSpot, kan het gebeuren dat u een fout tegenkomt tijdens het verbindingsproces. Lees meer over de hoofdoorzaak van deze veelvoorkomende fouten en hoe u deze kunt oplossen.

Vereiste machtigingen om Office 365 inbox of agenda te verbinden

Als je een IT'er bent, weet dan dat HubSpot Graph API voor Microsoft 365 gebruikt om te integreren met je inbox. Voor de Office 365 agenda gebruikt HubSpot de Outlook REST API. HubSpot heeft de volgende scopes nodig om verbinding te maken:

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

Office 365-inbox en agenda niet gevonden

Deze fout 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. U moet de juiste provider kiezen om uw agenda of e-mail te verbinden.

HubSpot maakt automatisch verbinding met de verkeerde e-mail

Als je ziet dat HubSpot automatisch verbinding maakt met het verkeerde e-mailadres, controleer dan of je er niet voor hebt gekozen om aangemeld te blijven bij je Office 365-account.

Om het probleem op te lossen:

• Navigeer naar de homepage van Office 365.
• Klik rechtsboven op uw profielfoto en selecteer vervolgens Uitloggen.
• Navigeer na het afmelden terug naar je HubSpot e-mail integratie instellingen en volg de stappen om je Office 365 inbox of agenda te verbinden met HubSpot.
  

Niet beschikbaar - API-toegang niet ingeschakeld voor mailbox

Je ziet deze fout 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 u 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 fout verschijnt als u probeert verbinding te maken tijdens de migratie.
• Deze fout kan ook betekenen dat uw domein een hybride on-premises exchange en een Office 365 setup gebruikt. Dit betekent dat je een Office 365 account hebt, maar dat je geen mailbox hebt die direct door Microsoft wordt beheerd. Hierdoor heeft HubSpot geen toegang tot de REST API voor uw mailbox. HubSpot vereist REST API om verbinding te maken met een Office 365-account. Een manier om te controleren of uw e-mailpostvak niet op Office 365 wordt gehost, is door uw e-maildomein op te zoeken in MX Toolbox, wat een externe site is 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 u deze foutmelding ziet, moet u verbinding maken via een andere e-mailprovider. U kunt bijvoorbeeld verbinding maken via IMAP of via Exchange als u een Exchange server gebruikt.

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

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

Fout bij interactie vereist

Als je een "Interactie vereist"-fout ziet bij het verbinden van je Office 365-inbox, betekent dit dat je gebruiker toegang nodig heeft tot de HubSpot Sales-applicatie in Azure AD. Mogelijk moet u samenwerken met uw 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 uw IT-beheerder beperkingen heeft geconfigureerd voor het installeren van applicaties in uw lokale Azure Active Directory-omgeving.

TOm 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 Allow gebruiker toestemming voor apps van geverifieerde uitgevers, voor geselecteerde toestemmingen (aanbevolen) in te schakelen. Aangezien HubSpot een geverifieerde uitgever is, zullen gebruikers in uw account inboxen kunnen verbinden zonder verdere tussenkomst zodra uw admin deze instelling inschakelt.
• Schakel de admin consent workflow in: volg deze instructies uit 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 hangende verzoeken ook bekijken en goedkeuren op de pagina Toestemmingsverzoeken voor beheerders .
• Toestemming tot machtigingen voor de huurder: 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 vraag om toestemming met de optie om toestemming te geven voor de app voor de Office 365-tenant.
  • Nadat deze toestemming is verleend, moet je admin 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/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