Automatización de tareas
Integra WhatsApp con ClickUp
ClickUp es una plataforma de gestión de tareas y proyectos donde los equipos organizan el trabajo en Spaces, Folders, Lists y tareas con estados, plazos y responsables. Incluye un motor de Automations y soporte para webhooks que permite reaccionar a eventos de tareas en tiempo real. La idea de esta integración es conectar esos eventos con WhatsApp usando ZapZap API, una API de WhatsApp no oficial basada en instancias. Así, cada cambio relevante en tu tablero puede convertirse en un mensaje automático al WhatsApp del equipo o del cliente, sin que nadie tenga que mirar el panel todo el tiempo.
Por qué conectar
Una agencia gestiona las entregas de sus clientes en ClickUp. Cada vez que una tarea entra al estado "Aprobación del cliente", una Automation llama a un webhook que envía por ZapZap API un mensaje al WhatsApp del cliente avisando que hay algo para revisar. Cuando la tarea cambia a "Completado", el gerente del proyecto recibe por WhatsApp una confirmación con el nombre de la tarea. Las tareas que pasan del plazo también disparan una alerta en el grupo de operaciones. El resultado es menos cobranza manual, respuestas más rápidas de los clientes y un equipo que conoce el avance sin abrir ClickUp.
Paso a paso
- 1
Crea tu instancia de WhatsApp en ZapZap API
Entra al panel en app.zapzapapi.com, crea una instancia y lee el QR Code con el celular que enviará los mensajes. Guarda el instanceId, la x-api-key y la x-api-secret de la cuenta. Cada número activo cuesta R$15 al mes en el modelo prepago y empiezas con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.
- 2
Arma un endpoint intermedio para recibir el webhook
ClickUp dispara webhooks en su propio formato. Crea un endpoint simple (por ejemplo en una función serverless o n8n) que reciba el payload de ClickUp, extraiga el nombre y el estado de la tarea y luego llame a ZapZap API con tus headers x-api-key y x-api-secret.
- 3
Abre las Automations en ClickUp
Dentro de un Space, Folder o List, haz clic en el botón Automate en la esquina superior derecha y elige Create Automation. También puedes gestionar todo en Settings y luego Automations.
- 4
Configura el disparador y la acción Call webhook
En When (disparador) elige algo como Status changes o Due date arrives. En Then (acción) selecciona Call webhook, pega la URL de tu endpoint intermedio y guarda. En cada evento, ClickUp enviará los datos de la tarea a esa URL.
- 5
Prueba y activa en producción
Mueve una tarea de prueba al estado configurado y confirma que el mensaje llega a WhatsApp. Ajusta el texto en tu endpoint y replica la Automation para otros estados o Lists según la necesidad del equipo.
Ejemplo
// Ejemplo ILUSTRATIVO. Consulta los campos reales en https://api.zapzapapi.com/llms.txt
// Llamada hecha por tu endpoint intermedio después de recibir el webhook de 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: "Una tarea cambió de estado en ClickUp: revísala cuando puedas.",
}),
}
);
Ilustrativo. Los campos y endpoints exactos están en la documentación.
Preguntas frecuentes
¿Necesito la API oficial de WhatsApp para integrar con ClickUp?
No. ZapZap API funciona con instancias de WhatsApp no oficiales. Lees un QR Code con el número que enviará los mensajes y ya puedes disparar a partir de los eventos de ClickUp, sin proceso de aprobación de Meta.
¿ClickUp puede llamar a ZapZap API directamente?
Lo recomendado es usar un endpoint intermedio. La acción Call webhook de ClickUp envía el payload en su propio formato, así que un pequeño servicio traduce esos datos y hace la llamada final a ZapZap API con los headers x-api-key y x-api-secret.
¿Qué eventos de ClickUp puedo usar como disparador?
Las Automations de ClickUp cubren cambio de estado, plazo próximo o vencido, cambio de responsable, creación de tareas, comentarios y más. Cualquiera de ellos puede convertirse en un mensaje de WhatsApp.
¿Cuánto cuesta mantener esta automatización funcionando?
Por parte de ZapZap API, el costo es de R$15 por número activo al mes, en el modelo prepago, con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente. ClickUp se cobra aparte según su plan, y las Automations tienen límites por plan.
¿Cómo conozco el endpoint y el formato exacto de envío de ZapZap API?
Consulta la referencia siempre actualizada en https://api.zapzapapi.com/llms.txt. Ahí están las rutas, los headers y los campos correctos para enviar texto, medios y otros tipos de mensaje.
Empieza ahora
Crea tu cuenta, conecta un número en minutos y prueba la API con calentamiento y anti-bloqueo. R$15 por número activo/mes, prepago, sin permanencia.
