Última revisão em: Janeiro de 2025
1. OBJETIVO
O objetivo do Nexpilot é simplificar e agilizar a transferência de dados entre contas da HubSpot.
2. DESCRIÇÃO
O QUE: O Nexpilot é uma extensão para o navegador Google Chrome que permite a transferência eficiente de recursos da HubSpot de uma conta para outra. Ele oferece a capacidade de migrar times, propriedades e workflows de uma conta de origem para uma conta de destino.
POR QUE: A utilização do Nexpilot é fundamental para otimizar e automatizar tarefas de migração que, de outra forma, seriam demoradas e propensas a erros. Isso reduz a carga de trabalho manual, economiza tempo e garante que os recursos sejam transferidos corretamente.
ONDE: É uma extensão baseada em navegador, especificamente projetada para funcionar com o Google Chrome. Portanto, pode ser usado em qualquer ambiente em que o Chrome esteja instalado, incluindo sistemas operacionais Windows, macOS e Linux.
QUANDO: Pode ser usado sempre que for necessário migrar recursos da HubSpot entre contas. Ele é particularmente valioso ao implementar dashboards, workflows complexos ou ao realizar migrações entre ambientes de desenvolvimento e produção.
COMO: A utilização do Nexpilot é realizada apenas em necessidades de migração de dados entre contas. Para saber como realizar o passo a passo veja o próximo tópico.
3. AÇÕES
Aqui você encontrará um tutorial de como utilizar o Nexpilot, com regras de uso de suas funcionalidades.
INSTALAÇÃO DO NEXPILOT
A instalação da extensão pode ser feita através deste link da Chrome Store. Ao entrar, basta apertar o botão de instalar e recarregar a página da HubSpot onde deseja utilizar. Ela é compatível com qualquer navegador que possui como base o Chromium (Chrome, Edge, Arc etc.) e seu funcionamento deverá ser igual para todos os navegadores suportados.
Importante: para instalar a extensão, você deve possuir acesso como usuário da extensão. Caso não tenha acesso à extensão, você deve solicitar ao henrique.falconer@nexforce.co para obter acesso como um usuário da extensão também. O acesso se dá através do mesmo link definido acima.
REGRAS DE USO
Aqui as regras de uso do Nexpilot, para a utilização da ferramenta de uma maneira segura:
- Na Install View (na última aba da tela de mapeamento, antes de clicar em "Migrate"), é muito importante clicar em cada um dos tipos de recurso que vai ser instalado e revisar o que vai ser instalado.
- Se você não deseja instalar algum recurso, basta clicar no botão de "X" que ele vai deixar de instalar esse recurso.
- E se certo recurso já existir na conta destino com outro nome, você deve ir pra aba de Tree View e alterar o recurso para o nome correto no dropdown (ver minuto 15:30 do vídeo treinamento, com o exemplo do Lifecycle Stage "Loyalty" <-> "Recurring").
- Ao final, sempre mandar no canal da squad os reports de erro e de instalação, para deixar registrado o que foi instalado
- Revisar todos os recursos que foram instalados na conta destino, abrindo todos os workflows, listas, propriedades e outros recursos para verificar se há alguma inconsistência em relação a conta de origem.
TUTORIAL DE USO
Aqui o tutorial de uso do Nexpilot, saiba o passo a passo sobre como realização uma migração:
Passo 01: Acesse a HubSpot
- Acesse a HubSpot e clique no botão da extensão do Nexpilot no canto superior direito do navegador.
- No Chrome, vá até as extensões e fixe o Nexpilot para facilitar o acesso.
Passo 02: Escolher a conta de referência
-
Abra a extensão do Nexpilot e escolha entre "Migrate Resource" e "Migrate Packages." Na maioria dos casos, use o "Migrate Resource."
-
Selecione a conta que você deseja migrar os recursos no campo source account.
Observação: essa é a conta que você irá usar como referência, ou seja, de onde devem partir os recursos, ela é a origem, não o destino final.
Passo 03: Entrando no ambiente de migração
-
No campo, resource type, selecione os recursos que deseja migrar.
-
Você deve verificar os recursos que você selecionou e pode adicionar mais recursos caso achar que tenha necessidade.
-
Verifique se os recursos selecionados correspondem aos da conta de destino.
-
Caso o Nexpilot não encontre correspondências, você pode ajustar manualmente.
-
-
Quando todos os recursos que você deseja migrar de uma conta para outra estiverem selecionados, clique no botão "Add Resources" para prosseguir.
-
Escolha a conta destino no campo "target account" e clique no botão "continue".
Lembre-se: é importante conhecer bem a conta de destino para garantir que a migração seja bem-sucedida. O Nexpilot agiliza o processo, mas a revisão manual é essencial em alguns casos. Mantenha uma boa comunicação com a equipe para resolver problemas e garantir um processo eficiente.
Passo 04: Confirme a ação
-
Confirme a conta destino para a qual os recursos serão migrados.
-
Confirme a seleção e o Nexpilot obterá todas as dependências.
Observação: no caso de propriedades e grupos de propriedades, a lista pode aparecer vazia se não selecionar nenhum filtro de Object.
Passo 07: Realize o mapeamento de recursos entre contas
-
Após ter selecionado a conta destino, aparecerá um popup com uma treeview de todas as dependências dos recursos selecionados.
-
Realize o mapeamento de recursos entre as contas de origem e de destino, e selecione quais dependências você gostaria de trazer nessa automação.
-
Ao final, clique em "Migrate".
Antes de iniciar a migração, é importante notar a presença de um botão "X" que permite evitar a instalação de recursos específicos. Isso é útil quando você já selecionou vários workflows e deseja excluir aqueles que não devem ser transferidos, como o "objeto-lead".
Ao clicar no botão "X" ao lado de um recurso, você pode removê-lo e confirmar a exclusão. Além disso, o Nexpilot oferece a opção de remover automaticamente todos os recursos dependentes do recurso excluído, simplificando o processo de seleção de recursos para a migração.
Passo 08: Aguarde a migração finalizar
Após ter realizado o mapeamento de recursos e iniciado a migração, aguarde a migração finalizar.
Atenção: você não deve em hipótese alguma encerrar essa janela do Chrome durante a migração (pode minimizar).
Evite clicar em links da página ou recarregar a página durante a migração, pois isso pode interromper o processo.
Possibilidade de erros: É possível que aconteça erros durante a migração, se esse for o caso, irá aparecer uma tela mostrando o erro e perguntando se você deseja continuar ou abortar a migração. Caso tenha dúvidas sobre o que fazer, pergunte para o time de desenvolvimento.
Passo 09: Verificando a Migração
-
Após a migração, você pode verificar os recursos na conta de destino para garantir que foram instalados corretamente.
Atenção: em casos de dependências circulares, o Nexpilot pode criar recursos parcialmente. Isso é uma situação específica que deve ser gerenciada manualmente.
Passo 10: Relatórios e Comunicação
- Baixe o relatório em .pdf de instalação para registro.
- Comunique-se com a equipe através do Slack ou outros canais, compartilhando os relatórios para análise.
Passo extra: Gerenciando Erros
- Durante a migração, o Nexpilot pode encontrar erros, especialmente em casos de dependências circulares.
- Os erros são registrados e você pode baixar um relatório de erros para resolvê-los manualmente.
4. DICAS
O Nexpilot permite um ganho incrível de eficiência no nosso roadmap:
-
Não é preciso preocupar-se com atualizações a serem realizadas da extensão do Nexpilot na Chrome Store. Extensões da Chrome Store, ao receberem uma nova versão, são atualizadas automaticamente pelo Chrome à nova versão.
-
Utilize da exclusão seletiva para remover apenas os recursos desejados.
-
Realize testes para confirmar que os recursos funcionam conforme o esperado após a migração.
-
Mantenha um registro das datas e resultados dos testes e use os relatórios como um registro de auditoria para futuras verificações.
Lembre-se de que é importante conhecer bem a conta de destino para garantir que a migração seja bem-sucedida. O Nexpilot agiliza o processo, mas a revisão manual é essencial em alguns casos. Mantenha uma boa comunicação com a equipe para resolver problemas e garantir um processo eficiente.
Se tiver dúvidas, não hesite em contatar o time de produtos da Nexforce.