Para compartilhar dados do ClickUp com aplicativos externos, você pode usar dois tipos de webhooks no ClickUp:
- Webhooks criados através da API Pública do ClickUp.
- Webhooks acionados por Automatizações.
A disponibilidade e os limites de recursos variam de acordo com o plano e o papel do usuário. Saiba mais
Webhooks da API
Você deve usar webhooks da API quando quiser rastrear amplamente todos os eventos de criação, atualização e exclusão de tarefas, Listas, Pastas, Espaços, Metas e Alvos.
Saiba mais sobre os webhooks da API do ClickUp, incluindo:
- Veja exemplos de payloads.
- Revise a especificação para os endpoints de webhook da API Pública do ClickUp.
- Envie sua primeira solicitação de Criar webhook diretamente do seu navegador.
Webhooks de Automatização
Você deve usar webhooks de Automatizações quando quiser controle total sobre os Gatilhos e Condições que enviam seus dados para aplicativos externos.
Existem dois tipos de webhooks de Automatização que você pode criar no ClickUp:
- Webhooks de tarefa: Envie dados quando as tarefas forem atualizadas.
- Webhooks de chat: Envie dados quando mensagens de chat forem postadas.
Criar um webhook
Você precisará criar um webhook para cada destino que receberá dados do ClickUp das Automatizações.
Você pode reutilizar webhooks que criou nas Automatizações em todo o seu Workspace, mas precisará configurar webhooks separados para Automatizações de Tarefa e de Chat.
Certifique-se de testar seu webhook antes de adicioná-lo a Automatizações que enviarão dados reais.
Use variáveis dinâmicas no seu Webhook
Variáveis dinâmicas na URL podem ajudar seu aplicativo a processar eficientemente os dados que recebe do ClickUp.
Você pode usar variáveis dinâmicas na URL do seu webhook, como o ID da tarefa.
Use cabeçalhos
Cabeçalhos podem incluir metadados que permitem que seu aplicativo processe os payloads de webhook recebidos de forma segura e precisa. Por padrão, o ClickUp inclui o seguinte cabeçalho:
Content-type: application/json
Use parâmetros de URL
Você também pode definir parâmetros de URL para cada webhook para ajudar seu aplicativo a processar os dados com precisão.
Ao contrário das variáveis dinâmicas, os parâmetros de URL são estáticos. Os valores não mudarão toda vez que sua Automatização for acionada.
Testar webhooks
Quando você começa a usar webhooks, recomendamos testar seus webhooks antes de enviar dados reais do seu Workspace do ClickUp.
Você pode encontrar e usar ferramentas gratuitas online para testar e experimentar com webhooks. Por exemplo, você pode usar webhook.site para gerar uma URL de webhook e ver os payloads de webhook enviados do ClickUp.
Para webhooks da API:
- Filtre seu primeiro webhook para eventos específicos, como taskCreated e taskUpdated.
- Filtre seu primeiro webhook para um local específico, como uma Lista dedicada que contém apenas tarefas de teste com dados genéricos, mas representativos.
Para webhooks de Automatização:
- Aplique Gatilhos e Condições precisos, como um Campo Personalizado de caixa de seleção para controlar quando os dados são enviados.
- Adicione a Automatização a uma Lista ou Canal específico primeiro, com tarefas e mensagens genéricas, mas representativas.
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 →
