Vianmääritys postilaatikon ja kalenterin yhteysvirheissä

Kun yhdistät Gmailin postilaatikon tai Office 365:n postilaatikon tai kalenterin HubSpotiin, yhteyden muodostamisen aikana saattaa ilmetä virhe. Tutustu näiden yleisten virheiden perimmäisiin syihin ja niiden vianmääritykseen.

Office 365:n postilaatikon ja kalenterin virheet

Tutustu alla oleviin virheisiin, jos kohtaat ongelmia, kun yhdistät Office 365:n postilaatikon tai kalenterin HubSpotiin.

Office 365:n postilaatikon tai kalenterin yhdistämiseen tarvittavat oikeudet

Jos olet IT-ylläpitäjä, huomaa, että HubSpot käyttää Microsoft Graph APIa integroitumiseen postilaatikkoon ja kalenteriin. HubSpot vaatii seuraavat laajuudet, jotta yhteys voidaan muodostaa:

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

Office 365:n postilaatikkoa ja kalenteria ei löydy

Tämä virhe tarkoittaa, että Office 365 -tililläsi ei ole postilaatikkoa sähköpostiosoitteelle, johon yrität muodostaa yhteyttä. Sinulla voi esimerkiksi olla Office 365 -tili, jota käytät muihin tuotteisiin, kuten Wordiin tai Exceliin, mutta sähköpostisi on isännöity eri sähköpostipalveluntarjoajalla. Sinun on valittava oikea palveluntarjoaja kalenterin tai sähköpostin yhdistämistä varten.

Ei käytettävissä - API-yhteys ei ole käytössä postilaatikolle.

Näet tämän virheen HubSpot-tililläsi muodossa OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX. Tämä virhe voi johtua kahdella tavalla:

• Tämä virhe voi olla merkki siitä, että sinua ollaan siirtämässä outlook.com/hotmail- tai muusta palvelusta Office 365 -tilille. Tämä siirtyminen voi kestää jonkin aikaa, ja tämä virhe tulee näkyviin, jos yrität muodostaa yhteyden siirron aikana.
• Tämä virhe voi myös tarkoittaa, että verkkotunnuksessasi käytetään hybridiyhdistelmää tiloissa olevasta Exchange- ja Office 365 -asetuksesta. Tämä tarkoittaa, että sinulla on Office 365 -tili, mutta sinulla ei ole suoraan Microsoftin hallinnoimaa postilaatikkoa. Tämän seurauksena HubSpot ei pääse käsiksi postilaatikkosi REST API:han. HubSpot tarvitsee REST API:n voidakseen muodostaa yhteyden Office 365 -tiliin. Yksi tapa varmistaa, että sähköpostilaatikkoasi ei isännöidä Office 365:ssä, on etsiä sähköpostialuettasi MX Toolboxista, joka on ulkoinen sivusto, joka näyttää MX-tietueet. Esimerkiksi tämä MX-etsintä näyttää, että verkkotunnus sidekick.engineering on Office 365:n isännöimä, mutta tämä MX-etsintä mac.com -osoitteelle ei näytä tunnettua sähköpostipalveluntarjoajaa.

Jos näet tämän virheen, sinun on muodostettava yhteys käyttämällä eri sähköpostipalveluntarjoajaa. Voit esimerkiksi muodostaa yhteyden IMAP:n tai Exchange-palvelimen kautta, jos käytössäsi on Exchange-palvelin.

Saapuneet sähköpostit katkaistu: Outlookin postilaatikko ei ole käytössä REST API -yhteyttä varten.

Tämä Outlook-postilaatikko ei ole käytössä REST API -yhteyttä varten esiintyy, kun Microsoft 365 estää HubSpotia käyttämästä postilaatikkoa Microsoft Graph REST API:n kautta. Kun näin tapahtuu, Microsoft Outlook -yhteysmenetelmän kautta yhdistetty postilaatikko saattaa katkaista yhteyden toistuvasti, vaikka yhteys muodostuisi uudelleen lyhyeksi ajaksi. Tämä virhe osoittaa yleensä Microsoft 365:n kokoonpano- tai lisensointiongelmaa.

