Saltar al contenido

Cómo recibir avisos de la tienda online con webhooks

Crea un webhook para que BizQ avise a tu servidor, con una llamada firmada, cuando entra o se paga un pedido, cambia un producto o su stock, o se da de alta un cliente.

Los webhooks sirven para que otro sistema (tu web, tu ERP o una automatización) se entere al momento de lo que pasa en tu tienda online, sin tener que preguntar cada poco.

Crear un webhook

  1. Ve a Tienda online › Ajustes de la tienda online y abre Webhooks.
  2. Pulsa Nuevo webhook, ponle un Nombre y la URL de destino.
  3. Marca los Eventos: pedido nuevo, pedido pagado, pedido cancelado, producto cambiado, stock cambiado (agrupado por minuto) y cliente nuevo (solo id y email).
  4. Pulsa Crear webhook y copia el secreto de firma: no se volverá a mostrar.
  5. Pulsa Enviar prueba para comprobar que tu servidor responde.

Comprobar la firma

Cada aviso lleva las cabeceras X-Bizq-Timestamp y X-Bizq-Signature (v1= + HMAC-SHA256 del secreto sobre la marca de tiempo, un punto y el cuerpo). Calcula la firma con el cuerpo tal cual llega y rechaza las marcas de más de 5 minutos.

Ten en cuenta

  • Solo se admiten URL https con dirección pública; no se siguen redirecciones y BizQ espera la respuesta 5 segundos como mucho.
  • Si la entrega falla, se reintenta durante 24 horas. Tras 5 días seguidos fallando, el webhook se desactiva solo; revisa el destino y vuelve a activarlo.
  • En Entregas ves cada envío, su respuesta y el cuerpo enviado.
  • Si pierdes el secreto, usa Rotar secreto: el anterior deja de firmar al momento.
  • Hay un máximo de 10 webhooks por tienda. Hace falta el permiso para cambiar los ajustes de la tienda online.
Volver al centro de ayuda