Rozwiązywanie błędów połączenia ze skrzynką odbiorczą i kalendarzem

Podczas łączenia skrzynki odbiorczej Gmail lub skrzynki odbiorczej lub kalendarza Office 365 z HubSpot może wystąpić błąd podczas procesu łączenia. Zapoznaj się z podstawowymi przyczynami tych typowych błędów i dowiedz się, jak je rozwiązać.

Błędy skrzynki odbiorczej i kalendarza Office 365

Zapoznaj się z poniższymi błędami, jeśli napotkasz problemy podczas łączenia skrzynki odbiorczej lub kalendarza Office 365 z HubSpot.

Uprawnienia wymagane do połączenia skrzynki odbiorczej lub kalendarza Office 365

Jeśli jesteś administratorem IT, pamiętaj, że HubSpot używa interfejsu API Microsoft Graph do integracji ze skrzynką odbiorczą i kalendarzem. HubSpot wymaga następujących zakresów w celu nawiązania połączenia:

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

Nie znaleziono skrzynki odbiorczej i kalendarza usługi Office 365

Ten błąd oznacza, że konto Office 365 nie ma skrzynki pocztowej dla adresu e-mail, z którym próbujesz się połączyć. Na przykład możesz mieć konto Office 365, którego używasz do innych produktów, takich jak Word lub Excel, ale Twoja poczta e-mail jest hostowana przez innego dostawcę poczty e-mail. Musisz wybrać właściwego dostawcę, aby połączyć swój kalendarz lub pocztę e-mail.

Niedostępne - dostęp API nie jest włączony dla skrzynki pocztowej

Ten błąd będzie widoczny na koncie HubSpot jako OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX. Błąd ten może być spowodowany na dwa sposoby:

• Ten błąd może wskazywać, że jesteś w trakcie migracji z outlook.com/hotmail lub innej usługi na konto Office 365. Ta migracja może zająć trochę czasu, a ten błąd pojawi się, jeśli spróbujesz połączyć się podczas migracji.
• Ten błąd może również oznaczać, że domena korzysta z hybrydowej lokalnej usługi Exchange i konfiguracji Office 365. Oznacza to, że masz konto Office 365, ale nie masz skrzynki pocztowej zarządzanej bezpośrednio przez Microsoft. W rezultacie HubSpot nie może uzyskać dostępu do interfejsu API REST dla skrzynki pocztowej. HubSpot wymaga interfejsu API REST, aby połączyć się z kontem Office 365. Jednym ze sposobów sprawdzenia, czy skrzynka e-mail nie jest hostowana w usłudze Office 365, jest wyszukanie domeny e-mail w MX Toolbox, która jest zewnętrzną witryną wyświetlającą rekordy MX. Na przykład, to wyszukiwanie MX pokazuje, że domena sidekick.engineering jest hostowana przez Office 365, ale to wyszukiwanie MX dla mac.com nie pokazuje żadnego znanego dostawcy poczty e-mail.

Jeśli zobaczysz ten błąd, musisz połączyć się za pomocą innego dostawcy poczty e-mail. Możesz na przykład połączyć się przez IMAP lub Exchange, jeśli korzystasz z serwera Exchange.

Skrzynka odbiorcza rozłączona: Skrzynka pocztowa programu Outlook nie ma włączonego dostępu do interfejsu API REST.

Ta skrzynka poczt owa programuOutlook nie ma dostępu do interfejsu API REST występuje, gdy platforma Microsoft 365 blokuje HubSpot dostęp do skrzynki pocztowej za pośrednictwem interfejsu API REST Microsoft Graph. W takim przypadku skrzynka odbiorcza połączona za pomocą metody połączenia Microsoft Outlook może być wielokrotnie rozłączana, nawet jeśli łączy się ponownie na krótkie okresy czasu. Ten błąd zazwyczaj wskazuje na problem z konfiguracją lub licencjonowaniem Microsoft 365.

Aby rozwiązać ten błąd, współpracuj z administratorem IT w celu sprawdzenia następujących elementów w środowisku Microsoft 365:

• Zweryfikuj hosting skrzynki pocztowej: potwierdź, że skrzynka pocztowa jest hostowana w usłudze Exchange Online.
  • Upewnij się, że skrzynka pocztowa nie jest hybrydowa, lokalna lub częściowo zmigrowana.
  • Sprawdź, czy skrzynka pocztowa jest w pełni zsynchronizowana w bieżącej dzierżawie.

• Sprawdź licencje: potwierdź, że skrzynka pocztowa ma aktywną licencję Microsoft 365, która obejmuje usługę Exchange Online.
  • Ponownie przypisz lub zaktualizuj licencję, jeśli została usunięta lub wygasła.

• Sprawdź migracje dzierżawy: potwierdź, że migracja została zakończona, a atrybuty skrzynki pocztowej zostały propagowane.
  • Ponownie autoryzuj połączone aplikacje, w tym aplikację HubSpot Sales.
  • Przejrzyj uprawnienia Microsoft Entra ID i potwierdź, że HubSpot ma uprawnienia Graph API w nowej dzierżawie.

• Zresetuj lub ponownie przyznaj uprawnienia aplikacji: w Microsoft Entra ID upewnij się, że HubSpot ma dostęp do Graph API.
  • Jeśli dostęp do interfejsu API został zakłócony podczas migracji lub zmian licencji, należy ponownie przyznać uprawnienia Graph API w Microsoft Entra ID.

