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
- Ve a Tienda online › Ajustes de la tienda online y abre Webhooks.
- Pulsa Nuevo webhook, ponle un Nombre y la URL de destino.
- Marca los Eventos: pedido nuevo, pedido pagado, pedido cancelado, producto cambiado, stock cambiado (agrupado por minuto) y cliente nuevo (solo id y email).
- Pulsa Crear webhook y copia el secreto de firma: no se volverá a mostrar.
- 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.