Criando e instalando aplicativos

Na HubSpot, um aplicativo é um tipo de integração que pode ser instalada nas contas de clientes ou listadas no Marketplace de aplicativos. Ela requer autenticação por meio do OAuth. Assim que um usuário instalar o aplicativo em sua conta da HubSpot, você poderá fazer chamadas de API para essa conta usando um token de acesso OAuth. O aplicativo também aparecerá na página Aplicativos conectados da conta (Configurações > Integrações > Aplicativos conectados), em que os usuários podem gerenciá-lo ou desinstalá-lo.

Determinados recursos de integração estão disponíveis apenas por meio de aplicativos; eles não podem ser usados com integrações 1:1. Por exemplo, apenas aplicativos instalados podem se inscrever para alterações usando webhooks ou criar eventos de linha do tempo personalizados e cartões de CRM. Embora não seja obrigatório, também é altamente recomendado um aplicativo para o Ecommerce Bridge.

Criando um aplicativo

Quando cria um aplicativo no HubSpot, basicamente você associa o aplicativo criado com uma conta de desenvolvedor. Depois de configurar a conta e entrar nela, seu ponto de partida será a página inicial da conta de desenvolvedor. Nela, você terá a opção de criar seu primeiro aplicativo ou criar uma conta de teste. Clique em “Criar aplicativo”.

 

dev_landing_dash

Você também pode iniciar no painel Aplicativos usando o botão “Criar aplicativo”.

app_dash_first_app

1. Informações básicas

Em seguida, você preencherá algumas informações básicas e configurações do aplicativo. Quando os usuários autenticarem o aplicativo na conta da HubSpot, eles verão o nome, a descrição, o logotipo e qualquer informação de contato de suporte que você fornecer nesta página. 

2. Configurações de autenticação

Na próxima guia, você encontrará suas configurações de Autenticação, inclusive o ID e o segredo do cliente. É ali também que você configurará os escopos do aplicativo. Você precisará destas informações para iniciar uma conexão do OAuth entre o aplicativo e a HubSpot.

3. Escopos

Clique no menu suspenso na parte inferior da página para adicionar novos escopos ao aplicativo. Esses escopos obrigatórios devem ser incluídos no parâmetro scope= de seu URL de autorização; caso contrário, os usuários receberão um erro quando tentarem autorizar o aplicativo. Para obter mais informações sobre como criar o URL de autorização e usar escopos, consulte os documentos do OAuth

app_scopes

4. URL de redirecionamento

Os usuários serão direcionados para este local depois que você conceder à conta da Hubspot deles acesso ao aplicativo. Se você não incluir um URL de redirecionamento, os usuários receberão um erro de conexão. A menos que estejam em um host local, os URLs de redirecionamento devem usar HTTPS.


Instalando aplicativos

Antes de instalar um aplicativo

Observações importantes: 
  • Um aplicativo só aparecerá na página Aplicativos conectados da conta depois que os tokens iniciais de acesso e de atualização forem criados.
  • Um aplicativo só poderá ser instalado por usuários com acesso aos escopos obrigatórios de um aplicativo.
  • Não é possível instalar aplicativos em contas de desenvolvedor. Para testar o aplicativo, crie uma conta de teste (que é criada em sua conta de desenvolvedor) e instale-a ali.

Como instalar um aplicativo

A instalação de um aplicativo pode ser dividida em duas etapas: autorização e geração de token. 

1. Autorize o aplicativo com uma conta de cliente. 

Para autorizar o aplicativo com uma conta da HubSpot, você precisará criar um URL de autorização. Para fazer isso, obtenha o ID de cliente do aplicativo e inicie o processo do OAuth.

Depois que o URL estiver pronto, abra-o no navegador para ver uma lista de todas as suas contas da HubSpot. (É exatamente isso que os usuários verão quando você direcioná-los para esse URL.) Selecione a conta em que deseja instalar o aplicativo.

select_account-1

Depois que você escolher uma conta, será apresentada uma lista de escopos baseada nos parâmetros &scopes= e &optional_scope= definidos para o URL de autorização. Observação: Se você incluir o parâmetro optional_scope e a conta selecionada não tiver acesso a ele (como o escopo do conteúdo para uma conta somente do CRM), ela não será listado. Clique no botão “Conceder acesso” para autorizar a conexão.

approve_scopes-1

Depois que o acesso for concedido, você será redirecionado de acordo com o parâmetro &redirect_uri= no URL de autorização original, e um parâmetro ?code= será anexado ao URL. Use esse código na próxima etapa para gerar um token de acesso.

2. Gerar os tokens iniciais do OAuth usando o código de autenticação fornecidos durante a autorização

Para gerar seus tokens de acesso iniciais e de atualização, você precisará do código do parâmetro ?code= do URL de autorização, do redirect_url da Etapa 1 e do ID e do segredo do cliente. Você encontrará instruções detalhadas aqui

 

Depois de instalar um aplicativo

Depois de autorizar o aplicativo e gerar os tokens iniciais, a instalação estará concluída. O aplicativo será listado em sua página Aplicativos conectados localizada em Configurações > Integraçoes > Aplicativos conectados. Você começará a receber solicitações de busca de webhook e Cartões de CRM .

connected_apps-1


Documentos relacionados

Ferramentas e contas de desenvolvedores

Contas de teste

Listando o aplicativo