Última modificação: 28 de agosto de 2025
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. 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. 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.
- Crie e edite assinaturas de webhook.
Aplicativos privados em projetos (BETA)
Os aplicativos privados criados usando a estrutura de projetos do desenvolvedor permitem criar extensões de UI para registros do CRM e painéis de visualização do help desk. Você precisará de uma assinatura Sales Hub ou Service Hub Enterprise para compilar uma extensão de UI em para um aplicativo privado em uma conta padrão da HubSpot. No entanto, você pode testar essas ferramentas gratuitamente em uma conta de teste de desenvolvedor. Para começar, inscreva sua conta na versão beta e siga as instruções do guia de início rápido.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.
Aplicativos públicos em projetos (BETA)
Aplicativos públicos criados usando a estrutura de projetos do desenvolvedor permitem criar extensões de UI para registros do CRM e painéis de visualização do help desk. Você também pode incluir outras extensões em um aplicativo público criado dessa maneira, mas precisará gerenciar essas extensões no HubSpot e através da API como antes. Se você estiver inscrito na versão beta, comece seguindo o guia de início rápido ou saiba como migrar um aplicativo público existente para a estrutura de projetos.Extensões compatíveis por tipo de aplicativo
| Tipo de aplicativo | Extensões compatíveis |
|---|---|
| Aplicativo privado | Extensões de UI são suportadas em aplicativos privados criados com projetos (BETA). |
| Aplicativo público | Extensões de UI são suportadas em aplicativos públicos criados com projetos (BETA). |
*Os cartões de CRM clássicos são diferentes dos cartões de aplicativo que você pode criar como extensões de IU com projetos. 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 do desenvolvedor, que podem ser criadas em contas de desenvolvedor, são usadas para testar as APIs e os aplicativos que você está criando sem afetar os dados em uma conta real da HubSpot.
- Se você tiver uma assinatura do Sales Hub ou do Service Hub Enterprise, poderá usar sandboxes de desenvolvimento em uma conta padrão da HubSpot para iterar rapidamente sem afetar os dados ou ativos da conta.
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 do HubSpot ou para listagem no Marketplace de aplicativos deve usar o OAuth. 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 do 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 aplicativo privado ou OAuth. Para acessar sua chave de API de conta de desenvolvedor de apps:- Na sua conta de desenvolvedor de aplicativo, navegue até Chaves > Chave de API do desenvolvedor na barra de navegação à esquerda.
- Clique em Criar chave.
- Depois que a chave for criada, você pode clicar em Mostrar chave. A chave será revelada e você poderá clicar em Copiar abaixo da chave.
- Para revisar uma lista de ações de segurança recentes associadas à chave, clique em Exibir registros de auditoria.
- Você também pode girar a chave de API atual clicando em Ações, passando o mouse sobre Girar chave e então clicar em Desative e gire esta chave agora.
- Para desativar a chave sem gerar uma nova, clique em Ações, passe o mouse sobre Desativar chave e então clique em Desative esta chave agora.
Excluir conta de desenvolvedor
É 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.
