- Na sua conta da HubSpot, clique no ícone de configurações na barra de navegação principal.
- No menu lateral esquerdo, acesse Integrações > Aplicativos privados.
- Clique em Criar aplicativo privado.
- Na guia Informações básicas, configure os detalhes do aplicativo:
- Insira o nome do aplicativo.
- Passe o cursor do mouse sobre o logotipo de espaço reservado e clique no ícone de upload para carregar uma imagem quadrada que servirá como logotipo do seu aplicativo.
- Insira uma descrição para o aplicativo.
- Clique na guia Escopos.
- Marque a caixa de seleção Leitura ou Gravação para cada escopo que você deseja que seu aplicativo privado possa acessar. Você também pode pesquisar um escopo específico usando a barra de pesquisa Encontrar um escopo.
- Quando terminar de configurar seu aplicativo, clique em Criar aplicativo no canto superior direito.
- Na caixa de diálogo, revise o as informações sobre o token de acesso do seu aplicativo e clique em Continuar criando.
Depois de criar seu aplicativo, você pode começar a fazer chamadas de API usando o token de acesso do aplicativo. Se você precisar editar as informações do seu aplicativo ou alterar os escopos, clique em Editar detalhes.
Para começar a fazer chamadas de API, acesse a página de detalhes do aplicativo.
- No cartão Token de acesso, clique em Mostrar token para revelar seu token de acesso. Clique em Copiar para copiar o token para a área de transferência.
- Você pode colar o token de acesso para fornecê-lo aos desenvolvedores ou usá-lo para desenvolver seu aplicativo. Ao fazer uma chamada para um dos endpoints de API da HubSpot, defina o valor do campo Autorização como Portador [YOUR_TOKEN]. Por exemplo, se você estiver fazendo uma chamada para a API de contatos usando Node.js e axios, a solicitação será parecida com a seguinte:
Se o token de acesso for perdido ou comprometido, você poderá revezá-lo. Um novo token de acesso será criado e o original expirará.
- Na sua conta da HubSpot, clique na página Configurações na barra de navegação principal.
- Acesse Integrações > Aplicativos privados.
- Clique no nome do seu aplicativo privado.
- Ao lado do token de acesso, clique em Revezar:
- Se seu token for comprometido e você quiser revogar o acesso imediatamente, clique em Revezar e expirar agora.
- Se não houver ameaça iminente ao seu token, ainda é recomendável revezar seu token a cada seis meses. Se você estiver pronto para iniciar um revezamento regular do seu token, clique em Revezar e expirar mais tarde, o que acionará a expiração do token em 7 dias.
- Se seu aplicativo já estiver pronto para fazer a transição, você pode clicar em Expirar agora.
- Se você decidir que precisa de mais tempo, pode clicar em Cancelar revezamento, que cancelará a expiração do token original e revogará o novo token de acesso.
O HubSpot também enviará notificações por e-mail aos superadministradores com lembretes sobre o status de revezamento do token de acesso, bem como outros alertas relacionados. Os superadministradores na sua conta da HubSpot receberão notificações para os seguintes eventos e lembretes:
- Um superadministrador iniciou um revezamento (imediatamente ou agendado para daqui a sete dias).
- Um superadministrador cancelou um revezamento pendente.
- Um superadministrador optou por expirar um token de acesso imediatamente, clicando em Expirar agora, em vez de esperar sete dias para a expiração do token.
- O token de acesso do aplicativo está prestes a expirar em 24 horas.
- O token de acesso do aplicativo teve revezamento e expirou após sete dias.
- Se não tiver revezado o seu token de acesso em mais de 180 dias, os superadministradores também receberão um e-mail de lembrete para revezar o token de acesso do seu aplicativo.
Para revisar as chamadas de API que seu aplicativo fez nos últimos 30 dias:
- Na página de detalhes do aplicativo, clique na guia Logs.
- Revise e filtre suas chamadas de API do aplicativo privado:
- Clique nos menus suspensos Método e Resposta para filtrar suas chamadas de API históricas por método de solicitação ou código de resposta.
- Clique no menu suspenso data de início ou data de término para limitar os logs de chamada a um intervalo de tempo específico.
- Você também pode pesquisar chamadas específicas por URL na caixa de pesquisa Pesquisar por URL de solicitação.
- Para exportar os registros das chamadas de API, clique em Exportar registros (CSV). Em seguida, especifique um intervalo de datas (até os últimos 30 dias) e clique em Exportar.
- Na caixa pop-up, selecione o intervalo de datas das chamadas de API que deseja exportar e clique em Exportar. Você receberá um e-mail com um link de download quando a exportação estiver pronta.