Criar uma visão geral dos aplicativos

Os aplicativos permitem autenticar as chamadas de API para sua conta da HubSpot, assinar eventos com webhooks e estender a interface do usuário da HubSpot, como cartões personalizados. A HubSpot oferece vários tipos de aplicativos e extensões, dependendo das necessidades da sua integração. Saiba mais sobre os tipos de aplicativos e extensões que você pode criar com o HubSpot, como começar a criá-los e como gerenciá-los no HubSpot.

Tipos de aplicativos

Dependendo do tipo de integração que você deseja criar, será necessário escolher o tipo certo de aplicativo. Saiba mais sobre os tipos de aplicativos que você pode criar e as funcionalidades compatíveis.

Para criar extensões, consulte a tabela de referência abaixo para obter uma visão geral rápida de quais extensões podem ser criadas com quais tipos de aplicativos.

Aplicativos privados

Os aplicativos privados podem ser criados para uma única conta da HubSpot e são mais adequados para scripts únicos ou extensões com uma única finalidade. Por exemplo, você pode criar um aplicativo privado para a sua conta da HubSpot para:

  • Criar um novo objeto personalizado por meio da API.
  • Importar registros do CRM de um arquivo CSV.
  • Autenticar solicitações de API em ações de automação personalizadas e chatbots.
  • Criar e editar assinaturas de webhook (BETA).

Em geral, os aplicativos privados são mais simples de implementar do que os aplicativos públicos. Os aplicativos privados são autenticados com tokens de acesso e não podem ser listados no Marketplace de aplicativos da HubSpot. Saiba mais sobre quando criar aplicativos privados.

Se esse tipo de aplicativo atender às suas necessidades, comece a criar um aplicativo privado na sua conta da HubSpot.

Aplicativos privados em projetos (BETA)

Os aplicativos privados criados com projetos permitem criar extensões de interface do usuário para registros do CRM. A diferença de criar um aplicativo privado por meio desse método é que os projetos suportam apenas a criação de extensões de interface do usuário, e os aplicativos privados fora dos projetos não podem fazer isso.

Se esse tipo de aplicativo atender às suas necessidades, confira o guia de início rápido para projetos para começar a criar um aplicativo privado e um projeto usando a CLI.

Aplicativos públicos

Os aplicativos públicos podem ser instalados em várias contas. Além dos tipos de extensões que você pode criar com um aplicativo privado, os aplicativos públicos suportam funcionalidades avançadas, como:

  • Assinar os eventos de toda a conta usando a API de webhooks.  
  • Criar eventos de linha do tempo personalizados em registros de CRM usando a API de eventos da linha do tempo. 
  • Criar páginas de configurações de aplicativos personalizadas no HubSpot. 

Os aplicativos públicos são autenticados com OAuth e podem ser listados no Marketplace de aplicativos da HubSpot. Saiba mais sobre quando criar aplicativos públicos.

Se esse tipo de aplicativo atender às suas necessidades, comece a criar um aplicativo público na sua conta de desenvolvedor de aplicativos.

Extensões compatíveis por tipo de aplicativo

Tipo de aplicativo Extensões compatíveis
Aplicativo privado
Aplicativo público
Aplicativo privado criado com projetos (BETA)
* Os cartões de CRM que você pode criar com aplicativos privados são diferentes dos cartões personalizados que você pode criar como extensões de interface do usuário com projetos (BETA). As extensões de interface do usuário oferecem funcionalidades mais avançadas e componentes personalizáveis.

Tipos de contas para o desenvolvimento de aplicativos

Embora as contas de desenvolvedor de app e as contas de teste funcionem em conjunto, elas possuem propósitos diferentes.

  • As contas de desenvolvedor de aplicativos devem ser usadas para criar e listar aplicativos no Marketplace de aplicativos.
  • Contas de teste para testar as APIs e os aplicativos que você está criando sem afetar os dados em uma conta real da HubSpot. Isso é separado de uma conta de área restrita que você pode criar em contas padrão do HubSpot.

Saiba mais sobre os tipos de conta da HubSpot.

Autenticação

Se quiser criar uma integração personalizada com uma única conta da HubSpot, você pode criar um aplicativo privado e usar seu token de acesso para autenticar chamadas de API ou usar OAuth com um aplicativo público. Qualquer aplicativo desenvolvido para ser instalado em várias contas da HubSpot ou para a listagem no Marketplace de aplicativos deve usar o OAuth. 

Observação: a partir de 30 de novembro de 2022, as chaves de API da HubSpot serão desativadas e não terão mais suporte. Continuar usando as chaves de API da HubSpot representará um risco de segurança para sua conta e dados. Durante esta fase, a HubSpot poderá desativar sua chave a qualquer momento.

Você deve autenticar usando um token de acesso de aplicativo privado ou OAuth. Saiba mais sobre essa alteração e como migrar uma integração de chave de API para usar um aplicativo privado.

Se quiser se inscrever em webhooks ou configurar o OAuth para seu app, você deve criar uma conta de desenvolvedor. Com as contas de desenvolvedor, você também pode listar seus apps no marketplace de apps ou criar uma conta de teste.

Chaves de API da conta de desenvolvedor

Para gerenciar as configurações do app por meio da API, você pode usar uma chave de API do desenvolvedor. Esta chave de API é separada das chaves de API padrão, que foram descontinuadas. As chaves da API do desenvolvedor podem ser usadas para gerenciar assinaturas da API de webhooks e criar ou atualizar tipos de eventos para o recurso de eventos de linha do tempo. Todas as outras chamadas de API precisam ser feitas usando um token de acesso ao app privado ou OAuth.

Para acessar sua chave de API de conta de desenvolvedor de apps:

  • Na sua conta de desenvolvedor de apps, acesse Apps na barra de navegação superior.
  • No canto superior direito, clique na chave de API do Get HubSpot.
  • Na caixa de diálogo, clique em Mostrar chave. A tecla será revelada e você poderá clicar em Copiar próximo à tecla.
  • Também é possível desativar a chave de API anterior e gerar uma nova clicando em Gerar novamente a chave.

show_dev_api_key

Delete a developer account

É possível excluir contas de desenvolvedor de app se elas não contiverem apps com instalações ou listas de marketplace ativas. Se sua conta tiver aplicativos com instalações ou com listas de marketplace ativas e você quiser excluí-la, entre em contato com o suporte para obter assistência.

Depois de excluir sua conta, você não poderá mais acessá-la. Se você puder alternar entre várias contas da HubSpot, a conta excluída não aparecerá mais.

Na conta de desenvolvedor de API da HubSpot, clique no nome da sua conta, no canto superior direito, e depois clique em Conta.

account

Clique em Excluir conta. Se sua conta tiver aplicativos com instalações ou listas do marketplace ativas, esse botão aparecerá desativado.

Account2

Na caixa de diálogo, insira o ID da conta e clique em Excluir conta de desenvolvedor.

Confirm2

 


Este artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot..