A maioria dos problemas com a conexão do HubSpot aparece em um de três lugares: o quadro Status da conexão em Configurações, depois Integrações, a página de instalação ou o histórico do workflow do HubSpot que executou uma etapa do MemberArea. Este artigo passa por eles nessa ordem.
O quadro de status da conexão
Abra Configurações, depois Integrações, e clique na linha do HubSpot. A caixa de diálogo mostra o quadro Status da conexão com um selo para o estado em que a conexão está.
| Selo | O que significa | O que fazer |
|---|---|---|
| Ativo | O HubSpot respondeu e o acesso que o MemberArea tem é válido | Nada |
| É necessário reconectar | O HubSpot não aceita mais esse acesso, por exemplo porque o app foi removido no HubSpot | Clique em Reconectar no quadro |
| Portal incorreto | O acesso responde por outra conta do HubSpot, diferente da que está salva aqui | Clique em Reconectar no quadro |
| Não acessível | O HubSpot não respondeu à verificação | Clique em Verificar novamente daqui a pouco |
Abaixo do selo, o quadro mostra a conta conectada e o ID do portal, e depois lista cada permissão que a conta concedeu. Estes avisos podem aparecer embaixo:
- A conexão com o HubSpot expirou: o HubSpot não aceita mais o acesso que o MemberArea tem. Os contatos não são sincronizados e as etapas do MemberArea nos seus workflows não são executadas até você reconectar.
- Faltam permissões: uma permissão necessária está ausente, e o aviso cita cada uma. Partes da sincronização ficam desativadas até você reconectar e confirmar as permissões solicitadas.
- As ações de workflow estão desativadas: a permissão opcional de automação não foi concedida, então as etapas do MemberArea não aparecem nos seus workflows do HubSpot. Todo o resto continua funcionando.
Cada um desses avisos tem um botão Reconectar. O HubSpot pede as permissões de novo, e você volta para Integrações.
O resultado fica guardado por 15 minutos, por isso a linha no fim do quadro costuma mostrar a hora da última verificação. Verificar novamente consulta o HubSpot na hora. São permitidas três verificações novas por minuto. Depois disso o quadro diz Verificado há pouco, é apresentado o último resultado.
Quando a conexão foi interrompida, a linha do HubSpot em Integrações indica Desconectado, e a caixa de diálogo diz Esta conexão foi interrompida. Reconecte para manter os dados sincronizados. Clique em Reconectar ali. Nada do que já chegou ao HubSpot se perde.
"Não foi possível conectar a conta."
Este aviso vermelho aparece no topo de Integrações quando você volta do HubSpot sem uma conexão. A linha abaixo dele informa o motivo:
| Motivo | O que fazer |
|---|---|
| HubSpot authorisation was cancelled. | A caixa de diálogo do HubSpot foi fechada ou recusada. Conecte de novo e confirme. |
| HubSpot account … is already connected to another MemberArea business. | Uma conta do HubSpot pertence a um só espaço de trabalho. Desconecte-a primeiro no outro espaço de trabalho. |
| HubSpot did not tell us which account was connected. | Conecte de novo e escolha uma conta na caixa de diálogo do HubSpot. |
| Missing OAuth state or code. | O HubSpot mandou você de volta sem resultado. Conecte de novo. |
| HubSpot did not return an access token. | O HubSpot não concluiu a conexão. Conecte de novo daqui a pouco. |
Se passarem mais de 15 minutos na caixa de diálogo do HubSpot, você chega à sua lista de espaços de trabalho e nada é conectado. Abra o seu espaço de trabalho e conecte de novo.
Na página de instalação
Estas mensagens aparecem quando você instala o app por um link de instalação.
"Este link de instalação não é mais válido. Os links ficam abertos por 15 minutos." Passaram mais de 15 minutos, ou você abriu a página em um navegador diferente daquele em que começou a instalação. O link só funciona no navegador que passou pela caixa de diálogo do HubSpot. Abra o link de instalação de novo em um único navegador e termine por lá.
"Esta conta HubSpot já está conectada": a conta pertence a um espaço de trabalho ao qual você não tem acesso. Peça ao proprietário desse espaço de trabalho que a desconecte por lá.
"HubSpot account … is already connected to another MemberArea workspace.": a conta pertence a outro espaço de trabalho seu. Desconecte-a primeiro nesse espaço de trabalho e depois instale de novo.
"Confirm that HubSpot account … may be disconnected before this one takes its place.": o espaço de trabalho escolhido já tem outra conta do HubSpot. Marque Substituir a conta atual para trocá-la, ou escolha outro espaço de trabalho.
"Crie um espaço de trabalho para concluir a instalação": a sua conta ainda não tem um espaço de trabalho. Clique em Criar um espaço de trabalho e depois abra o link de instalação de novo.
Uma etapa do HubSpot em uma automação falhou
Abra a automação e veja o Histórico de execuções dela. Uma execução com uma etapa do HubSpot com falha indica Falhou e informa o motivo:
| Motivo | O que fazer |
|---|---|
| Nenhuma conexão do HubSpot está selecionada nesta etapa. Escolha uma no editor. | Abra a etapa e escolha a conexão em Integração. |
| A conexão com o HubSpot expirou. | Clique em Reconectar em Configurações, depois Integrações. |
| O HubSpot não aceitou o contato. | Verifique o endereço de e-mail do membro e as permissões em Status da conexão. Para Definir propriedade do contato, verifique se o valor combina com a propriedade, por exemplo o valor interno de uma opção de lista suspensa. |
| O HubSpot não adicionou o contato à lista. | Verifique se a lista ainda existe no HubSpot e se é uma lista estática. |
| O HubSpot não removeu o contato da lista. | Verifique se a lista ainda existe no HubSpot e se é uma lista estática. |
Um membro sem endereço de e-mail, uma etapa de lista sem lista escolhida ou uma etapa Definir propriedade do contato sem propriedade escolhida não faz a execução falhar. A etapa termina com uma nota de que nada foi enviado, por exemplo Nenhuma propriedade do HubSpot está selecionada nesta etapa.
Uma etapa do MemberArea em um workflow do HubSpot falhou
Quando uma ação do MemberArea não consegue fazer o seu trabalho, a etapa é marcada como com falha no workflow do HubSpot, com um código e uma frase que diz o que fazer. O workflow continua com a próxima etapa, assim um contato não segura todos os que vêm depois. Se o próprio MemberArea tiver uma breve interrupção, o HubSpot tenta a etapa de novo mais tarde.
| Código | O que aconteceu | O que fazer |
|---|---|---|
PORTAL_NOT_CONNECTED |
A conta do HubSpot não está conectada a nenhum espaço de trabalho | Conecte o HubSpot no espaço de trabalho ao qual ele pertence, em Configurações, depois Integrações |
WORKSPACE_MISSING |
O espaço de trabalho por trás da conta do HubSpot não existe mais | Conecte a conta do HubSpot a um espaço de trabalho que exista |
EMAIL_MISSING |
O contato não tem endereço de e-mail | Adicione um ao contato, ou preencha Email address na etapa |
MEMBER_LIMIT_REACHED |
O plano atingiu o seu número de membros | Faça upgrade do plano e execute a etapa de novo |
MEMBER_NOT_CREATED |
Não foi possível criar o membro | Verifique o endereço de e-mail do contato |
COURSE_MISSING |
A etapa não tem ID de curso | Preencha Course ID |
COURSE_NOT_FOUND |
Nenhum curso com esse ID neste espaço de trabalho | Copie o ID do endereço do curso de novo |
COURSE_NOT_PUBLISHED |
O curso é um rascunho | Publique o curso |
PRODUCT_MISSING |
A etapa não tem ID de produto nem de pacote | Preencha o ID |
PRODUCT_NOT_FOUND |
Nenhum produto ou pacote com esse ID neste espaço de trabalho | Copie o ID do endereço do produto ou do pacote de novo |
PRODUCT_NOT_PURCHASABLE |
Create checkout link: o produto está inativo ou não tem um preço que possa ser comprado | Ative o produto e dê a ele um preço |
PRICE_NOT_FOUND |
Create checkout link: o preço pertence a outro produto ou não está mais ativo | Deixe Price ID vazio para o preço padrão, ou escolha um preço deste produto |
WORKSPACE_DOMAIN_MISSING |
Create checkout link: o espaço de trabalho não tem endereço web | Defina o domínio em Configurações |
GROUP_MISSING |
A etapa não tem ID de grupo | Preencha Group ID |
GROUP_NOT_FOUND |
Nenhum grupo com esse ID neste espaço de trabalho | Copie o ID do endereço do grupo de novo |
GROUP_IS_SYSTEM |
A etapa aponta para o grupo automático "Todos os membros" | Escolha outro grupo |
GROUP_FULL |
O grupo atingiu o seu limite de membros | Aumente o limite em Público, depois Grupos |
TAG_MISSING |
A etapa não tem tag | Preencha Tag |
TAG_NOT_FOUND |
Remove tag: nenhuma tag com esse nome neste espaço de trabalho | Confira a grafia do nome da tag |
FIELD_MISSING |
A etapa não tem campo de membro | Preencha Member field |
FIELD_NOT_FOUND |
Nenhum campo de membro com esse nome neste espaço de trabalho | Confira a grafia em Público, aba Campos |
FIELD_TYPE_NOT_SUPPORTED |
O campo é de seleção múltipla ou de upload | Escolha um campo de outro tipo |
INVALID_VALUE |
O valor não combina com o campo, por exemplo texto em um campo numérico | Corrija o valor ou a propriedade do HubSpot de onde ele vem |
AUTOMATION_MISSING |
A etapa não tem ID de automação | Preencha Automation ID |
AUTOMATION_NOT_FOUND |
Nenhuma automação com esse ID neste espaço de trabalho | Copie o ID do endereço da automação de novo |
AUTOMATION_DISABLED |
A automação está desativada | Ative-a em Automações |
AUTOMATION_NOT_PUBLISHED |
A automação nunca foi publicada | Publique-a |
AUTOMATION_NO_TRIGGER |
A automação não tem gatilho | Adicione o gatilho Iniciado a partir de um workflow do HubSpot e publique de novo |
Onde encontrar os IDs está descrito em Usar as ações do MemberArea em um workflow do HubSpot.
Uma automação não inicia a partir do HubSpot
Verifique estes pontos nesta ordem:
- A automação está publicada e ativada em Automações.
- A conexão indica Ativo em Status da conexão. Enquanto ela precisar de um Reconectar, nada chega do HubSpot, e as mudanças feitas nesse meio tempo não iniciam nada depois.
- Para Propriedade de contato do HubSpot alterada: só a fase do ciclo de
vida e o status do lead são informados. Novo valor precisa ser o valor
interno, como
customer, escrito exatamente como no HubSpot. - Para Iniciado a partir de um workflow do HubSpot: veja o histórico do
workflow do HubSpot. Uma etapa Start automation com falha informa o
motivo com um dos códigos
AUTOMATION_acima.
Como os gatilhos funcionam está descrito em Iniciar automações a partir do HubSpot.
O acesso voltou depois que eu o retirei
Ele nunca saiu. O acesso que o membro pagou sobrevive a Revoke access: um pedido do produto mantém o que ele liberou. Reembolse ou cancele o pedido se o acesso realmente precisar ser removido.