Solucionar erros de conexão da caixa de entrada e do calendário

Quando você conecta sua caixa de entrada do Gmail ou caixa de entrada ou calendário do Office 365 ao HubSpot, pode encontrar um erro durante o processo de conexão. Saiba sobre a causa raiz desses erros comuns e como solucioná-los.

Erros da caixa de entrada e do calendário do Office 365

Analise os erros abaixo se encontrar problemas ao conectar sua caixa de entrada ou calendário do Office 365 ao HubSpot.

Permissões necessárias para conectar a caixa de entrada ou o calendário do Office 365

Se você é um administrador de TI, observe que o HubSpot usa a API do Microsoft Graph para se integrar à sua caixa de entrada e calendário. O HubSpot exige os seguintes escopos para se conectar: 

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

Caixa de entrada do Office 365 e calendário não encontrado

Esse erro significa que sua conta do Office 365 não tem uma caixa de correio para o endereço de e-mail que você está tentando conectar. Por exemplo, você pode ter uma conta do Office 365 usada para outros produtos, como Word ou Excel, mas seu e-mail está hospedado com um provedor de e-mail diferente. Você precisará escolher o provedor correto para conectar seu calendário ou e-mail.

Indisponível - acesso da API não habilitado para a caixa de correio

Você verá esse erro na sua conta da HubSpot como OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX. Esse erro pode ter duas causas:

• Esse erro pode ser uma indicação de que você está no processo de migração de um outlook.com/hotmail ou outro serviço para uma conta do Office 365. Essa migração pode levar algum tempo, e esse erro aparecerá se você tentar se conectar durante a migração.
• Esse erro também pode significar que seu domínio está usando uma troca híbrida no local e uma configuração do Office 365. Isso significa que você tem uma conta do Office 365, mas não tem uma caixa de correio gerenciada diretamente pela Microsoft. Como resultado, o HubSpot não consegue acessar a API REST para sua caixa de correio. O HubSpot exige a API REST para se conectar a uma conta do Office 365. Uma maneira de verificar se sua caixa de entrada de e-mail não está hospedada no Office 365 é procurar seu domínio de e-mail em MX Toolbox, que é um site externo que exibe registros MX. Por exemplo, esta pesquisa MX mostra que o domínio sidekick.engineering está hospedado pelo Office 365, mas essa pesquisa MX para mac.com não mostra nenhum provedor de e-mail conhecido.

Caso veja esse erro, será necessário se conectar usando um provedor de e-mail diferente. Por exemplo, você pode se conectar via IMAP ou via Exchange se estiver executando um servidor Exchange.

Caixa de entrada desconectada: a caixa de correio do Outlook não está habilitada para acesso à API REST

Essa caixa de correio do Outlook não está habilitada para acesso à API REST ocorre quando o Microsoft 365 bloqueia o acesso do HubSpot a uma caixa de correio por meio da API REST do Microsoft Graph. Quando isso acontece, uma caixa de entrada conectada por meio do método de conexão do Microsoft Outlook pode se desconectar repetidamente, mesmo que seja reconectada por curtos períodos de tempo. Esse erro normalmente indica um problema de configuração ou licenciamento do Microsoft 365. 

Para solucionar esse erro, trabalhe com o administrador de TI para revisar o seguinte em seu ambiente do Microsoft 365: 

• Verificar a hospedagem da caixa de correio: confirme se a caixa de correio está hospedada no Exchange Online.
  • Confirme se a caixa de correio não é híbrida, local ou em um estado parcialmente migrado.
  • Verifique se a caixa de correio está totalmente sincronizada no locatário atual.

• Verificar licenças: confirme se a caixa de correio tem uma licença ativa do Microsoft 365 que inclui o Exchange Online.
  • Reatribua ou atualize a licença se ela foi removida ou expirou.

• Revisar migrações de locatário: confirme se a migração foi concluída e se os atributos da caixa de correio se propagaram.
  • Reautorize os aplicativos conectados, incluindo o aplicativo HubSpot Sales.
  • Revise as permissões do Microsoft Entra ID e confirme se o HubSpot tem permissões da Graph API no novo locatário.

• Redefinir ou conceder novamente permissões de aplicativo: no Microsoft Entra ID, verifique se o HubSpot tem acesso à Graph API.
  • Se o acesso à API foi interrompido durante a migração ou alterações de licença, conceda novamente as permissões da API do Graph na ID do Microsoft Entra.

Depois de revisar a configuração da sua conta do Microsoft 365, reconecte sua caixa de entrada ao HubSpot usando o método de conexão do Microsoft Outlook. É recomendado monitorar a conexão da caixa de entrada por 24 a 48 horas. Se o problema persistir, examine seus logs de auditoria do Microsoft 365 em busca de solicitações bloqueadas da Graph API.

