Primeros pasos

Todo lo que necesitas para crear tu cuenta, conectar WhatsApp y lanzar tu primer flujo en minutos.

Crear una cuenta

Haz clic en Ingresar desde la página principal y selecciona Continuar con Google. Solo necesitas una cuenta de Gmail. Al registrarte recibes 100 créditos gratis para explorar el marketplace.

También puedes ingresar con correo y contraseña si no tienes Google. La versión Demo te permite explorar el editor sin cuenta, pero los flujos son temporales y no se guardan.

Lanzar tu primer flujo

¿Funciona en móvil?

El panel de gestión, marketplace y configuración están optimizados para móvil. El editor visual es más cómodo en pantalla grande, pero puedes activar y desactivar flujos desde el celular sin problemas.

Editor de flujos

El editor visual te permite construir automatizaciones completas sin escribir código, conectando nodos de lógica, acción y condición.

Tipos de nodos

• Disparadores — inician el flujo: Mensaje recibido, Webhook, Horario (Cron).
• Acciones — hacen algo: Enviar mensaje, Enviar media, Llamar API, Esperar.
• Lógica — controlan el camino: Condición Si/No, Bucle, División.
• IA / LLM — conecta tu clave de OpenAI, Anthropic o Groq para respuestas inteligentes.

Conectar nodos

Cada nodo tiene puertos de salida (punto derecho) y entrada (punto izquierdo). Haz clic y arrastra desde la salida de un nodo hasta la entrada del siguiente. Haz clic sobre una conexión para eliminarla.

Variables

Las variables guardan datos entre nodos. Escríbelas como {{nombre_variable}} en cualquier campo de texto.

• Variables de sesión — duran mientras dura la conversación. Ej: {{nombre}}.
• Variables globales — persisten entre conversaciones. Ej: {{contador_ventas}}.

Usa el nodo Guardar variable para crear o actualizar variables desde un flujo.

Desplegar (activar) un flujo

En el editor haz clic en Desplegar, o activa el interruptor en la lista de flujos. Una vez desplegado, el flujo procesa mensajes y disparadores en tiempo real. Puedes desactivarlo sin perder su configuración.

Disparador Horario (Cron)

Usa expresiones cron estándar o las opciones visuales. Ejemplo: 0 9 * * 1-5 ejecuta el flujo a las 9 am de lunes a viernes.

Disparador Webhook

Genera una URL única que puedes llamar desde cualquier sistema externo (tienda, CRM, formulario) para iniciar el flujo con los datos que envíes en el cuerpo de la petición.

WhatsApp

Conecta tu número personal o de negocio mediante el protocolo multi-dispositivo de WhatsApp. No necesitas la API oficial de Meta.

Conectar un número

Si la sesión se desconecta

Las sesiones pueden desconectarse si WhatsApp detecta actividad inusual o hay un problema de red. Para reconectar:

1. Haz clic en Reconectar junto a la sesión.
2. Escanea el nuevo código QR desde tu celular.

NodoWA intenta reconectar las sesiones automáticamente al reiniciarse el servidor.

Múltiples números

Puedes crear varias sesiones con nombres distintos. En tus flujos y scripts eliges qué sesión usar para enviar o recibir mensajes. Útil para manejar varias líneas de negocio desde la misma cuenta.

Tipos de medios que puedes enviar

El nodo Enviar media soporta: imágenes, videos, audio, documentos, stickers y mensajes de voz. Proporciona la URL pública del archivo o una variable que contenga esa URL.

Sobre Baileys

NodoWA usa la librería Baileys, que conecta WhatsApp mediante el mismo protocolo multi-dispositivo que WhatsApp Web. No requiere aprobación de Meta ni pago de API oficial. Úsalo de forma responsable: WhatsApp puede limitar cuentas con actividad automatizada masiva.

¿Qué es un script?

