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 na koncie 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. W celu połączenia kalendarza lub poczty e-mail należy wybrać właściwego dostawcę.

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, będziesz musiał 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.

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 zostać wyświetlony 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. Może być konieczna współpraca z administratorem poczty e-mail w celu uzyskania dostępu. 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: wykonaj następujące kroki w dokumentacji Microsoft Azure, aby włączyć ustawienie Zezwalaj użytkownikowi na zgodę na aplikacje 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 Żądania 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.