Migrar de WAHA a ZapZap: guía de migración (incluye n8n)

WAHA es una API HTTP no oficial que corres en Docker; el sitio del proyecto la describe como gratuita y de código abierto. Tú eliges el motor de conexión (WEBJS, NOWEB, GOWS), el servidor y cuándo actualizar. La documentación del propio WAHA advierte que WhatsApp no permite bots ni clientes no oficiales y que eso puede llevar a un bloqueo.

En ZapZap, alojamiento, actualización y monitoreo quedan con nosotros, el cobro es de R$15 por número activo al mes y el riesgo del número sigue existiendo, porque también es una solución no oficial. A cambio, pierdes el control del servidor y del motor.

La columna de WAHA viene de la documentación oficial (waha.devlike.pro, 27/10/2026). WAHA usa session y un chatId con sufijo (@c.us); ZapZap usa el ID de la instancia en la URL y el número solo con dígitos.

Si tu flujo usa el nodo de WAHA o un HTTP Request apuntando a WAHA, el cambio es directo. Instala el nodo de la comunidad n8n-nodes-zapzap en Settings, Community Nodes (los nodos de la comunidad no verificados solo funcionan en n8n autoalojado, según la documentación de n8n) o usa un HTTP Request con los encabezados x-api-key y x-api-secret. Paso a paso en la integración con n8n.

En el disparador de recepción, cambia el Webhook de WAHA por el Webhook de n8n con la URL de producción (no la de prueba) y configura esa URL en configurar webhook. En los nodos siguientes, ajusta las expresiones: donde había payload.from y payload.body, pasa a usar data.message.chatid y data.message.text. Las 12 plantillas de n8n ya vienen en el formato de ZapZap.

// Entrada: evento da ZapZap. Saída: o formato que seus nós já esperavam do WAHA.
const e = $input.first().json.body ?? $input.first().json;
const m = e?.data?.message;
if (e?.event !== "messages" || !m || m.fromMe) return [];
return [{
  json: {
    payload: {
      from: String(m.chatid || "").replace(/\D/g, "") + "@c.us",
      body: m.text || "",
      fromMe: false,
    },
  },
}];

El envío es un cambio de URL, encabezados y campos: session y el chatId con @c.us pasan a ser el ID de la instancia en la URL y un number solo con dígitos. Aísla el envío en una función y cambia su contenido.

// ANTES: WAHA
// POST {WAHA_URL}/api/sendText   header: X-Api-Key
// body: { session: "default", chatId: "5511999999999@c.us", text: "Olá!" }

// DEPOIS: ZapZap
export async function enviarWhatsApp(numero, texto) {
  const r = await fetch(
    "https://api.zapzapapi.com/api/v1/" + process.env.ZAPZAP_INSTANCE_ID + "/send/text",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-key": process.env.ZAPZAP_API_KEY,
        "x-api-secret": process.env.ZAPZAP_API_SECRET,
      },
      body: JSON.stringify({ number: numero.replace(/@.*/, ""), text: texto }),
      signal: AbortSignal.timeout(15000),
    }
  );
  if (!r.ok) throw new Error("ZapZap " + r.status + " " + (await r.text()));
  return r.json();
}

Lista: 1) crear la cuenta y probar con un número tuyo; 2) cambiar la función de envío o el nodo de n8n; 3) apuntar el webhook y validar la firma (guía); 4) exportar lo que quieras guardar de WAHA; 5) conectar el número de producción por código QR en el momento del cambio, sin mantenerlo activo en los dos; 6) apagar el contenedor antiguo tras unos días estables.

Sigue en WAHA si tienes DevOps, quieres el código y los datos en tu entorno y prefieres elegir el motor de conexión. Mira la comparativa WAHA y ZapZap y la cuenta de costos en Evolution y WAHA alojados frente a gestionada. Si necesitas un canal homologado por Meta, la opción es la API oficial.