Quer criar um aplicativo que se integre ao ClickUp? Dê aos seus usuários a capacidade de fazer login usando OAuth 2.0!
Certifique-se de também conferir nossa documentação da API!
O que você precisará
- A API do ClickUp está disponível em todos os planos do ClickUp.
- Os proprietários ou administradores do Workspace podem gerenciar as configurações de integração e criar aplicativos OAuth no Workspace.
- Membros e membros limitados com permissões de edição completas podem usar tokens de API pessoais.
- Membros limitados com permissões somente de visualização não podem acessar ou gerenciar a API.
Fluxo OAuth 2
Quando você deseja desenvolver uma aplicação que outros possam usar, deve usar um fluxo de autenticação OAuth2.
Com OAuth 2, todos que usam seu aplicativo recebem um token individualizado. Cada usuário pode acessar apenas o conteúdo disponível para sua conta de usuário ClickUp individual.
Se você não estiver familiarizado com OAuth2, a Digital Ocean preparou um ótimo guia que deve ajudá-lo a começar. Também recomendamos conferir o site do OAuth para mais detalhes.
Criar um aplicativo
O primeiro passo para usar OAuth 2 é criar um aplicativo em seu Workspace. Você deve ser um proprietário ou administrador do Workspace para gerenciar as configurações de integração.
Para criar um aplicativo em seu Workspace:
- No canto superior esquerdo, clique no seu avatar do Workspace.
- Selecione Configurações.
- Na barra lateral de Todas as configurações, selecione API do ClickUp.
-
No canto superior direito da página de Configurações da API do ClickUp, clique em Criar um Aplicativo.
- Digite o nome do seu aplicativo e uma URL(s) de redirecionamento.
Se você não tiver certeza do que usar como sua URL de redirecionamento, dê uma olhada no guia de URLs de Redirecionamento no site do OAuth. - Clique em Criar Aplicativo.
- Na próxima tela, você verá que um ID do Cliente e um Segredo do Cliente foram gerados.
- Use o ID do Cliente e o Segredo do Cliente em seu aplicativo para criar um fluxo de autenticação OAuth 2.
Atualize suas redirecionar URLs
Se você tiver uma nova URL de redirecionamento, pode atualizar essas configurações em seu Workspace ClickUp a qualquer momento:
- No canto superior esquerdo, clique no seu avatar do Workspace.
- Selecione Configurações.
- Na barra lateral de Todas as configurações, selecione API do ClickUp.
- Clique em um aplicativo existente para expandir seus detalhes.
- Atualize a URL de redirecionamento.
- Clique em Salvar.
Visualizar ou regenerar seu segredo do cliente
Para regenerar seu segredo do cliente:
- No canto superior esquerdo, clique no seu avatar do Workspace.
- Selecione Configurações.
- Na barra lateral de Todas as configurações, selecione API do ClickUp.
- Clique em um aplicativo existente para expandir seus detalhes.
- Clique em Mostrar para visualizar seu Segredo do Cliente atual.
- Clique em Regenerar para criar um novo Segredo do Cliente.
- Atualize seu aplicativo para usar o novo Segredo do Cliente.
Tipos de tokens de autorização
Tokens permitem que você faça chamadas à API e se integre a outros aplicativos. Você também pode usar aplicativos como Make para criar integrações sem escrever código. Tokens são específicos para sua conta de usuário ClickUp.
Qualquer pessoa com uma conta ClickUp pode gerar um token pessoal. Tokens pessoais permitem acesso a todos os Workspaces que sua conta criou ou participou. Seu token pessoal lhe dá o mesmo acesso que você tem através de um navegador web.
Se você usar OAuth2, pode optar por autorizar o acesso a Workspaces específicos quando autenticar pela primeira vez ou quando re-autenticar mais tarde.
Ainda precisa de assistência? Acesse o suporte do ClickUp.
Sabia que a Audatia é parceira oficial do ClickUp no Brasil? Ajudamos times a extrair o máximo da ferramenta com consultoria especializada e revenda. Conheça nossos serviços →
