Crie uma Automação de webhook de Chat para se comunicar com um aplicativo integrado externo quando um evento específico ocorrer no ClickUp. Por exemplo, quando uma mensagem de Chat é postada em um Canal específico, ela também é postada automaticamente no Zapier ou Make.

Você também pode usar webhooks com Automação de tarefas.

A disponibilidade e os limites de recursos variam de acordo com o plano e o papel do usuário. Saiba mais

Use Gatilhos, Ações, cabeçalhos de URL e parâmetros de Automação

Gatilhos são eventos que iniciam uma Automação.

Mensagem é postada é o único Gatilho de webhook de Chat.

Ações são os eventos que a Automação inicia após ser acionada. Para chamar um webhook, use a Ação Chamar webhook.

Use cabeçalhos de URL e parâmetros para definir detalhes sobre o webhook, por exemplo:

• A localização do ClickUp de onde o webhook é enviado
• A URL do aplicativo externo
• Ou o tipo de mídia do corpo da solicitação

Os cabeçalhos de URL são sensíveis. Uma vez salvos, você não pode visualizar os valores dos cabeçalhos para editá-los.

Crie uma Automação de webhook de Chat

Para criar uma Automação de webhook de Chat, a partir de um canal:

1. No canto superior direito, clique no botão Automatizar ou no ícone de raio.
2. Clique em Criar Automação.
3. Configure seu Gatilho, Condições e Ações:
   1. Selecione a Ação Chamar webhook .
   2. Selecione um webhook existente ou Criar webhook:
      1. Dê um nome ao seu webhook e uma descrição opcional.
      2. Insira a URL do seu webhook.
      3. Selecione os seguintes campos dinâmicos para incluí-los na URL.
         • ID do Comentário: Adicione o ID do comentário individual do Chat.
         • ID do Canal: Adicione o ID do Canal de Chat.
      4. Adicione cabeçalhos personalizados opcionais:
         • Clique em Adicionar, depois insira uma chave e um valor.
           • Por padrão, os cabeçalhos do webhook incluem Content-type=application/json.
      5. Adicione parâmetros de URL personalizados opcionais:
         • Insira uma chave e um valor para adicionar parâmetros de URL personalizados.
         • Clique em Adicionar para adicionar mais pares de chave e valor.
4. Clique em Criar webhook.

Teste uma Automação de webhook de Chat

Após criar o webhook, você pode testá-lo a partir do ClickUp.

Para testar uma Automação de webhook de Chat:

1. Logo após criar o webhook, no canto superior esquerdo do modal de Automação, clique na seta para baixo.
   Ou, a partir de um canal:
   1. Clique no botão Automatizar ou no ícone de raio .
   2. Selecione Gerenciar Automação de Chat.
   3. Clique na aba Webhooks .
2. Passe o mouse sobre o webhook e clique em Testar.
   • Uma mensagem será exibida informando sucesso ou falha.

Se o teste falhar

Você pode verificar se o aplicativo externo está operacional. Se estiver fora do ar, podemos bloquear a chamada do webhook por motivos de segurança.

Se o teste for bem-sucedido

Se o teste for bem-sucedido, você pode ativar o webhook de Chat em uma Automação.

Crie uma Automação de chat com um webhook existente

Após testar o webhook de Chat, você o tornará ativo em seu Workspace.

Para ativar o webhook de Chat:

1. Logo após testar o webhook, no modal de Automação, selecione a aba Gerenciar .
2. Clique em Adicionar Automação.
3. Configure seu Gatilho, Condições e Ações:
   1. Selecione a Ação Chamar webhook .
   2. Selecione seu webhook.
4. Clique em Criar.

Chamada de webhook falhada

Se o seu webhook estiver ativo e uma chamada de webhook falhar inicialmente, nós tentamos novamente por 1 hora e 15 minutos. Durante esse tempo, a chamada será exibida na sua aba de Atividade de Automação com status pendente.

Desative o webhook de Chat

Após o webhook de Chat ser ativado, você pode torná-lo inativo.

Para desativar o webhook de Chat, a partir de um canal:

1. Clique no botão Automatizar ou no ícone de raio .
2. Selecione Gerenciar Automação de Chat.
3. Clique na aba Webhooks .
4. À direita do seu webhook, clique no botão para desativá-lo.
5. Revise o aviso de que as Automação que usam o webhook também serão desativadas.
6. Clique em Desativar.
7. O webhook de Chat agora é exibido na aba Inativo.

Para reativar o webhook de Chat, abra a aba Inativo e clique no botão para ativá-lo.

Chaves e valores de cabeçalho

A seguir estão os cabeçalhos que fornecemos e algumas diretrizes sobre como criar cabeçalhos personalizados:

Precisa de mais ajuda? O suporte do ClickUp está à disposição.

E se você busca otimizar o uso do ClickUp no seu time, a Audatia (parceira oficial no Brasil) tem especialistas prontos para ajudar com consultoria e treinamentos. Fale com um consultor →