Rotación de números en WhatsApp: cómo repartir la carga entre instancias

Vale para operaciones en las que un único cliente conversa con mucha gente: un equipo comercial con varias líneas, una clínica con sedes, una tienda que responde leads de anuncios todo el día. Dividir el envío reduce el volumen por número y mantiene viva la operación cuando un chip se cae.

No vale para envío masivo a quien nunca habló contigo. Dividir una lista fría entre cinco números solo esparce el problema en cinco chips, y el consentimiento sigue siendo lo que más pesa. Si el número es nuevo, caliéntalo antes: mira el calentamiento de chip.

Primera, rotar solo entre números conectados: lee la lista de instancias y filtra por estado. Segunda, tope diario por número, definido por ti según la fase de cada chip (la planilla de operación lo guarda). Tercera, el mismo contacto siempre por el mismo número: quien ya conversó con el número A no debe recibir el siguiente mensaje del número B, porque el cambio confunde al cliente y parece sospechoso para WhatsApp. Cuarta, pausa inmediata en el número que devuelve 429 o cae de estado.

La tercera regla pide una tabla simple en tu sistema: contacto, instancia de origen. La rotación vale solo para contactos nuevos. Los contactos que ya tienen dueño siguen con él.

El ejemplo lee GET /instances, filtra las conectadas (el estado viene como CONNECTED en la respuesta de ejemplo de la referencia), gira un cursor y salta a quien ya alcanzó el tope. El contador está en memoria solo para el ejemplo: en producción guárdalo por día en una base de datos, o la rotación se reinicia con cada arranque. La llamada de envío es POST /{instanceId}/send/text con number y text. Mira la referencia para los demás campos.

// Round-robin sender: picks the next CONNECTED instance that is under its daily cap
const BASE = "https://api.zapzapapi.com/api/v1";
const H = {
  "Content-Type": "application/json",
  "x-api-key": process.env.ZAPZAP_API_KEY,
  "x-api-secret": process.env.ZAPZAP_API_SECRET,
};
const DAILY_CAP = 40;          // your own limit per number, from your operations sheet
const sentToday = new Map();   // instance id -> count (persist it in a database in production)
let cursor = 0;

async function connectedInstances() {
  const res = await fetch(BASE + "/instances", { headers: H });
  if (!res.ok) throw new Error("GET /instances failed: HTTP " + res.status);
  const list = await res.json();
  return list.filter((i) => i.status === "CONNECTED");
}

function pickInstance(pool) {
  for (let n = 0; n < pool.length; n++) {
    const inst = pool[(cursor + n) % pool.length];
    if ((sentToday.get(inst.id) || 0) < DAILY_CAP) {
      cursor = (cursor + n + 1) % pool.length;
      return inst;
    }
  }
  return null; // every number hit its cap: stop and try again tomorrow
}

export async function sendBalanced(number, text) {
  const pool = await connectedInstances();
  const inst = pickInstance(pool);
  if (!inst) throw new Error("no instance available under the daily cap");
  const res = await fetch(BASE + "/" + inst.id + "/send/text", {
    method: "POST",
    headers: H,
    body: JSON.stringify({ number, text }),
  });
  if (res.status === 429) throw new Error("rate limited, back off on " + inst.name);
  if (!res.ok) throw new Error("send failed on " + inst.name + ": HTTP " + res.status);
  sentToday.set(inst.id, (sentToday.get(inst.id) || 0) + 1);
  return { instance: inst.name, status: res.status };
}

La referencia lista 429 como límite de solicitudes excedido. Trátalo como señal para retroceder en ese número y seguir por los otros, en vez de repetir la llamada en bucle. Si todos llegan al tope, la respuesta correcta es parar y retomar al día siguiente, no subir el tope.

No distribuyas ráfagas idénticas: varía el texto, espacia los envíos y prefiere conversaciones a disparos. La API tiene opciones de retraso por mensaje, y el envío por lista en /sender/simple acepta retrasos mínimo y máximo; úsalos en vez de dormir en tu código cuando sea una campaña programada.

Más números no cambian el precio unitario: R$15 por número activo al mes, prepago, sin cobro por mensaje, así que repartir la carga entre 4 números cuesta R$60 al mes, sea cual sea el volumen. Antes de crear más instancias, consulta el costo en GET /instances/cost, que muestra la tarifa de activación y el saldo necesario.

Registra, por número y por día: enviadas, respuestas y fallas. Un número con tasa de respuesta cayendo y fallas subiendo retrocede una fase. Para ver el precio a escala, mira costo por número y volumen y la página de precios. Para el perfil de quien opera así, mira agencias con IA y gestores de tráfico.