Vianmääritystä ja tämän virheen ratkaisemista varten tarkista Microsoft 365 -ympäristössäsi yhdessä IT-ylläpitäjän kanssa seuraavat asiat:

• Tarkista postilaatikon isännöinti: varmista, että postilaatikko on isännöity Exchange Online -palvelussa.
  • Vahvista, että postilaatikko ei ole hybridi, tiloissa oleva tai osittain siirretty.
  • Varmista, että postilaatikko on täysin synkronoitu nykyisessä vuokralaisessa.

• Tarkista lisenssit: Vahvista, että postilaatikolla on aktiivinen Microsoft 365 -lisenssi, joka sisältää Exchange Online -palvelun.
  • Määritä tai päivitä lisenssi uudelleen, jos se on poistettu tai vanhentunut.

• Tarkista vuokralaisen siirrot: varmista, että siirto on valmis ja postilaatikon ominaisuudet ovat siirtyneet.
  • Hyväksy liitetyt sovellukset, mukaan lukien HubSpot Sales -sovellus, uudelleen.
  • Tarkista Microsoft Entra ID -oikeudet ja varmista, että HubSpotilla on Graph API -oikeudet uudessa vuokralaisessa.

• Nollaa tai myönnä sovelluksen käyttöoikeudet uudelleen: Varmista Microsoft Entra ID:ssä, että HubSpotilla on Graph API -käyttöoikeus.
  • Jos API-käyttöoikeudet katkesivat migraation tai lisenssimuutosten aikana, myönnä Graph API -oikeudet uudelleen Microsoft Entra ID:ssä.

Kun olet tarkistanut Microsoft 365 -tilin kokoonpanon, yhdistä postilaatikkosi uudelleen HubSpotiin Microsoft Outlook -yhteysmenetelmällä. On suositeltavaa seurata postilaatikkoyhteyttä 24-48 tunnin ajan. Jos ongelma jatkuu, tarkista Microsoft 365 -valvontalokit estettyjen Graph API -pyyntöjen varalta.

ODatan käyttö on estetty

Jos saat Access to OData is Disabled -virheen, se osoittaa, että Microsoft 365 -tilisi estää yhteyden HubSpotiin. Tämä tapahtuu, kun Microsoft 365 -tilisi käytännöt tai määritykset rajoittavat Microsoft Graph API - käyttöoikeutta.

Voit korjata tämän virheen tarkastelemalla ja päivittämällä Microsoft 365 -tilisi seuraavat määritykset yhdessä IT-ylläpitäjän kanssa:

• Sovellusten käyttökäytäntö: Jos käyttökäytäntösi rajoittaa HubSpotin pääsyn tiettyihin postilaatikoihin, päivitä käytäntö niin, että se sallii pääsyn tai poistaa rajoituksen.
• Käyttäjäagentin sallittu luettelo: jos Microsoft 365 -tililläsi on sallittu luettelo, varmista, että HubSpotin käyttäjäagentti on mukana. Lisää tai säädä allowlist-merkintöjä tarpeen mukaan, jotta Microsoft Graph API -käyttöoikeus sallitaan.

Yhdistetty Office 365:n postilaatikko näkyy muodossa outlook_[merkkijono]@outlook.com.

Saatat nähdä, että sähköpostiosoitteesi sijaan näytetään outlook_[string_of_characters]@outlook.com, kun yhdistät Office 365:n postilaatikon. Tämä johtuu siitä, että HubSpot ei tue muun kuin Microsoftin verkkotunnuksen ensisijaisen aliaksen käyttöä. Tämä voi aiheuttaa ongelmia sähköpostien lähettämisessä tai synkronoinnissa yhdistetystä postilaatikostasi. Lue lisää tästä ongelmasta ja Microsoftin suosittelemasta ratkaisusta.

