/devapi-integrations-challenge

Solved integrations technical challenge for DevApi

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Desafio de integrações DevApi

Aplicação de uma integração entre o Google Sheets e o HubSpot para desafio técnico de processo seletivo da empresa DevApi

• Funcionalidades
• Variáveis de ambiente
• Rodando localmente
• Rodando os testes
• •Ferramentas utilizadas

Funcionalidades

  • Integração entre as plataformas Google Sheets e HubSpot CRM
  • Autenticação de usuário nas plataformas mencionadas
  • Importação de contatos de uma planilha do Google Sheets diretamente para o HubSpot

Variaveis de ambiente

Para rodar este projeto, você irá precisar das seguintes variáveis de ambiente:

GOOGLE_API_KEY="" GOOGLE_SPREADSHEET_ID="1VUP5yPfk25qgDYBB1PrpC-S5hjjGbrKOhmJ_tibeWwA" GOOGLE_SPREADSHEET_RANGE="Página1!A1:E30"

HUBSPOT_ACCESS_TOKEN=""

Lembre-se de criar seu arquivo .env corretamente:

cp -r .env.sample .env

Gerando Chave de API do Google

Para obter uma Chave de API do Google, siga o passo a passo abaixo:

  • Visite o Console do Google Cloud e faça login com sua conta do Google.

  • Selecione ou crie um novo projeto, feito no canto superior esquerdo do console.

  • No painel de navegação à esquerda, clique em APIs e serviços e, depois, em Credenciais.

  • Na aba Credenciais, clique em + CRIAR CREDENCIAIS, no barra de navegação superior, e selecione Chave de API.

  • Copie a Chave de API gerada e cole como o valor da chave de ambiente GOOGLE_API_KEY, no arquivo .env.

Gerando token de acesso do HubSpot

Para obter o token de acesso do HubSpot, siga o passo a passo abaixo:

  • Na sua conta HubSpot, clique no ícone de configurações (engrenagem) na barra de navegação superior.

  • No menu da barra lateral esquerda, acesse Integrações > Aplicativos privados.

  • Selecione ou crie um novo aplicativo. Apenas lembre-se de adicionar o escopo crm.objects.contacts tanto para leitura quanto para escrita.

  • Após criado o aplicativo, copie o token de acesso que será exibido na tela e o repasse para a variável HUBSPOT_ACCESS_TOKEN no arquivo .env.

Rodando localmente

Clone o projeto:

git clone https://github.com/matheustrres/devapi-integrations-challenge.git

Entre no diretório do projeto:

cd devapi-integrations-challenge

Instale as dependências necessárias:

pnpm install

Inicie o servidor para fazer a migração de contatos do Google Sheets para o Hubspot:

pnpm start

Rodando os testes

Para rodar os testes, execute o seguinte comando:

pnpm test

Ferramentas utilizadas

  • Node.js
  • Javascript

Licença

Este projeto está licenciado sob a licença GPL 3.0.