Integrar WhatsApp com ClickUp

Passo a passo

1. 1

   Crie sua instancia de WhatsApp na ZapZap API

   Acesse o painel em app.zapzapapi.com, crie uma instancia e leia o QR Code com o celular que enviara as mensagens. Guarde o instanceId, a x-api-key e o x-api-secret da conta. Cada numero ativo custa R$15 por mes no modelo pre-pago e voce comeca com credito gratis para testar.

2. 2

   Monte um endpoint intermediario para receber o webhook

   O ClickUp dispara webhooks em formato proprio. Crie um endpoint simples (por exemplo em uma function serverless ou n8n) que recebe o payload do ClickUp, extrai o nome e o status da tarefa e depois chama a ZapZap API com seus cabecalhos x-api-key e x-api-secret.

3. 3

   Abra as Automations no ClickUp

   Dentro de uma Space, Folder ou List, clique no botao Automate no canto superior direito e escolha Create Automation. Voce tambem pode gerenciar tudo em Settings e depois Automations.

4. 4

   Configure o gatilho e a acao Call webhook

   Em When (gatilho) escolha algo como Status changes ou Due date arrives. Em Then (acao) selecione Call webhook, cole a URL do seu endpoint intermediario e salve. A cada evento, o ClickUp enviara os dados da tarefa para essa URL.

5. 5

   Teste e ative em producao

   Mova uma tarefa de teste para o status configurado e confirme que a mensagem chega no WhatsApp. Ajuste o texto no seu endpoint e replique a Automation para outros status ou Lists conforme a necessidade do time.

// Exemplo ILUSTRATIVO. Confira os campos reais em https://api.zapzapapi.com/llms.txt
// Chamada feita pelo seu endpoint intermediario apos receber o webhook do ClickUp
const res = await fetch(
  "https://api.zapzapapi.com/api/v1/{instanceId}/send/text",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.ZAPZAP_API_KEY,
      "x-api-secret": process.env.ZAPZAP_API_SECRET,
    },
    body: JSON.stringify({
      number: "5511999999999",
      text: "Tarefa mudou de status no ClickUp: revise quando puder.",
    }),
  }
);