Saltar al contenido

Recibir avisos con webhooks

Envíe un mensaje firmado a otra aplicación cada vez que se emite una factura, se contabiliza un pago, el stock baja y más.

5 min de lectura Pantallas reales, datos de ejemplo ficticios Actualizado el 22 octubre 2026

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.

  1. Paso 1: Añadir un endpoint

    En Administración → Configuración → API y webhooks, en Webhooks, haga clic en Añadir endpoint.

  2. Paso 2: Introducir la dirección

    Complete la URL del endpoint (debe ser una dirección pública https://) y una Descripción opcional.

  3. Paso 3: Elegir los eventos

    En Eventos, marque los que necesite, o Todos los eventos, incluidos los que se añadan después.

  4. 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.

  5. 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.

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
Chatear con la IA