Po sprawdzeniu konfiguracji konta Microsoft 365 ponownie połącz skrzynkę odbiorczą z HubSpot przy użyciu metody połączenia Microsoft Outlook. Zaleca się monitorowanie połączenia ze skrzynką odbiorczą przez 24-48 godzin. Jeśli problem nadal występuje, przejrzyj dzienniki inspekcji Microsoft 365 pod kątem zablokowanych żądań Graph API.

Dostęp do OData jest wyłączony

Jeśli otrzymujesz błąd Access to OData is Disabled, oznacza to, że Twoje konto Microsoft 365 blokuje połączenie z HubSpot. Dzieje się tak, gdy zasady lub konfiguracje na koncie Microsoft 365 ograniczają dostęp do interfejsu API Microsoft Graph.

Aby rozwiązać ten błąd, współpracuj z administratorem IT, aby przejrzeć i zaktualizować następujące konfiguracje na koncie Microsoft 365:

• Zasady dostępu do aplikacji: jeśli zasady dostępu ograniczają dostęp HubSpot do określonych skrzynek pocztowych, zaktualizuj zasady, aby przyznać dostęp lub usunąć ograniczenie.
• User-agent allowlist: jeśli Twoje konto Microsoft 365 wymusza listę zezwoleń, upewnij się, że zawiera ona agenta użytkownika dla HubSpot. Dodaj lub dostosuj wpisy listy zezwoleń w razie potrzeby, aby zezwolić na dostęp do interfejsu API Microsoft Graph.

Połączona skrzynka odbiorcza Office 365 jest wyświetlana jako outlook_[string_of_characters]@outlook.com

Po podłączeniu skrzynki odbiorczej Office 365 zamiast adresu e-mail może być wyświetlany outlook_[string_of_characters]@outlook.com. Dzieje się tak, ponieważ HubSpot nie obsługuje używania podstawowego aliasu innego niż domena Microsoft. Może to powodować problemy z wysyłaniem lub synchronizowaniem wiadomości e-mail z połączonej skrzynki odbiorczej. Dowiedz się więcej o tym problemie i zalecanym przez Microsoft rozwiązaniu.

Błąd wymagający interakcji

Jeśli podczas łączenia skrzynki odbiorczej Office 365 pojawi się błąd "Wymagana interakcja", oznacza to, że użytkownik potrzebuje dostępu do aplikacji HubSpot Sales w usłudze Azure AD. Uzyskanie dostępu może wymagać współpracy z administratorem poczty e-mail. Dowiedz się więcej o przypisywaniu użytkowników do aplikacji w usłudze Azure AD.

Wymagana zgoda administratora

Ten błąd występuje, gdy administrator IT skonfigurował ograniczenia dotyczące instalowania aplikacji w lokalnym środowisku Azure Active Directory.

Aby rozwiązać ten błąd i kontynuować podłączanie integracji HubSpot z Office 365, administrator może zastosować jedno z poniższych podejść:

• Zaktualizuj ustawienia zgody użytkownika: postępuj zgodnie z tymi krokami w dokumentacji Microsoft Azure, aby włączyć ustawienie Zezwalaj na zgodę użytkownika dla aplikacji od zweryfikowanych wydawców, dla wybranych uprawnień (zalecane) . Ponieważ HubSpot jest zweryfikowanym wydawcą, użytkownicy na Twoim koncie będą mogli łączyć skrzynki odbiorcze bez dalszej interwencji po włączeniu tego ustawienia przez administratora.
• Włącz przepływ pracy zgody administratora: postępuj zgodnie z instrukcjami opisanymi w dokumentacji Microsoft Azure, aby włączyć ustawienie Użytkownicy mogą żądać zgody administratora na aplikacje, na które nie mogą wyrazić zgody. Po włączeniu tego ustawienia administrator będzie otrzymywać powiadomienia e-mail z prośbą o zatwierdzenie żądania użytkownika dotyczącego zainstalowania aplikacji innej firmy. Administratorzy mogą również przeglądać i zatwierdzać oczekujące żądania na stronie żądań zgody administratora .
• Zgoda na uprawnienia dla dzierżawy: użyjpunktu końcowego zgody administratora platformy tożsamości firmy Microsoft :
  • Skopiuj i wklej identyfikator dzierżawcy do poniższego adresu URL, a następnie przejdź do wynikowego adresu URL w przeglądarce internetowej. Spowoduje to wygenerowanie monitu o zezwolenie z opcją wyrażenia zgody na aplikację dla dzierżawy Office 365.
  • Po zaakceptowaniu zgody na aplikację może wystąpić błąd. Błąd ten można zignorować.

• • Po udzieleniu zgody administrator będzie musiał ręcznie dodać użytkowników do aplikacji HubSpot Sales z aplikacji 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

Zaawansowana ochrona Google

Jeśli konto Google jest zarejestrowane w programie zaawansowanej ochrony Google, aplikacje wymagające podwyższonego dostępu do Gmaila i Dysku Google są domyślnie automatycznie blokowane. Aby integracja HubSpot z Gmailem działała poprawnie, potrzebny jest dostęp do odczytywania i pisania wiadomości e-mail w imieniu użytkownika, co Google klasyfikuje jako dostęp wysokiego ryzyka.

Aby rozwiązać ten problem i połączyć swoją skrzynkę odbiorczą z HubSpot, możesz skontaktować się z administratorem Google Workspace i poprosić go o dodanie HubSpot do listy zaufanych aplikacji w ustawieniach Workspace Twojej organizacji. Dowiedz się, jak skonfigurować listę zaufanych aplikacji z tego artykułu w Centrum pomocy Google.

Dowiedz się więcej o programie zaawansowanej ochrony Google.