Saapuneet-kansion ja kalenterin yhteysvirheiden vianmääritys

Kun yhdistät Gmail-postilaatikkosi tai Office 365 -postilaatikkosi tai -kalenterisi HubSpotiin, saatat kohdata virheen yhdistämisprosessin aikana. Tutustu näiden yleisten virheiden perussyihin ja niiden vianmääritysohjeisiin.

Office 365 -postilaatikon ja -kalenterin virheet

Tutustu alla oleviin virheisiin, jos kohtaat ongelmia yhdistettäessäsi Office 365 -postilaatikkoasi tai -kalenteriasi HubSpotiin.

Office 365 -postilaatikon tai -kalenterin yhdistämiseen tarvittavat käyttöoikeudet

Jos olet IT-järjestelmänvalvoja, huomaa, että HubSpot käyttää Microsoft Graph API:ta integroituakseen postilaatikkoosi ja kalenteriisi. HubSpot tarvitsee seuraavat käyttöoikeusalueet yhteyden muodostamiseksi:

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 sille sähköpostiosoitteelle, johon yrität muodostaa yhteyden. Sinulla voi esimerkiksi olla Office 365 -tili, jota käytät muihin tuotteisiin, kuten Wordiin tai Exceliin, mutta sähköpostisi on toisen palveluntarjoajan hallinnoima. Sinun on valittava oikea palveluntarjoaja, jotta voit yhdistää kalenterisi tai sähköpostisi.

Ei käytettävissä – API-käyttöoikeutta ei ole otettu käyttöön postilaatikolle

Tämä virhe näkyy HubSpot-tililläsi nimellä OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX. Virhe voi johtua kahdesta syystä:

• Tämä virhe voi olla merkki siitä, että olet siirtymässä outlook.com/hotmail-palvelusta tai muusta palvelusta Office 365 -tiliin. Siirtyminen voi kestää jonkin aikaa, ja tämä virhe ilmestyy, jos yrität muodostaa yhteyden siirtymisen aikana.
• Tämä virhe voi myös tarkoittaa, että verkkotunnuksesi käyttää hybridi-asennusta, jossa yhdistyvät paikallinen Exchange-palvelin ja Office 365. Tämä tarkoittaa, että sinulla on Office 365 -tili, mutta sinulla ei ole postilaatikkoa, jota Microsoft hallinnoi suoraan. Tämän seurauksena HubSpot ei pääse käyttämään postilaatikkosi REST-sovellusliittymää. HubSpot tarvitsee REST-rajapintaa muodostaakseen yhteyden Office 365 -tiliin. Yksi tapa varmistaa, ettei sähköpostilaatikkoasi isännöidä Office 365:ssä, on tarkistaa sähköpostidomainisi MX Toolboxista, joka on ulkoinen sivusto, joka näyttää MX-tietueet. Esimerkiksi tämä MX-haku osoittaa, että domainia sidekick.engineering isännöi Office 365, mutta tämä mac.com-domainin MX-haku ei näytä tunnettua sähköpostipalveluntarjoajaa.

Jos näet tämän virheen, sinun on muodostettava yhteys toisen sähköpostipalveluntarjoajan kautta. Voit esimerkiksimuodostaa yhteyden IMAP:n kautta tai Exchange-palvelimen kautta, jos käytät Exchange-palvelinta.

Saapuneet-kansi irrotettu: Outlook-postilaatikkoa ei ole otettu käyttöön REST

-rajapinnan

käyttöä varten

Virhe ”Tätä Outlook-postilaatikkoa ei ole otettu käyttöön REST-rajapinnan käyttöä varten ” ilmenee

,

kun Microsoft 365 estää HubSpotia pääsemästä postilaatikkoon Microsoft Graph REST-rajapinnan kautta. Tällöin Microsoft Outlook -yhteysmenetelmällä yhdistetty postilaatikko saattaa menettää yhteyden toistuvasti, vaikka yhteys palautuisikin hetkeksi. Tämä virhe viittaa yleensä Microsoft 365:n määritys- tai lisensointiongelmaan.

Vianmäärityksen ja virheen korjaamisen yhteydessä tarkista yhdessä IT-järjestelmänvalvojasi kanssa seuraavat seikat Microsoft 365 -ympäristössäsi: 

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