Un script es una mini-aplicación JavaScript que corre directamente en el servidor de NodoWA. Te da control total del código para construir lógica que los nodos estándar no pueden manejar.

¿Para qué sirve?

• Consultar APIs externas (clima, precios, ERPs, bases de datos)
• Procesar y transformar datos (parsear archivos, calcular totales)
• Enviar mensajes de WhatsApp condicionalmente desde código
• Crear una mini web app o API pública con tu propia URL
• Integrar con webhooks que necesiten lógica personalizada

Las tres zonas del editor

① Panel izquierdo — Configuración: nombre, descripción, permisos y opción de publicar.

② Área central — Código: pestaña JS para tus funciones, pestaña HTML para la interfaz web pública.

③ Panel de pruebas: se abre con el botón ▶ Probar y te permite ejecutar cualquier función con argumentos JSON.

Tu primer script

async function hola(args) {
  const nombre = args.nombre || "Mundo";
  return { mensaje: `¡Hola, ${nombre}! Desde NodoWA.` };
}

Sintaxis de funciones

Todas las funciones ejecutables deben declararse como async function. Reciben un único argumento args (el JSON que pasas al probar o llamar la función) y retornan el resultado con return.

Reglas básicas

• Usa siempre async function nombre(args) — aunque no uses await adentro.
• args es el objeto JSON que llega. Accede a sus propiedades con args.clave.
• Lo que retornes con return aparece en el panel de pruebas y en la respuesta de _run.
• Puedes lanzar errores con throw new Error("mensaje") — el sistema los captura y los muestra.
• console.log() escribe en los logs del servidor (no visibles en el panel de pruebas).
• Puedes declarar funciones auxiliares normales fuera de las async (sin necesidad de que sean async).

Ejemplo: validación y cálculo

async function calcularDescuento(args) {
  const precio = Number(args.precio);
  const pct    = Number(args.descuento) || 10;

  if (isNaN(precio) || precio <= 0) {
    throw new Error("El precio debe ser un número positivo");
  }

  const descuento = precio * (pct / 100);
  const final     = precio - descuento;

  return {
    precioOriginal: precio,
    descuento:      descuento.toFixed(2),
    precioFinal:    final.toFixed(2),
    porcentaje:     pct
  };
}

Ejemplo: llamada a API externa

fetch está disponible de forma nativa (Node.js 18+). Puedes hacer peticiones HTTP a cualquier servicio externo.

async function obtenerClima(args) {
  const ciudad = args.ciudad || "Buenos Aires";
  const url    = `https://wttr.in/${encodeURIComponent(ciudad)}?format=j1`;

  const res  = await fetch(url);
  if (!res.ok) throw new Error(`Error HTTP ${res.status}`);
  const data = await res.json();

  const temp = data.current_condition[0].temp_C;
  const desc = data.current_condition[0].weatherDesc[0].value;

  return { ciudad, temperatura: `${temp}°C`, descripcion: desc };
}

Múltiples funciones en el mismo script

// Función auxiliar (no necesita ser async si no usa await)
function formatearPrecio(num) {
  return new Intl.NumberFormat('es-AR', {
    style: 'currency', currency: 'ARS'
  }).format(num);
}

// Función principal — llamable desde el panel de pruebas
async function verPrecio(args) {
  const valor = Number(args.valor) || 1000;
  return { formateado: formatearPrecio(valor) };
}

Manejo de errores con try/catch

async function consultarAPI(args) {
  try {
    const res = await fetch(args.url);
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    return await res.json();
  } catch (err) {
    return { error: true, mensaje: err.message };
  }
}

Panel de pruebas

El panel de pruebas te permite ejecutar cualquier función de tu script con los argumentos que quieras, directamente desde el editor, sin necesidad de publicar.

Publicar y URL pública

Al publicar un script obtienes una URL propia donde se sirve tu HTML y desde donde cualquier sistema externo puede llamar tus funciones.

Endpoints de la URL pública

