Dispara un workflow desde tu ecommerce o ERP con un webhook entrante

Tu ecommerce ya sabe cuando alguien paga, tu ERP sabe cuando cambia un pedido. La pregunta es: como convertir ese evento en un mensaje de WhatsApp, una tarea para el equipo o una actualizacion de contacto sin programar una integracion entera. La respuesta es el trigger Webhook entrante de los workflows de Omnifox. Le das una URL a tu sistema externo, cada evento entra como JSON, y tu decides que hacer con el. En esta guia lo montamos paso a paso.

El trigger: Webhook entrante

Cada workflow arranca con un solo trigger. Aqui elegimos Webhook entrante. Omnifox te da una URL unica; se la pegas a tu tienda (Shopify, WooCommerce, tu ERP casero) como destino de sus webhooks. Cada vez que ese sistema dispara un evento, tu workflow se ejecuta.

La clave es el filtro path_match: una expresion que decide si el payload te interesa, por ejemplo event.type == "order.paid". Asi un mismo endpoint puede recibir muchos tipos de evento y cada workflow reacciona solo al suyo (pago confirmado, pedido enviado, reembolso, etc.).

Paso 1: leer el payload

El cuerpo del webhook queda disponible como {{$webhook.payload}}. Puedes navegar sus campos (por ejemplo el email del cliente, el total, el numero de pedido) e insertarlos en nodos posteriores. Un buen primer nodo es Definir variable para extraer los datos que vas a reutilizar varias veces (por ejemplo el numero de pedido) y darles un nombre corto y legible.

Si el evento trae el telefono o el email del cliente, agrega Buscar conversacion previa para reusar el hilo existente en lugar de abrir uno nuevo. Asi el cliente recibe la notificacion en la misma conversacion donde ya te habla.

Paso 2: ramificar por tipo de evento

Si tu path_match ya filtro fino, quizas no necesites ramificar. Pero si dejas pasar varios eventos, un nodo Switch (varias ramas) te permite abrir una rama por tipo: pago, envio, cancelacion. Tambien puedes usar Si (una regla) para casos binarios, por ejemplo "si el monto supera X, tratalo como pedido VIP".

El esqueleto queda:

1. Webhook entrante con path_match: event.type == "order.paid" (trigger)
2. Definir variable (numero de pedido, total)
3. Buscar conversacion previa (reusar el hilo del cliente)
4. Switch (por tipo de evento, si aplica)

Paso 3: notificar al cliente con una plantilla

Como el disparo viene de un sistema externo y no de un mensaje del cliente, es muy probable que estes fuera de la ventana de 24 horas de WhatsApp. Por eso el nodo correcto es Enviar plantilla de WhatsApp. Elige una plantilla aprobada tipo "Tu pago fue confirmado" e inyecta las variables del payload: numero de pedido, monto, fecha estimada de entrega, {{$contact.first_name}}.

Si el cliente esta en un canal donde no hay ventana (email, por ejemplo), puedes usar Enviar email al cliente en su lugar.

Paso 4: crear trabajo interno

Un pago confirmado casi siempre desata trabajo. Agrega Crear tarea de seguimiento para que un agente prepare el envio, o Crear tarjeta desde la conversacion para llevar el pedido a un tablero de fulfillment. Puedes encadenar Actualizar contacto para marcar al cliente como comprador o subir su etapa de lifecycle.

Paso 5: responder al sistema externo

A veces necesitas confirmarle algo de vuelta a tu ERP: marcar el pedido como "notificado", pedir la guia de envio, sincronizar inventario. Para eso esta el nodo Peticion HTTP, que llama a cualquier API externa con el metodo, cabeceras y cuerpo que definas, usando las variables que extrajiste. Envuelvelo en un Try/Catch para que un error de la API externa no tumbe todo el workflow.

Flujo completo de ejemplo

Webhook entrante (order.paid) -> Definir variable -> Buscar conversacion previa -> Enviar plantilla de WhatsApp -> Crear tarea de seguimiento -> Peticion HTTP (marcar como notificado) dentro de Try/Catch

Errores comunes

• path_match demasiado abierto. Si no filtras, tu workflow se dispara con cada evento y manda mensajes de mas. Se especifico: event.type == "order.paid".
• Asumir que hay ventana de WhatsApp. El webhook no viene del cliente; usa Enviar plantilla de WhatsApp, no Enviar mensaje.
• No envolver la Peticion HTTP en Try/Catch. Una API externa caida no deberia romper la notificacion al cliente.
• Olvidar variables desconocidas. Si un campo del payload no existe, se resuelve como cadena vacia; verifica los nombres exactos.

Variantes

• Volcar cada pedido a Google Sheets (agregar fila) para un log simple.
• Usar Crear oportunidad (deal) si el pago abre un ciclo de venta mayor.
• Combinar con el trigger Programado (cron) en otro workflow para reintentos.

Un webhook entrante convierte a Omnifox en el cerebro de notificaciones de tu operacion: tu ecommerce dispara, Omnifox traduce ese evento en mensajes, tareas y llamadas de vuelta. Copia la URL, pegala en tu sistema y empieza a automatizar hoy.