• Tarkista lisenssit: varmista, että postilaatikolla on voimassa oleva Microsoft 365 -lisenssi, joka sisältää Exchange Onlinen.
  • Määritä lisenssi uudelleen tai päivitä se, jos se on poistettu tai vanhentunut.

• Tarkista vuokralaisesiirrot: varmista, että siirto on valmis ja että postilaatikon ominaisuudet on siirretty.
  • Valtuuta uudelleen liitetyt sovellukset, mukaan lukien HubSpot Sales -sovellus.
  • Tarkista Microsoft Entra ID -käyttöoikeudet ja varmista, että HubSpotilla on Graph API -käyttöoikeudet uudessa vuokralaisessa.

• Nollaa tai myönnä sovellusoikeudet uudelleen: varmista Microsoft Entra ID:ssä, että HubSpotilla on pääsy Graph API:hin.
  • Jos API-käyttöoikeudet katkesivat siirron tai lisenssimuutosten aikana, myönnä Graph API -käyttöoikeudet uudelleen Microsoft Entra ID:ssä.

Kun olet tarkistanut Microsoft 365 -tilisi asetukset, yhdistä postilaatikkosi uudelleen HubSpotiin Microsoft Outlookin yhteysmenetelmällä. On suositeltavaa seurata postilaatikon yhteyttä 24–48 tunnin ajan. Jos ongelma jatkuu, tarkista Microsoft 365:n tarkastuslokit estettyjen Graph API -pyyntöjen varalta.

Pääsy ODataan on

poistettu käytöstä Jos saat virheilmoituksen”Pääsy ODataan on poistettu käytöstä ”, se tarkoittaa, että Microsoft 365 -tilisi estää yhteyden HubSpotiin. Tämä tapahtuu, kun Microsoft 365 -tilisi käytäntöjä tai asetuksia rajoittavat Microsoft Graph API:n käyttöä.

Voit korjata tämän virheen tarkistamalla ja päivittämällä yhdessä IT-järjestelmänvalvojasi kanssa seuraavat asetukset Microsoft 365 -tilissäsi:

• Sovellusten käyttöoikeuskäytäntö: jos käyttöoikeuskäytäntösi rajoittaa HubSpotin pääsyä tiettyihin postilaatikoihin, päivitä käytäntö myöntämään pääsy tai poista rajoitus.
• Käyttäjäagentin sallittujen luettelo: jos Microsoft 365 -tilissäsi on käytössä sallittujen luettelo, varmista, että HubSpotin käyttäjäagentti on mukana siinä. Lisää tai muokkaa sallittujen luettelon merkintöjä tarpeen mukaan, jotta Microsoft Graph API:n käyttö sallitaan.

Yhdistetty Office 365 -postilaatikko näkyy muodossa outlook_[merkkijono]@outlook

.com Kun yhdistät Office 365 -postilaatikon, saatat nähdä osoitteen outlook_[merkkijono]@outlook.com sähköpostiosoitteesi sijaan. Tämä johtuu siitä, että HubSpot ei tue muiden kuin Microsoftin verkkotunnuksiin kuuluvien ensisijaisten aliasten käyttöä. Tämä voi aiheuttaa ongelmia sähköpostien lähettämisessä tai synkronoinnissa yhdistetystä postilaatikosta. Lue lisää tästä ongelmasta ja Microsoftin suosittelemasta ratkaisusta.

Virhe

: Vuorovaikutus

vaaditaan Jos näet virheilmoituksen ”Vuorovaikutus vaaditaan”yhdistettäessäsi Office 365 -postilaatikkoasi, se tarkoittaa, että käyttäjälläsi on oltava käyttöoikeus HubSpot Sales -sovellukseen Azure AD:ssä. Saatat joutua ottamaan yhteyttä sähköpostijärjestelmän ylläpitäjään saadaksesi käyttöoikeuden. Lue lisää käyttäjien määrittämisestä sovellukselle Azure AD:ssä. 

Vaatii järjestelmänvalvojan hyväksynnän

Tämä virhe ilmenee, kun IT-järjestelmänvalvojasi on määrittänyt rajoituksia sovellusten asentamiselle paikallisessa Azure Active Directory -ympäristössäsi.

