Utilizar webhooks para conectar WorkZen
Ve a Configuración > Integraciones > Webhooks, haz clic en Agregar Webhook, ingresa la URL de tu punto de conexión y elige los eventos a los que deseas suscribirte. WorkZen luego envía una solicitud HTTP POST firmada a tu URL en tiempo real cada vez que ocurren esos eventos, con reintentos automáticos y un registro de entregas.
Los webhooks son la forma en que WorkZen se comunica con el resto de tu ecosistema en tiempo real: llega un prospecto y tu canal de Slack recibe un aviso, se paga una factura y tu hoja de cálculo se actualiza, todo mediante Zapier, Make o tu propio código, sin necesidad de sondeos periódicos.
Crear un webhook
- Ve a Configuración > Integraciones > Webhooks (requiere el permiso Administrar integraciones).
- Haz clic en Agregar Webhook.
- Ingresa la URL del punto de conexión que debe recibir los eventos, y opcionalmente una descripción ("Hook de Zapier producción").
- En Eventos suscritos, elige eventos individuales o selecciona categorías completas.
- Haz clic en Crear Webhook, y luego copia la Clave de firma que se muestra.
Haz clic en Enviar prueba en el nuevo punto de conexión para disparar un evento de prueba y confirmar que tu receptor responde.
Eventos disponibles
| Categoría | Eventos |
|---|---|
| Prospectos | lead.created, lead.status_changed, lead.converted |
| Clientes | client.created |
| Trabajos | job.created, job.status_changed, job.completed |
| Presupuestos | estimate.created, estimate.sent, estimate.accepted, estimate.declined |
| Facturas | invoice.created, invoice.sent, invoice.paid, invoice.overdue |
| Pagos | payment.received |
Cada entrega es una solicitud HTTP POST con una carga útil JSON que describe el evento y el registro al que se refiere.
Verificar la firma
Cada entrega incluye un encabezado X-WorkZen-Signature:
X-WorkZen-Signature: sha256=<hex digest>Es un HMAC-SHA256 del cuerpo bruto de la solicitud, usando la clave de firma de tu punto de conexión. Vuelve a calcularlo de tu lado y compáralo antes de confiar en la carga útil. Rotar clave genera una nueva clave cada vez que la necesites; actualiza tu receptor al mismo tiempo, ya que las firmas con la clave anterior dejan de coincidir de inmediato.
Trata la clave de firma como una contraseña. Cualquiera que la tenga puede falsificar eventos que pasen tu verificación.
Entrega, reintentos y el registro
- Reintentos: una entrega fallida se reintenta hasta 4 intentos en total, con retrasos crecientes (10 segundos, 1 minuto, 10 minutos).
- Desactivación automática: después de 10 fallos consecutivos, el punto de conexión se desactiva y recibes una notificación, así que corrige el receptor y vuelve a ponerlo en Activo.
- Registro de entregas: cada punto de conexión mantiene un registro de las entregas recientes con la carga útil completa, el estado de la respuesta y un botón de reintento manual, lo que hace que depurar un receptor con problemas sea refrescantemente sencillo.
Zapier y Make
Ambos funcionan sin configuración adicional: crea allí un disparador "catch webhook", pega la URL que te proporciona en un webhook de WorkZen y suscríbete a los eventos que te interesan. A partir de ahí, tu plataforma de automatización se encarga del resto.
Paso a paso
- 1
Crea el punto de conexión
Ve a Configuración > Integraciones > Webhooks, haz clic en Agregar Webhook e ingresa la URL que debe recibir los eventos.
- 2
Elige tus eventos
Suscríbete a eventos individuales o a categorías completas (prospectos, clientes, trabajos, presupuestos, facturas, pagos).
- 3
Guarda la clave de firma
Copia la clave de firma que se muestra después de la creación y úsala para verificar el encabezado X-WorkZen-Signature en cada entrega.
- 4
Envía una prueba
Haz clic en Enviar prueba para disparar un evento de prueba hacia tu punto de conexión y confirmar que responde correctamente.
Frequently Asked Questions
Este artículo responde:
- ¿WorkZen tiene webhooks?
- ¿Cómo conecto WorkZen con Zapier o Make?
- ¿Cómo verifico la firma de un webhook de WorkZen?
- ¿Por qué mi webhook dejó de recibir eventos?