Resolver erros de ligação da caixa de entrada e do calendário

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

Erros na caixa de entrada e no calendário do Office 365

Revise 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 recurso de TI, observe que o HubSpot usa a Graph API do Microsoft 365 para se integrar à sua caixa de entrada. Para o calendário do Office 365, o HubSpot usa a API REST do Outlook. O HubSpot exige os seguintes escopos para conectar-se: 

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

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 conectar-se via IMAP ou Exchange se estiver executando um servidor de Exchange.

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 a atribuição de usuários para 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 definições de consentimento do utilizador: siga estes passos na documentação do Azure da Microsoft para ativar a definição Permitir utilizador consentimento para aplicações de editores verificados, para permissões seleccionadas (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.
• Ativar o fluxo de trabalho de consentimento do administrador: siga estas instruções descritas na documentação do Azure da Microsoft para ativar a definição Os utilizadores podem solicitar o consentimento do administrador para aplicações que 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 rever e aprovar pedidos pendentes na página Pedidos de consentimento do administrador .
• Consentimento de permissões para o inquilino: utilizar a plataforma de identidade Microsoft ponto final de consentimento do administrador:
  • 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.
  • 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/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 a sua conta Google estiver inscrita em Programa de Proteção Avançada da Google, as aplicações que requerem acesso elevado ao Gmail e ao Google Drive são automaticamente bloqueadas por predefinição. Para que a integração do Gmail da HubSpot funcione corretamente, é necessário acesso para ler e escrever 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 aplicações fidedignas em neste artigo do Centro de Ajuda do Google.

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