En esta página
Un webhook es un mensaje que enviamos mediante POST a la dirección de su aplicación cuando ocurre algo en su empresa, para que la otra aplicación no tenga que estar preguntando continuamente.
-
Paso 1: Añadir un endpoint
En Administración → Configuración → API y webhooks, en Webhooks, haga clic en Añadir endpoint.
-
Paso 2: Introducir la dirección
Complete la URL del endpoint (debe ser una dirección pública https://) y una Descripción opcional.
-
Paso 3: Elegir los eventos
En Eventos, marque los que necesite, o Todos los eventos, incluidos los que se añadan después.
-
Paso 4: Copiar el secreto de firma
Después de guardar, el Secreto de firma se muestra una sola vez. Cópielo en la aplicación receptora para que pueda comprobar que cada mensaje procede realmente de nosotros.
-
Paso 5: Probarlo
Haga clic en Enviar evento de prueba y revise el Registro de entregas.
Eventos disponibles
- Contactos: se creó o actualizó un contacto.
- Facturas: emitida, pagada por completo, anulada. Cotizaciones: aceptada.
- Pagos: se contabilizó un pago o un cobro.
- Facturas de proveedor: recibida (contabilizada), pagada por completo. Gastos: se registró un gasto.
- Stock: un artículo bajó hasta su nivel de reorden o por debajo.
- Ausencias: se creó una solicitud de ausencia.
Entregas y reintentos
- Su aplicación debe responder con un estado 2xx en 10 segundos. Cualquier otra cosa cuenta como fallo.
- Las entregas fallidas se reintentan automáticamente, hasta seis intentos a lo largo de varias horas, con esperas cada vez más largas.
- Abra un endpoint con Gestionar para ver el Registro de entregas: cada evento con su Carga útil, la Respuesta de su servidor y un estado Entregado, Fallido o Pendiente. Haga clic en Reenviar para enviar uno de nuevo.
- Desmarque Enviar eventos a este endpoint para pausarlo, o haga clic en Quitar para eliminarlo. Un endpoint que sigue fallando durante mucho tiempo se desactiva automáticamente.
Verificar la firma
Cada entrega lleva la cabecera X-Webhook-Signature: t=<timestamp>,v1=<signature>. Calcule el HMAC-SHA256 de “<timestamp>.<raw body>” con su secreto de firma y compárelo con v1; rechace las marcas de tiempo de más de 5 minutos. X-Webhook-Id se mantiene igual en los reintentos, así que úselo para ignorar duplicados.
Guías relacionadas
Pregunte sobre el producto
Pregunte qué puede hacer el software, cómo funciona una tarea o qué países e idiomas admite. Las respuestas proceden de estas guías.
Pensando…
El asistente de IA no está disponible en este momento. Busque en las guías o hable con nuestro equipo. Contactar con soporte
La IA puede cometer errores. Consulte las guías enlazadas.
¿Todavía necesita ayuda?
Nuestro equipo de soporte lee cada mensaje y responde en un lenguaje claro.
Contactar con soporte