El motor de Webhooks de Modal COD Form PRO (PRCOD_Webhooks_Handler) permite disparar cargas JSON enriquecidas en tiempo real hacia n8n, Make (Integromat), Zapier o tu propio microservicio en Node.js/Python cada vez que ocurre uno de los 4 eventos clave del ciclo de vida contraentrega.
En este recetario técnico encontrarás arquitecturas listas para producción para automatizar la confirmación de pedidos por WhatsApp, construir secuencias de recuperación de carritos con cancelación inteligente y recibir alertas antifraude.
1. Resumen de los 4 Eventos y sus Hooks Internos
Evento JSON (event) |
Opción de URL en Base de Datos | Hooks Internos que lo Disparan | Uso Principal en Automatización |
|---|---|---|---|
order_created |
cod_form_webhook_order_created |
cod_order_finalized (Modal COD) + woocommerce_checkout_order_processed (Botón Secundario) |
Confirmación inmediata por WhatsApp (Evolution API / Cloud API), sincronización con Google Sheets o CRM. |
abandoned_cart |
cod_form_webhook_abandoned_cart |
cod_cart_abandoned (CRON tras cod_form_abandonment_time minutos de inactividad) |
Iniciar flujo de rescate por WhatsApp o llamada de call center con enlace de recuperación 1 clic. |
cart_recovered |
cod_form_webhook_cart_recovered |
cod_cart_recovered (Disparado al crear orden que coincide por session_id, email o phone) |
Cancelar secuencias pendientes de WhatsApp para no enviar recordatorios a quien ya compró, y medir ROI. |
cart_blocked |
cod_form_webhook_cart_blocked |
cod_cart_blocked (Disparado por PRCOD_Fraud_Prevention_Validator) |
Alertar en Slack/Telegram sobre ataques de bots o clientes reincidentes bloqueados. |
2. Candado de Idempotencia en order_created (_prcod_order_webhook_sent)
Una ventaja arquitectónica de PRCOD_Webhooks_Handler es que cubre tanto los pedidos creados directamente en el modal COD como aquellos que el cliente finaliza a través del Botón Secundario de Pago Anticipado (que redirige al checkout nativo de WooCommerce).
- Cuando el pedido se crea en el modal, se dispara
cod_order_finalized, se envía el webhookorder_createdy se guarda el metadato_prcod_order_webhook_sent = 'yes'en la orden (compatible con HPOS). - Si el pedido se completa en el checkout nativo de WooCommerce (tras haber pasado por el modal con metadatos como
_cod_applied_discountso ítems con_cod_is_upsell), el hook de respaldowoocommerce_checkout_order_processedverifica primero si_prcod_order_webhook_sent === 'yes'. De este modo, se garantiza entrega única (idempotencia) sin duplicar webhooks jamás.
3. Receta 1: Flujo en n8n para Confirmar Pedidos COD por WhatsApp Diferenciando Upsells
En el payload de order_created (ver Referencia del Payload JSON), cada elemento dentro de products[] incluye los campos booleanos y de modalidad de upsell:
{
"product_id": 412,
"variation_id": 415,
"name": "Reloj Inteligente Pro - Negro",
"quantity": 1,
"price": 129900,
"subtotal": 129900,
"total": 129900,
"sku": "REL-PRO-BLK",
"is_upsell": false,
"upsell_type": ""
},
{
"product_id": 890,
"variation_id": 0,
"name": "Correa Metálica Extra",
"quantity": 1,
"price": 25000,
"subtotal": 25000,
"total": 25000,
"sku": "COR-MET-01",
"is_upsell": true,
"upsell_type": "one_tick"
}
Expresión JavaScript para el Nodo «Code» o Plantilla de Mensaje en n8n
Puedes usar este snippet en un nodo Code (JavaScript) de n8n para formatear el resumen de productos e inyectar el documento de identidad (customer.document) y distrito (customer.district) en el mensaje de confirmación de WhatsApp:
const body = $input.first().json.body || $input.first().json;
const customer = body.customer || {};
const products = body.products || [];
const lines = products.map(item => {
const badge = item.is_upsell ? ` [Oferta Adicional ${item.upsell_type === 'one_click' ? 'Post-Compra' : '1-Tick'}]` : '';
return `• ${item.quantity}x ${item.name}${badge} ($${Number(item.total).toLocaleString('es-CO')})`;
}).join('\n');
const fullLocation = [customer.district, customer.city, customer.state].filter(Boolean).join(', ');
return [{
json: {
phone_clean: String(customer.phone || '').replace(/\D/g, ''),
order_id: body.order_id,
customer_name: `${customer.first_name || ''} ${customer.last_name || ''}`.trim(),
customer_document: customer.document || 'No registrado',
shipping_address: `${customer.address_1 || ''} ${customer.address_2 || ''}`.trim(),
location_label: fullLocation,
items_summary: lines,
order_total: Number(body.total).toLocaleString('es-CO'),
currency: body.currency
}
}];
4. Receta 2: Secuencia Antispam de Carritos Abandonados (abandoned_cart + cart_recovered)
El error más común al automatizar recordatorios de carritos abandonados por WhatsApp es enviar el mensaje de recuperación a un cliente que terminó completando la compra 5 minutos después en otra pestaña o dispositivo.
Con la dupla de webhooks abandoned_cart y cart_recovered de Modal COD Form PRO puedes construir una arquitectura libre de spam:
- Paso 1 (Recepción de
abandoned_cart): Cuando n8n o Make recibe el eventoabandoned_cart, registra una fila en tu tabla de control (Data Store / Redis / Google Sheets / Supabase) usandocart_idysession_idcon estadopending_reminder, y programa un nodo Wait (Espera de 15 minutos). - Paso 2 (Recepción de
cart_recovered): Si el cliente finaliza su compra, el plugin busca secuencialmente cualquier carrito abandonado que coincida porsession_id,emailo los últimos dígitos delphone. Al encontrarlo, lo marca como recuperado y dispara inmediatamente el webhookcart_recoveredincluyendo elcart_idy el nuevoorder_idconvertido. - Paso 3 (Verificación antes de enviar WhatsApp): Cuando el nodo Wait de 15 minutos despierta en tu flujo de
abandoned_cart, consulta tu tabla de control porcart_id. Si ya recibiócart_recovered, detiene la ejecución silenciosamente; si sigue pendiente, envía el WhatsApp con la URL mágica de recuperación (recovery_url) que restaura los productos y datos del cliente en 1 clic.
5. Depuración en Vivo con el Inspector de las Últimas 10 Peticiones
Si tu servidor de n8n o Make devuelve un error 401, 404 o 500, no necesitas revisar logs de Apache/Nginx:
- Ve a WooCommerce → Ajustes → Modal COD Form → Píxeles y Webhooks.
- Activa la casilla Habilitar Registro de Entregas de Webhooks (Enable Webhook Delivery Log) (opción
cod_form_webhook_enable_log = yes). - Usa el botón Probar Webhook (Send Test) junto a cualquiera de los 4 eventos o realiza una prueba real.
- Revisa la tabla inferior que almacena en un ring-buffer (opción
prcod_webhook_delivery_logs) las últimas 10 entregas HTTP con marca de tiempo, evento, URL de destino, código de estado HTTP (200 OK,WP_Error, etc.), el payload JSON enviado y los primeros 500 caracteres de la respuesta de tu servidor.