Criar uma Automação de Webhook de Chat

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 →