⚠️ AVISO: Los webhooks están disponibles en los planes Avanzado y Total.
Desde el panel de FacturaDirecta puedes crear endpoints, seleccionar los eventos que te interesan, consultar el historial de envíos y gestionar la seguridad de tus integraciones. Todo sin escribir una línea de código.
Acceder a la configuración
Para gestionar tus webhooks:
Haz clic en ⚙️ Ajustes en el menú principal
Selecciona API e Integraciones > Webhooks
Verás dos pestañas:
Endpoints: listado de tus endpoints configurados
Historial: registro de todos los eventos enviados
Crear un endpoint
Haz clic en "Crear endpoint"
Introduce la URL de tu servidor (debe empezar por
https://)Indica un nombre descriptivo para identificar el endpoint (por ejemplo: "Integración ERP" o "CRM Notificaciones")
Selecciona los eventos que quieres recibir. Puedes usar los botones "TODOS" o "NINGUNO", o elegir eventos individuales agrupados por categoría
Haz clic en "Guardar endpoint"
Al crear el endpoint, se genera automáticamente un signing secret que se muestra en un diálogo. Este secret te permite verificar que las notificaciones provienen de FacturaDirecta.
⚠️ Importante: Guarda el signing secret en un lugar seguro. No se volverá a mostrar. Si lo pierdes, puedes rotar el secret para obtener uno nuevo (el anterior dejará de funcionar).
Gestionar endpoints
En la pestaña "Endpoints" verás un listado con:
Columna | Descripción |
URL | La dirección donde se envían los eventos |
Nombre | Nombre descriptivo del endpoint |
Eventos | Número de eventos suscritos |
Estado | "Activo" o "Desactivado" |
Último envío | Fecha del último evento enviado |
Haz clic en un endpoint para ver su información completa: URL, estado, nombre, lista de eventos suscritos e historial de eventos recientes.
Acciones disponibles
Desde el detalle de un endpoint puedes realizar las siguientes acciones:
Editar: modifica el nombre, la URL o los eventos suscritos
Rotar secret: genera un nuevo signing secret. El anterior deja de funcionar inmediatamente
Enviar prueba: envía un evento simulado
invoice.createdal endpoint para comprobar que tu servidor lo recibe correctamente (solo si el endpoint está activo)Reactivar: vuelve a activar un endpoint que se haya desactivado (solo visible si está desactivado). Al reactivar, se reencolan automáticamente los eventos que fallaron
Desactivar: detiene temporalmente el envío de eventos al endpoint
Eliminar: elimina el endpoint de forma permanente
Historial de eventos
En la pestaña "Historial" puedes consultar todos los eventos enviados, con los siguientes datos:
Tipo: el tipo de evento (ej:
invoice.created)Estado: si se entregó correctamente, falló o está pendiente
Endpoint: a qué endpoint se envió
Fecha: cuándo se produjo el evento
HTTP: el código de respuesta de tu servidor
Haz clic en un evento para ver su detalle completo: tipo, estado, fecha, payload JSON y respuesta HTTP de tu servidor.
Si un evento tiene estado "failed", puedes usar la acción "Reenviar" para reencolarlo y que se intente entregar de nuevo.
Desactivación automática
Si un endpoint acumula 10 fallos consecutivos, FacturaDirecta lo desactiva automáticamente para evitar envíos innecesarios. Recibirás una notificación y podrás reactivarlo en cualquier momento desde el detalle del endpoint.
Además, si tu servidor responde con HTTP 410 Gone, el endpoint se desactiva inmediatamente. Esto es útil cuando ya no necesitas recibir notificaciones en esa URL.
Notas importantes
HTTPS obligatorio: la URL del endpoint debe usar HTTPS. No se aceptan URLs con HTTP
IPs privadas bloqueadas: por seguridad, no se permiten URLs que apunten a direcciones IP privadas (localhost, 127.x.x.x, 10.x.x.x, 192.168.x.x)
Registro de actividad: las acciones sobre endpoints (crear, eliminar, activar, desactivar, rotar secret) quedan registradas en el historial de actividad de tu empresa