Contas e ferramentas de desenvolvedor

A HubSpot tem várias ferramentas para colocar seu aplicativo ou sua integração em execução. O primeiro passo é criar uma conta de desenvolvedor. * A partir daí, você poderá criar um aplicativo, listar seus aplicativos no Marketplace de aplicativos ou criar uma conta de teste.

* Se quiser criar uma integração personalizada para uma única conta usando sua chave de API, você não precisará de uma conta de desenvolvedor. No entanto, as contas de teste só podem ser criadas em contas de desenvolvedor. Pode ser que você queira criar contas de teste para testar sua integração sem comprometer os dados reais do HubSpot.


Para que servem os aplicativos no HubSpot?

Distribuição e segurança:

Pense nos aplicativos como um pacote de qualquer funcionalidade que você deseja compartilhar com usuários do HubSpot (ou com uma única conta da HubSpot). A autenticação do aplicativo usando o OAuth faz com que esse pacote seja seguro para os usuários que se conectam à sua integração.

Requisitos de API:

É necessário ter um aplicativo no HubSpot para poder usar os recursos cartão de CRM, evento de linha do tempo e webhook. Embora não seja obrigatório, também é altamente recomendado um aplicativo para o Ecommerce Bridge.


Qual é a relação entre uma conta de desenvolvedor e uma conta de teste?

Embora as contas de desenvolvedor e as contas de teste funcionem em conjunto, cada uma delas atende a um propósito diferente. As contas de desenvolvedor são aquelas em que você pode criar e listar aplicativos. As contas de teste* permitem que você experimente nossas APIs e teste os aplicativos que está construindo sem comprometer os dados de uma conta real do HubSpot. As contas de teste expiram após 90 dias, mas poderão ser renovadas manual ou automaticamente quando uma chamada OAuth for feita. As contas de teste só podem ser criadas e gerenciadas em uma conta de desenvolvedor. Por isso, você precisará começar aqui. 

* Você pode criar até 10 contas de teste por conta de desenvolvedor.


Chaves de API da conta de desenvolvedor

A chave de API do desenvolvedor é usada para gerenciar as configurações do aplicativo da HubSpot por meio da API. Isso inclui gerenciar inscrições da API de Webhooks, criar ou atualizar tipos de evento do recurso de eventos de linha do tempo ou atualizar configurações do Ecommerce Bridge.

Conforme mencionado acima, as chaves de API de desenvolvedor só podem ser usadas para chamadas de API com a finalidade de atualizar as configurações de um aplicativo. Todas as outras chamadas de API precisam ser feitas usando uma chave de API exclusiva da conta (que é diferente da chave de API do desenvolvedor) ou por meio de uma conexão do OAuth.

Obtenha sua chave de API de desenvolvedor clicando no botão “Receber a chave de API da HubSpot” no canto superior do painel Aplicativos em sua conta do desenvolvedor

get_dev_api_key-1

Isso abrirá um modal mostrando sua chave de API e seu ID de usuário de desenvolvedor. (Para obter mais segurança, clique em “Mostrar chave”.)

Se a chave de API do desenvolvedor tiver sido comprometida, você poderá desativá-la e gerar uma nova usando o botão “Gerar novamente a chave”.

show_dev_api_key


ID do aplicativo

O ID do aplicativo pode ser encontrado em dois locais.

Abaixo do nome do aplicativo no painel Aplicativos de sua conta de desenvolvedor:

Ou nas Configurações de Autenticação do aplicativo:Screen Shot 2020-01-15 at 2

app_auth_id_settings


Monitorando o comportamento do aplicativo

O HubSpot registra todas as solicitações feitas para um aplicativo conectado, ou de um aplicativo conectado, inclusive solicitações recebidas usando um token de acesso OAuth ou solicitações enviadas para webhooks ou cartões de CRM. 

 

Ferramentas de monitoramento de aplicativo:

Para exibir este log de solicitações, acesse a página de configurações do aplicativo e clique em “Monitoramento” na barra lateral esquerda. Cada tipo de solicitação tem sua própria seção e pode ser filtrado usando as opções do menu suspenso.

app_monitoring

Obtendo informações da solicitação:

Clique em uma solicitação específica para obter mais informações sobre ela. As solicitações bem-sucedidas exibirão apenas informações básicas, mas os erros terão detalhes adicionais.

Observação: Os cabeçalhos de solicitação e resposta e o corpo só serão gravados para as solicitações que resultarem em erro. As solicitações bem-sucedidas registrarão apenas o método, o caminho e o horário da solicitação. 

request_details

Chamadas de API:

O log de chamadas de API listará todas as solicitações feitas no aplicativo usando um token de acesso OAuth. Ele pode ser filtrado por método HTTP, código de resposta, período ou URL de solicitação.

api_calls_monitoring-1

Webhooks:

A guia Webhooks mostra solicitações do HubSpot para qualquer uma das inscrições de webhook do aplicativo. Filtre por resposta (inclusive fluxos de trabalho e falhas de conexão), status (sucesso, tentará novamente ou falha), tipo de inscrição, período de tempo, tentativa, lote, evento ou ID da conta. Observação: O ID da tentativa consiste em uma combinação de subscriptionId, eventId e attemptNumber de uma solicitação específica.

webhook_monitoring

Extensões de CRM:

Você encontrará solicitações do HubSpot para os cartões do CRM do aplicativo na guia Extensões de CRM. Filtre por tipo de objeto de extensão, tipo de objeto de CRM (contato, empresa, tíquete ou negócio), erro ou tipo de aviso, período de tempo, ID da solicitação ou ID do objeto de CRM (ou seja, um ID de contato específico).

crm_extension_monitoring-1


Exclusão da conta de desenvolvedor 

Os usuários poderão excluir contas de desenvolvedor de API se elas não contiverem aplicativos 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 de 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


 

Documentos relacionados

Criando e instalando aplicativos

Criar uma conta de desenvolvedor

Criar uma conta de teste