Jotta tämä virhe voidaan korjata ja voit jatkaa HubSpotin Office 365 -integraation yhdistämistä, järjestelmänvalvojasi voi toimia jollakin seuraavista tavoista:

• Päivitä käyttäjän suostumusasetukset: noudata näitä ohjeita Microsoftin Azure-ohjeistuksessa ottaaksesi käytt öön käyttäjän suostumus vahvistetuilta julkaisijoilta, valituille käyttöoikeuksille (suositeltava)” -asetuksen . Koska HubSpot on vahvistettu julkaisija, tilisi käyttäjät voivat yhdistää postilaatikot ilman lisätoimenpiteitä, kun järjestelmänvalvojasi on ottanut tämän asetuksen käyttöön.
• Ota käyttöön järjestelmänvalvojan suostumusprosessi: noudata näitä Microsoftin Azure-ohjeissa annettuja ohjeita ottaaksesi käyttöön asetuksen ”Käyttäjät voivat pyytää järjestelmänvalvojan suostumusta sovelluksiin, joihin he eivät voi itse antaa suostumustaan ”. Kun tämä asetus on otettu käyttöön, järjestelmänvalvoja saa sähköpostimuistutuksia, joissa häntä pyydetään hyväksymään käyttäjän pyyntö asentaa kolmannen osapuolen sovellus. Järjestelmänvalvojat voivat myös tarkistaa ja hyväksyä odottavia pyyntöjä”Järjestelmänvalvojan suostumuspyyntöjä” -sivulla.
• Suostu vuokralaisen käyttöoikeuksiin: käytä Microsoftin identiteettialustan järjestelmänvalvojan suostumuksen päätepistettä:
  • Kopioi ja liitä vuokralaisen tunnus alla olevaan URL-osoitteeseen ja siirry sitten tuloksena olevaan URL-osoitteeseen selaimessa. Tämä luo ”Käyttöoikeutta pyydetty” -kehotuksen, jossa on vaihtoehto myöntää suostumus sovellukselle Office 365 -vuokralaiselle.
  • Kun olet hyväksynyt sovelluksen, saatat kohdata virheilmoituksen. Tämän virheen voi jättää huomiotta.

• • Kun suostumus on myönnetty, järjestelmänvalvojasi joutuu lisäämään käyttäjät manuaalisesti HubSpot Sales -sovellukseen Enterprise-sovellusten kautta.

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

Hyväksyntä vaaditaan

Samoin kuin virheessä ”Tarvitaan järjestelmänvalvojan hyväksyntä”, virhe ”Hyväksyntä vaaditaan” ilmenee, kun IT-järjestelmänvalvojasi on määrittänyt rajoituksia sovellusten asentamiselle paikallisessa Azure Active Directory -ympäristössäsi, mutta ottanut käyttöön järjestelmänvalvojan suostumusprosessin.

Voit korjata tämän virheen kirjoittamalla perustelun sille varattuun tekstikenttään ja lähettämällä pyynnön IT-järjestelmänvalvojallesi. Järjestelmänvalvojasi on hyväksyttävä pyyntö kolmannen osapuolen sovelluksen asentamiseksi. Järjestelmänvalvojat voivat myös tarkistaa ja hyväksyä odottavia pyyntöjäJärjestelmänvalvojan suostumuspyyntöjä -sivulla.

Google Advanced Protection

Jos Google-tilisi on liitetty Googlen Advanced Protection -ohjelmaan, sovellukset, jotka vaativat laajennettuja käyttöoikeuksia Gmailiin ja Google Driveen, estetään oletusarvoisesti automaattisesti. Jotta HubSpotin Gmail-integraatio toimisi oikein, tarvitaan käyttöoikeus lukea ja kirjoittaa sähköposteja puolestasi, minkä Google luokittelee korkean riskin käyttöoikeudeksi.

Voit korjata tämän ongelman ja yhdistää postilaatikkosi HubSpotiin ottamalla yhteyttä Google Workspace -järjestelmänvalvojaan ja pyytämällä häntä lisäämään HubSpotin organisaatiosi Workspace-asetusten luotettujen sovellusten luetteloon. Lue tästä Google-ohjekeskuksen artikkelista, miten luotettujen sovellusten luettelo määritetään.

Lue lisää Googlen Advanced Protection -ohjelmasta.