Recetario Avanzado de Webhooks con n8n, Make y WhatsApp: Confirmación de Pedidos, Carritos y Antifraude

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 webhook order_created y 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_discounts o ítems con _cod_is_upsell), el hook de respaldo woocommerce_checkout_order_processed verifica 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:

  1. Paso 1 (Recepción de abandoned_cart): Cuando n8n o Make recibe el evento abandoned_cart, registra una fila en tu tabla de control (Data Store / Redis / Google Sheets / Supabase) usando cart_id y session_id con estado pending_reminder, y programa un nodo Wait (Espera de 15 minutos).
  2. Paso 2 (Recepción de cart_recovered): Si el cliente finaliza su compra, el plugin busca secuencialmente cualquier carrito abandonado que coincida por session_id, email o los últimos dígitos del phone. Al encontrarlo, lo marca como recuperado y dispara inmediatamente el webhook cart_recovered incluyendo el cart_id y el nuevo order_id convertido.
  3. 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 por cart_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:

  1. Ve a WooCommerce → Ajustes → Modal COD Form → Píxeles y Webhooks.
  2. Activa la casilla Habilitar Registro de Entregas de Webhooks (Enable Webhook Delivery Log) (opción cod_form_webhook_enable_log = yes).
  3. Usa el botón Probar Webhook (Send Test) junto a cualquiera de los 4 eventos o realiza una prueba real.
  4. 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.

Compartir esta información

Aumenta tus ventas

Mejora tu conversión en tiendas WordPress y WooCommerce con pago contra-entrega.