Edición: Exclusivo de Modal COD Form PRO (v5.0+) | Ubicación:
WooCommerce → Ajustes → Modal COD Form → WebhookEl motor de Webhooks Salientes de Modal COD Form PRO v5.0 (includes/woocommerce-extensions/woo-ext-webhook.php) te permite conectar tu tienda WooCommerce en tiempo real con plataformas de automatización como n8n, Make (Integromat), Zapier, Google Sheets o Evolution API / WhatsApp Cloud API sin necesidad de plugins intermedios pesados.
1. Los 4 Eventos de Webhook Disponibles en la Versión 5.0
En WooCommerce → Ajustes → Modal COD Form → Webhook puedes activar de manera independiente hasta 4 endpoints HTTP POST en formato JSON:
Evento (event_type) |
Hook Interno en WordPress | Cuándo se Dispara y Caso de Uso Principal en COD |
|---|---|---|
order_created |
cod_order_finalized y fallback en woocommerce_checkout_order_processed |
Se envía apenas se confirma la orden (con protección de idempotencia _prcod_order_webhook_sent para garantizar un único envío). Ideal para enviar mensaje de confirmación de pedido por WhatsApp y registrar la venta en Google Sheets o CRM. |
abandoned_cart |
cod_cart_abandoned |
Se dispara cuando un carrito capturado en el modal supera el tiempo de inactividad y pasa a estado abandoned. Ideal para enviar un mensaje automático de recuperación por WhatsApp con los productos e ítems de Upsell que el cliente dejó pendientes. |
cart_recovered |
cod_cart_recovered |
Se dispara cuando un cliente con carrito abandonado regresa y completa su compra (incluye el order_id generado). Ideal para detener secuencias de seguimiento en n8n/CRM y medir la tasa de recuperación. |
cart_blocked |
cod_cart_blocked |
Se dispara en el instante en que Prevención de Fraude bloquea un intento de pedido falso (incluye block_reason). Ideal para auditoría de seguridad. |
2. Entrega HTTPS Confiable y Visor de las Últimas 10 Peticiones (Logs)
- Soporte TLS/HTTPS Completo: En la versión 5.0, las peticiones utilizan
wp_remote_post()con'blocking' => true,'timeout' => 10y'httpversion' => '1.1'. Esto evita el problema clásico de WordPress dondeblocking => falsecorta el handshake SSL a los 10 milisegundos en servidores HTTPS externos como Make o n8n, y además registra el código de respuesta HTTP (ej.200 OK) en las notas privadas del pedido. - Visor de Ejemplos JSON y Registro de Entregas (
cod_form_webhook_enable_log): Dentro de la pestaña Webhook encontrarás acordeones desplegables (.cod-webhook-accordion) con ejemplos reales del JSON de cada evento listos para copiar, además de una casilla opcional para activar el Historial de las últimas 10 entregas (prcod_webhook_delivery_logs) con código HTTP, latencia enmsy respuesta del servidor remoto.
3. Cómo Identificar Productos de Upsell (1-Tick y 1-Click) en tu Automatización
Tanto en el webhook de order_created (arreglo products[]) como en abandoned_cart (arreglo cart.items[]), cada ítem incluye dos propiedades booleanas/texto:
"is_upsell": true(cuando es un producto adicional de Upsell) ofalse(cuando es el producto principal)."upsell_type": "one_tick"(agregado en el checkbox/carrusel del formulario) o"one_click"(aceptado en el popup post-submit).
Siguientes Pasos
- 💻 Consulta el esquema JSON completo de los 4 eventos en Esquema y Ejemplos del Payload JSON de Webhooks (Referencia para Desarrolladores).
- 🏗️ Explora la arquitectura interna del plugin en Arquitectura Técnica de Modal COD Form y WooCommerce HPOS.