Llamar una función desde el HTML publicado

El servidor inyecta automáticamente window.NODOWA_RUN_URL con la URL correcta del endpoint _run. Úsala siempre en lugar de URLs relativas para evitar errores de resolución.

<button onclick="ejecutar()">Obtener clima</button>
<p id="resultado"></p>

<script>
async function ejecutar() {
  // window.NODOWA_RUN_URL es inyectado automáticamente por el servidor
  const res = await fetch(window.NODOWA_RUN_URL, {
    method:  'POST',
    headers: { 'Content-Type': 'application/json' },
    body:    JSON.stringify({
      fn:   'obtenerClima',
      args: { ciudad: 'Bogotá' }
    })
  });
  const data = await res.json();
  document.getElementById('resultado').textContent =
    data.temperatura + ' — ' + data.descripcion;
}
</script>

Cuerpo de la petición POST a _run

Mini web app: formularios e integración

Combina la pestaña HTML (interfaz) con la pestaña JS (lógica de servidor) para crear apps completas accesibles desde cualquier navegador.

Ejemplo completo: cotizador con IVA

Pestaña JS:

// Permiso necesario: whatsapp:send (solo si quieres enviar por WA)
async function cotizar(args) {
  const precio = Number(args.precio) || 0;
  const iva    = precio * 0.21;
  const total  = precio + iva;

  if (args.enviarWA && args.sesion && args.numero) {
    await nodo.whatsapp.send(args.sesion, {
      to:   args.numero + "@s.whatsapp.net",
      type: "text",
      text: `💰 Cotización\nSubtotal: $${precio.toFixed(2)}\nIVA 21%: $${iva.toFixed(2)}\nTotal: $${total.toFixed(2)}`
    });
  }

  return { subtotal: precio, iva, total };
}

Pestaña HTML:

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="UTF-8">
  <title>Cotizador</title>
  <style>
    body { font-family: sans-serif; max-width: 400px; margin: 40px auto; padding: 0 20px; }
    input, button { width: 100%; padding: 10px; margin: 8px 0;
                    border-radius: 8px; border: 1px solid #ddd; font-size: 1rem; }
    button { background: #7c3aed; color: white; border: none; cursor: pointer; }
    #resultado { background: #f0fdf4; border: 1px solid #bbf7d0;
                 border-radius: 8px; padding: 16px; margin-top: 16px; display: none; }
  </style>
</head>
<body>
  <h2>Cotizador con IVA</h2>
  <input id="precio" type="number" placeholder="Precio sin IVA">
  <button onclick="calcular()">Calcular</button>
  <div id="resultado"></div>

  <script>
  async function calcular() {
    const precio = document.getElementById('precio').value;
    const res = await fetch(window.NODOWA_RUN_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ fn: 'cotizar', args: { precio } })
    });
    const d = await res.json();
    const el = document.getElementById('resultado');
    el.style.display = 'block';
    el.innerHTML = `<b>Subtotal:</b> $${d.subtotal.toFixed(2)}<br>
                    <b>IVA 21%:</b> $${d.iva.toFixed(2)}<br>
                    <b>Total:</b> $${d.total.toFixed(2)}`;
  }
  </script>
</body>
</html>

Leer parámetros de la URL (Query Parameters)

Puedes pasar datos directamente en la URL pública para que tu HTML los procese al cargar. Por ejemplo:

https://nodowa.lat/apps/usuario/script/?cliente=Juan&telefono=5491112345678

<script>
// Leer los parámetros de la URL al cargar la página
const params  = new URLSearchParams(window.location.search);
const cliente = params.get('cliente');   // "Juan"
const tel     = params.get('telefono');  // "5491112345678"

// Rellenar campos automáticamente
if (cliente) document.getElementById('nombre').value = cliente;

