Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.
Integrations

Acesse sua chave de API da HubSpot

Ultima atualização: Julho 23, 2021

Disponível para

Todos os produtos e planos

Com a chave de API da HubSpot, seus desenvolvedores podem criar aplicativos personalizados com APIs da HubSpot. Cada chave é específica para uma conta da HubSpot, não para um usuário individual, e apenas uma chave é permitida por vez.

Acessar sua chave de API

Você deve ter permissões de Superadministrador para acessar a chave de API da sua conta. 

  • Na sua conta da HubSpot, clique no ícone de configurações settingsna barra de navegação principal.
  • No menu da barra lateral esquerda, acesse Integrações > Chave de API.
    • Se uma chave nunca tiver sido gerada para sua conta, clique em Gerar chave de API
    • Se já tiver gerado uma chave de API, clique em Mostrar para exibir sua chave.

show-API-key

  • Com a chave exibida, clique em Copiar para copiar a chave. Você pode colar a chave para fornecê-la aos desenvolvedores ou usá-la em seus aplicativos.

Revezar sua chave de API

Fornecer a chave de API para um desenvolvedor concederá o acesso completo para fazer alterações na sua conta por meio da API da HubSpot, incluindo ler e-mails registrados das contas de e-mail conectadas e outros dados de terceiros.

Para segurança adicional, considere alterar a chave de API da HubSpot a cada seis meses. Ao alterar sua chave de API da HubSpot, a chave existente será ativada e uma nova será gerada. A HubSpot exibirá a idade da chave de API e recomendará quando você deve alterá-la.

Lembretes para alterar a chave de API serão enviados aos Superadministradores e aos usuários que criaram ou alteraram a chave de API nas seguintes frequências e tipos de notificação:

  • Quando a chave de API fizer cinco meses, as notificações de e-mail serão enviadas.
  • Quando a chave de API fizer seis meses, as notificações da barra lateral serão enviadas.
  • Se a chave de API não for alterada em seis meses, as notificações de e-mail e da barra lateral serão enviadas a cada seis meses.

Embora isso possa criar tempo de inatividade e exigir esforço, adiciona uma camada de segurança, impedindo que aplicativos mal intencionados acessem suas informações da HubSpot usando a chave de API existente.

Para alterar a chave de API da HubSpot:

  • Na sua conta da HubSpot, clique no ícone de configurações na barra de navegação principal.
  • No menu da barra lateral esquerda, acesse Integrações > Chave de API.
  • Clique no menu suspenso Ações e selecione Alterar a chave.
  •  Clique em Alterar e expirar essa chave agora. Marque a caixa de seleção de reCAPTCHA. Sua chave existente será desativada e uma nova chave de API será criada.
  •  Clique em Copiar e substitua a chave de API desativada usada pelos aplicativos por essa nova chave de API.

As chamadas de API que usam essa chave de API da HubSpot falharão e os aplicativos que usam essa chave não poderão mais acessar suas informações. 

Alterar a chave de API não afetará sua conexão com a integração do Salesforce. No entanto, se você tiver uma integração personalizada instalada, será necessário atualizar sua chave de API após alterná-la.

Observação: Os aplicativos conectados instalados por meio do Marketplace de aplicativos não serão afetados ao alterar a chave de API.

Desativar sua chave de API

Desativar a chave de API não criará uma nova chave. Ocorrerão falhas nas chamadas de API usando a chave de API da HubSpot desativada e qualquer aplicativo que usa a chave não poderá mais acessar suas informações.

Para desativar a chave de API:
  • Na sua conta da HubSpot, clique no ícone de configurações settingsna barra de navegação principal.
  • No menu da barra lateral esquerda, acesse Integrações Chave de API.
  • Clique no menu suspenso Ações.
  • Clique em Desativar chave e, em seguida, em Desativar esta chave agora. Marque a caixa de seleção de reCAPTCHA. 

Exibir seu registro de auditoria de API

Veja um registro datado dos usuários que visualizaram, criaram ou desativaram a chave de API da conta na seção Registro de auditoria

  • Na sua conta da HubSpot, clique no ícone de configurações settingsna barra de navegação principal.
  • No menu da barra lateral esquerda, acesse Integrações > Chave de API.
  • Clique na guia Registro de auditoria.
  • api-audit-log

Exibir o registro de chamadas da chave de API

Para ajudar a depurar uma de suas integrações ou garantir que você esteja em conformidade com asDiretrizes de uso de APIs da HubSpot, você pode visualizar um registro das chamadas da chave de API dos últimos sete (7) dias. 

  • Na sua conta da HubSpot, clique no ícone de configurações settingsna barra de navegação principal.
  • No menu da barra lateral esquerda, acesse Integrações > Chave de API.
  • Na guia Registro de chamadas, visualize todas as atividades dos últimos sete (7) dias.
call-log-api