O acesso ao OData está desabilitado

Se você receber o erro Acesso ao OData está desabilitado , isso indica que sua conta do Microsoft 365 está bloqueando a conexão com o HubSpot. Isso ocorre quando políticas ou configurações em sua conta do Microsoft 365 limitam o acesso à API do Microsoft Graph .

Para resolver esse erro, trabalhe com o administrador de TI para revisar e atualizar as seguintes configurações em sua conta do Microsoft 365:

• Política de acesso ao aplicativo: se sua política de acesso limitar o HubSpot de acessar caixas de correio específicas, atualize a política para conceder acesso ou remover a restrição.
• Lista de permissões do agente do usuário: se sua conta do Microsoft 365 aplicar uma lista de permissões, verifique se o agente do usuário do HubSpot está incluído. Adicione ou ajuste as entradas da lista de permissões conforme necessário para permitir o acesso à API do Microsoft Graph.

A caixa de entrada conectada do Office 365 é mostrada como outlook_[string_of_characters]@outlook.com

Você pode ver outlook_[string_of_characters]@outlook.com exibido, em vez do seu endereço de e-mail ao conectar uma caixa de entrada do Office 365. Isso ocorre porque o HubSpot não suporta o uso de um alias principal de domínio que não seja da Microsoft. Isso pode causar problemas com o envio ou a sincronização dos e-mails da sua caixa de entrada conectada. Saiba mais sobre esse problema e a solução recomendada da Microsoft. 

Erro de interação necessária

Caso veja um erro de "Interação necessária" ao conectar sua caixa de entrada do Office 365, isso significa que seu usuário precisa de acesso ao aplicativo do HubSpot Sales no Azure AD. Pode ser necessário entrar em contato com seu administrador de e-mail para obter acesso. Saiba mais sobre como atribuir usuários a um aplicativo no Azure AD. 

Exigir aprovação do administrador

Esse erro ocorre quando o administrador de TI configurou restrições para a instalação de aplicativos no ambiente local do Azure Active Directory.

Para resolver esse erro e conectar a integração do Office 365 da HubSpot, o administrador pode seguir uma das seguintes abordagens:

• Atualizar as configurações de consentimento do usuário: siga estas instruções da documentação do Microsoft Azure para ativar a opção Permitir consentimento do usuário para aplicativos de editores verificados para permissões selecionadas (recomendado). Como a HubSpot é uma editora verificada, os usuários da sua conta poderão conectar as caixas de entrada sem precisar fazer mais nada assim que o administrador ativar essa opção.
• Habilitar o fluxo de trabalho de consentimento do administrador: siga as instruções descritas na documentação do Microsoft Azure para ativar a configuração Os usuários podem solicitar o consentimento do administrador para aplicativos com os quais eles não podem consentir. Quando esta opção for ativada, o administrador receberá notificações por e-mail para aprovar a solicitação de um usuário que deseja instalar um aplicativo de terceiros. Os administradores também podem analisar e aprovar solicitações pendentes na página de Solicitações de consentimento do administrador.
• Consentimento para permissões para o locatário: use o endpoint de consentimento do administrador da plataforma de identidade da Microsoft:
  • Copie e cole o ID do locatário no URL abaixo e, em seguida, navegue até o URL resultante em um navegador web. Isso gerará uma solicitação de permissão com a opção de conceder permissão ao aplicativo para o locatário do Office 365.
  • Depois de aceitar o consentimento do aplicativo, você pode encontrar um erro. Este erro pode ser ignorado.

• • Após conceder esse consentimento, seu administrador precisará adicionar manualmente os usuários ao HubSpot Sales a partir dos aplicativos 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

Proteção Avançada do Google

Se sua conta do Google estiver inscrita no Programa de Proteção Avançada do Google, os aplicativos que exigem acesso elevado ao Gmail e ao Google Drive serão bloqueados automaticamente por padrão. Para que a integração do HubSpot com o Gmail funcione corretamente, é necessário o acesso para leitura e composição de e-mails em seu nome, o que o Google classifica como acesso de alto risco.

Para corrigir esse problema e conectar sua caixa de entrada ao HubSpot, você pode entrar em contato com o administrador do Google Workspace e pedir que ele adicione o HubSpot à lista de aplicativos confiáveis nas configurações do Workspace da sua organização. Saiba como configurar uma lista de aplicativos confiáveis neste artigo da Central de Ajuda do Google.

Saiba mais sobre o Programa de Proteção Avançada do Google.