// O pasarlos directamente a una función del script
async function cargar() {
  const res = await fetch(window.NODOWA_RUN_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      fn:   'buscarCliente',
      args: { nombre: cliente, telefono: tel }
    })
  });
  const data = await res.json();
  // Usar data...
}
cargar();
</script>

Errores frecuentes

Referencia rápida de los errores más comunes y cómo resolverlos.

Objeto nodo — referencia completa

El objeto global nodo expone los métodos de la plataforma dentro de tus scripts. Cada grupo de métodos requiere que actives el permiso correspondiente en el panel izquierdo del editor.

nodo.whatsapp.send(sesionId, mensaje)

Envía un mensaje de WhatsApp a través de una de tus sesiones conectadas. Requiere permiso whatsapp:send.

Tipos de mensaje (type)

Ejemplos:

// Texto
await nodo.whatsapp.send("mi-sesion", {
  to:   "5491112345678@s.whatsapp.net",
  type: "text",
  text: "Hola, tu pedido está listo 🎉"
});

// Imagen con caption
await nodo.whatsapp.send("mi-sesion", {
  to:      "5491112345678@s.whatsapp.net",
  type:    "image",
  url:     "https://ejemplo.com/comprobante.jpg",
  caption: "Aquí está tu comprobante de pago"
});

// Documento PDF
await nodo.whatsapp.send("mi-sesion", {
  to:       "5491112345678@s.whatsapp.net",
  type:     "document",
  url:      "https://ejemplo.com/factura.pdf",
  fileName: "factura-001.pdf",
  caption:  "Tu factura del mes"
});

nodo.flows.getVar(flowId, key)

Lee el valor de una variable global de un flujo. Requiere permiso flows:read. Devuelve el valor almacenado o undefined si no existe.

const valor = await nodo.flows.getVar("abc123", "ultimo_pedido");
return { variable: "ultimo_pedido", valor };

nodo.flows.setVar(flowId, key, value)

Escribe o actualiza una variable global de un flujo. Requiere permiso flows:write. El valor puede ser cualquier tipo serializable (string, number, object, array).

await nodo.flows.setVar("abc123", "ultimo_pedido", {
  id:    args.pedidoId,
  monto: args.monto,
  fecha: new Date().toISOString()
});
return { guardado: true };

Permisos

Los scripts corren en un entorno aislado por seguridad. Para acceder a funciones privilegiadas activa el permiso correspondiente en el panel izquierdo del editor (sección Permisos).

Entorno de ejecución

Especificaciones técnicas del entorno donde corre tu código. Conocerlas te ayuda a saber qué puedes hacer y qué límites respetar.

Marketplace

La tienda donde puedes comprar flujos listos creados por la comunidad y vender los tuyos. La moneda son los créditos.

Comprar un flujo

Vender un flujo

Cuenta y créditos

Los créditos son la moneda interna de NodoWA. Se usan para comprar flujos en el marketplace.

Cómo obtener créditos

• Registro: recibes 100 créditos gratis al crear tu cuenta.
• Vendiendo: cuando alguien compra uno de tus flujos, los créditos se acreditan a tu saldo.
• Transferencia: otro usuario puede transferirte créditos usando tu correo. Ve a tu perfil para hacer una transferencia (es inmediata e irreversible).
• Comprando: el botón de recarga te lleva a Hotmart para adquirir paquetes de créditos.

Ver tu saldo

Tu saldo aparece en la parte superior del panel de inicio (Mi cuenta) y en el icono de moneda de la barra de navegación.

Eliminar tu cuenta

Ve a Mi cuenta → Configuración → Eliminar cuenta. Esta acción es irreversible: se borran todos tus flujos, sesiones de WhatsApp, créditos y datos personales. Exporta cualquier flujo que quieras conservar antes de proceder.

Privacidad de mensajes

NodoWA procesa los mensajes en tiempo real para ejecutar tus flujos, pero no almacena el historial de conversaciones. Solo se guardan las variables que tú definas explícitamente en tus flujos.