Vuorovaikutus vaaditaan -virhe

Jos näet Office 365 -postilaatikkoa yhdistettäessä "Interaction required" -virheen, se tarkoittaa, että käyttäjälläsi on oltava pääsy HubSpot Sales -sovellukseen Azure AD:ssä. Sinun on ehkä tehtävä yhteistyötä sähköpostin ylläpitäjän kanssa saadaksesi käyttöoikeuden. Lisätietoja käyttäjien osoittamisesta sovellukseen Azure AD:ssä.

Tarvitset järjestelmänvalvojan hyväksynnän

Tämä virhe ilmenee, kun IT-ylläpitäjäsi on määrittänyt rajoituksia sovellusten asentamiselle paikalliseen Azure Active Directory -ympäristöön.

Voit ratkaista tämän virheen niin, että voit jatkaa HubSpotin Office 365 -integraation liittämistä, järjestelmänvalvojasi voi toimia jollakin seuraavista tavoista:

• Päivitä käyttäjän suostumusasetukset: Noudata näitä Microsoftin Azure-asiakirjojen ohjeita ja ota käyttöön Allow user consent for apps from verified publishers, for selected permissions (Recommended) -asetus. Koska HubSpot on todennettu julkaisija, tilisi käyttäjät voivat yhdistää postilaatikoita ilman muita toimenpiteitä, kun ylläpitäjäsi ottaa tämän asetuksen käyttöön.
• Ota käyttöön ylläpitäjän suostumuksen työnkulku: noudata näitä Microsoftin Azure-asiakirjoissa esitettyjä ohjeita, kun haluat ottaa käyttöön asetuksen Käyttäjät voivat pyytää ylläpitäjän suostumusta sovelluksille, joihin he eivät voi antaa suostumusta. Kun tämä asetus on otettu käyttöön, ylläpitäjä saa sähköposti-ilmoituksia, joissa häntä kehotetaan hyväksymään käyttäjän pyyntö asentaa kolmannen osapuolen sovellus. Ylläpitäjät voivat myös tarkastella ja hyväksyä vireillä olevia pyyntöjä Ylläpitäjän suostumuspyynnöt -sivulla.
• Suostumus vuokralaisen käyttöoikeuksiin: Käytä Microsoft identity platformin admin consent -päätepistettä:
  • Kopioi ja liitä vuokralaisen tunnus alla olevaan URL-osoitteeseen ja siirry tuloksena olevaan URL-osoitteeseen verkkoselaimessa. Tämä luo pyydetyn lupakyselyn , jossa on mahdollisuus antaa suostumus Office 365 -vuokralaisen sovellukselle.
  • Kun hyväksyt sovelluksen hyväksymisen, saatat saada virheilmoituksen. Tämä virhe voidaan jättää huomiotta.

• • Kun suostumus on myönnetty, ylläpitäjän on lisättävä käyttäjät HubSpot Sales -sovellukseen manuaalisesti yrityssovelluksista.

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

Googlen laajennettu suojaus

Jos Google-tilisi on rekisteröitynyt Googlen Advanced Protection Program-ohjelmaan, sovellukset, jotka vaativat korotettua pääsyä Gmailiin ja Google Driveen, estetään automaattisesti oletusarvoisesti. Jotta HubSpotin Gmail-integraatio toimisi oikein, tarvitaan pääsy sähköpostien lukemiseen ja kirjoittamiseen puolestasi, minkä Google luokittelee korkean riskin käyttöoikeudeksi.

Voit korjata tämän ongelman ja yhdistää postilaatikkosi HubSpotiin ottamalla yhteyttä Google Workspace -hallintoon ja pyytämällä häntä lisäämään HubSpotin luotettujen sovellusten luetteloon organisaatiosi Workspace-asetuksissa. Lue luotettujen sovellusten luettelon määrittäminen tästä Google Help Centerin artikkelista.

Lisätietoja Googlen kehittyneestä suojausohjelmasta.