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. Requer autenticação por OAuth. Assim que um usuário instalar o app em sua conta da HubSpot, você poderá fazer chamadas de API para essa conta usando um token de acesso OAuth. O app também aparecerá nas configurações Apps conectados da conta.

Os apps conectados também podem aproveitar a assinatura de alterações usando webhooks e criando eventos de linha do tempo personalizados

Crie um app

Ao criar um app na HubSpot, você basicamente associa o app criado com uma conta de desenvolvedor. Para começar a criar seu app da HubSpot:

  • Na sua conta de desenvolvedor de apps, navegue até Apps na barra de navegação principal. 
  • No canto superior direito, clique em Criar app.
  • Em seguida, preencha algumas informações básicas e configurações do app. 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.

Observação: o nome do app será usado sempre que ele for exibido na HubSpot. Isso inclui a instalação do app, bem como o rodapé Fornecido por para cartões CRM e eventos de linha do tempo.

  • Clique na guia Autenticação para visualizar o ID e o segredo do cliente, bem como os escopos atribuídos ao app. Você precisará destas informações para iniciar uma conexão OAuth entre o app e a HubSpot.

  • Na guia Autenticação, clique no menu suspenso Escopos na parte inferior da página para adicionar novos escopos ao app. 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

  • Observe o campo URL de redirecionamento. Os usuários serão direcionados para este local depois que você conceder à conta da HubSpot deles acesso ao app. 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.

Com o seu app criado, agora é possível realizar o processo de instalação.

Instalar um app

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

Observação: antes de instalar seu app, lembre-se do seguinte:

  • Um app não aparecerá na página Apps conectados da conta até os tokens de acesso iniciais e de atualização serem 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 app, crie uma conta de teste em sua conta de desenvolvedor do app e instale-a ali.

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 app.

select_account-1

  • Depois de escolher uma conta, você verá uma lista de escopos com base nos parâmetros &scopes= e &optional_scope= definidos para o URL de autorização.

Observação: se você incluir optional_scope e a conta selecionada não tiver acesso a ele (como o escopo do conteúdo para uma conta somente do CRM), ele não será listado.

  • Clique em 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.

Gerar tokens iniciais do OAuth 

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 e do ID e do segredo do cliente. Você encontrará instruções detalhadas aqui

Próximas etapas

Depois de autorizar o aplicativo e gerar os tokens iniciais, a instalação estará concluída. Ele será listado em sua página Apps conectados e você começará a receber solicitação de busca de webhook e cartões CRM.

connected_apps-1


Recursos relacionados

Ferramentas e contas de desenvolvedores

Contas de teste

Listando o aplicativo