# Webhooks: pedidos en el momento ## ¿Por qué usar webhooks? La sincronización automática revisa la tienda **cada 10 minutos**. En ese lapso el stock del local puede no reflejar una venta web recién hecha. Un **webhook** es un aviso que **la tienda le manda al sistema en el instante** en que se crea, actualiza, elimina o restaura un pedido: la venta aparece en segundos y el stock queda exacto. Es opcional pero **muy recomendado** para tiendas con movimiento. El **Webhook Secret** es una contraseña compartida: el sistema solo acepta avisos firmados con ella, así nadie puede "inventar" pedidos. ## Paso 1 — Copiar las URL del sistema 1. **Woocommerce → Configuraciones API → Configuración de Webhook**. 2. Vas a ver cuatro bloques: **Orden creada**, **Orden actualizada**, **Orden eliminada**, **Orden restaurada**, cada uno con su **URL de entrega de Webhook**. 3. Inventá un **Webhook Secret** para cada uno (una clave larga cualquiera, puede ser la misma para los cuatro) y escribila en su casilla. 4. Guardá con **update**. ![Configuración de Webhook: secretos y URL de entrega](/uploads/manual/woo/woo-07-webhooks.jpg) ## Paso 2 — Crear los webhooks en WordPress 1. WordPress → **WooCommerce → Ajustes → Avanzado → Webhooks → Añadir webhook**. 2. Para **cada uno** de los cuatro eventos: | Campo en WordPress | Valor | |---|---| | Nombre | Ej. *Sistema – pedido creado* | | Estado | **Activo** | | Tema | *Pedido creado* / *Pedido actualizado* / *Pedido eliminado* / *Pedido restaurado* | | URL de entrega | La **URL de entrega** correspondiente que copiaste del sistema | | Secreto | El **mismo Webhook Secret** que pusiste en el sistema para ese evento | | Versión de la API | WP REST API Integration v3 | 3. **Guardar webhook**. ## Paso 3 — Probar 1. Hacé un pedido de prueba en la tienda. 2. En el sistema, **Ventas → Todas las ventas**: la venta debería aparecer en segundos. 3. En **Woocommerce → Registro de sincronización** aparece una línea *Pedidos – Creado*. ## Errores comunes / qué revisar - **El pedido no llega al instante** pero sí a los 10 minutos → el webhook no está activo o el secreto no coincide. En WordPress, dentro del webhook, revisá el log de entregas (debe responder 200). - **WordPress desactivó el webhook** → WooCommerce lo desactiva solo tras varios fallos seguidos. Corregí el problema y volvé a ponerlo en *Activo*. - **Cambiaste el secreto en un lado y no en el otro** → tienen que ser idénticos.