Cómo usar webhooks

Actualizado el 23 de septiembre de 2026

Un webhook es un aviso automático: cuando algo ocurre en Rabbiit, el sistema envía el evento a una URL que registraste. El otro sistema (ERP, automatización, data warehouse) reacciona al momento — sin preguntar cada pocos minutos si alguna hora cambió.

En Rabbiit el administrador registra la URL, elige los tipos de evento y sigue cada intento de envío. Solo quien administra la cuenta crea y gestiona webhooks.

💡 Plan: los webhooks en tiempo casi real forman parte de Ultimate. Hay un límite de webhooks activos; los inactivos no ocupan plaza.

Para quién es

Administrador — crea la subscription, elige los eventos, activa o inactiva, y abre el historial cuando la otra punta no recibe.

Operaciones / integración — define la URL de destino y usa el detalle de la entrega (payload, respuesta HTTP, error) para cerrar el diagnóstico.

Gestor y colaborador — en general no entran en esta pantalla. El efecto es indirecto: el sistema que el equipo ya usa se actualiza solo.

Dónde encontrarlo

Pantalla de integraciones, webhooks y API Configuración > Integraciones

En la misma página de la API hay dos pestañas de webhook:

Webhooks — registro, eventos y límite de activos
Entregas de eventos — historial de cada envío

Solo los administradores operan esas pestañas.

Cómo funciona en Rabbiit

Abre Configuración > Integraciones y la pestaña Webhooks.
Haz clic en Nuevo webhook. Indica un nombre que el equipo reconozca dentro de meses (“ERP del cliente X”, “Automatización de facturación”).
Indica la URL de destino — la dirección HTTPS que va a recibir el POST.
Selecciona los tipos de evento. Elige solo lo que esa integración necesita; demasiados eventos se vuelven ruido y costo.
Opcional: indica un token (secret) o déjalo en blanco para que Rabbiit genere uno. Usa ese valor para validar el header X-Signature de las entregas. El secret aparece en la creación; después, si necesitas cambiarlo, usa Generar nuevo secreto (el anterior deja de valer al momento).
Guarda. Rabbiit dispara un POST a la URL siempre que uno de los eventos elegidos ocurre en la cuenta.

Cada webhook puede activarse o inactivarse. Inactivar no borra el registro y no cuenta en el límite de activos. Se pueden editar eventos y URL, o eliminar cuando la integración termina.

Usa webhook cuando el otro sistema necesita reaccionar (crear factura, actualizar hoja, disparar un flujo). Para tirar datos bajo consulta, usa la API y los tokens de acceso.

Eventos disponibles

Al registrar el webhook eliges uno o más tipos. El código (project.created, time_entry.updated, etc.) es lo que llega en el payload y lo que aparece en el historial.

Proyecto

project.created — proyecto creado
project.updated — proyecto actualizado
project.deleted — proyecto eliminado

Cliente

customer.created — cliente creado
customer.updated — cliente actualizado
customer.deleted — cliente eliminado

Tarifa

rate.created — tarifa creada
rate.updated — tarifa actualizada
rate.deleted — tarifa eliminada

Usuario

user.created — usuario creado
user.updated — usuario actualizado
user.deleted — usuario eliminado

Tarea

task.created — tarea creada
task.updated — tarea actualizada
task.deleted — tarea eliminada

Equipo

team.created — equipo creado
team.updated — equipo actualizado
team.deleted — equipo eliminado

Miembro de equipo

team_user.created — usuario añadido a un equipo
team_user.deleted — usuario quitado de un equipo

Miembro de proyecto

project_user.created — usuario añadido a un proyecto
project_user.updated — la asignación del usuario en el proyecto cambió
project_user.deleted — usuario quitado de un proyecto

Tarea del proyecto

project_task.created — tarea vinculada al proyecto
project_task.updated — el vínculo de la tarea en el proyecto cambió
project_task.deleted — tarea desvinculada del proyecto

Registro de horas

time_entry.created — registro creado
time_entry.updated — registro actualizado
time_entry.deleted — registro eliminado
time_entry.timer_started — timer iniciado
time_entry.timer_stopped — timer detenido

Lista de to-dos

todo_list.created — lista creada
todo_list.updated — lista actualizada
todo_list.deleted — lista eliminada
todo_list.restored — lista restaurada

To-do

todo.created — to-do creado
todo.updated — to-do actualizado
todo.deleted — to-do eliminado
todo.restored — to-do restaurado

Aprobación de horas

timesheet_approval.created — aprobación de horas creada (envío de la semana)
timesheet_approval.update — aprobación de horas actualizada (aprobación, rechazo u otro cambio de estado)

Seguir las entregas

En la pestaña Entregas de eventos el administrador ve cada intento de envío:

Evento — el tipo disparado
Estado — Pendiente, Entregado, Falló o Reintentando
HTTP — código de respuesta del destino
Intentos y próximo intento — cuándo Rabbiit vuelve a intentar tras un fallo
Creado el — fecha del disparo

Los filtros por estado y por tipo de evento ayudan a encontrar el fallo. En Ver detalles se abren el payload enviado, el cuerpo de la respuesta y el mensaje de error — sin tener que adivinar si la URL cayó, si la autenticación rechazó o si hubo timeout.

Si la cuenta no integra con nada, ignora estas pestañas. Enviar y aprobar la semana y los informes resuelven el día a día sin webhook.