Everything you need
to get the most out of Wapes.

What everyone asks before and after installing.

If you can't find your question here, write to us at wapes.crm@gmail.com. We respond in under 4 hours during LatAm business hours.

Installation and first steps

Excel import and variables

Common errors

How to send lots of messages without WhatsApp cutting your head off.

WhatsApp hates spam and so do we. But we also know you have 200 clients waiting for their order confirmation. These 12 rules are the difference between a productive week and a deactivated number.

The 6 green rules — do this

The 6 red rules — DON'T do this

A JavaScript API inside your browser. For curious devs.

Wapes exposes window.wapes in the WhatsApp Web console. You can read your lists, schedule sends from an external script, or connect it to your own CRM — all locally.

List loaded contacts

// Returns an array with all contacts imported from Excel
const contacts = await window.wapes.contacts.list();
console.log(contacts.length); // 247
console.log(contacts[0]); // { id, phone, name, company, folio, ... }

Schedule a send

await window.wapes.send({
  list: "q2_clients",
  template: "Hi {name}, your order {folio} ships on {date}.",
  pace: { min: 4000, max: 18000 },  // ms between messages
  schedule: "2026-05-15T10:00:00-05:00",
  attach: "./invoices/{folio}.pdf"
});

Subscribe to events

window.wapes.on("message:sent", (e) => {
  console.log("✓", e.contact.name, "→", e.preview);
});

window.wapes.on("campaign:done", (e) => {
  fetch("https://my-crm.com/webhook", { method: "POST", body: JSON.stringify(e) });
});

Available methods: list(), get(), send(), schedule(), cancel(), on(), tags(), templates(), stats(). Request the full docs — we send them to Pro users with a real use case.

What changed version by version.

Only what's relevant to you. No "internal performance improvements" or unexplained "various bugfixes".

v 3.4.1 — May 2, 2026

• Fix: .csv files with BOM now read without \ufeff appearing at the start of names.
• Fix: canceling a scheduled send now shows a confirmation before deleting.

v 3.4 — April 18, 2026

• New: automatic template rotation (up to 3 versions of the same message, Wapes mixes randomly).
• New: local color labels. Filter contacts in the sidebar.
• Improvement: the panel now remembers the last loaded Excel file between sessions.

v 3.3 — March 12, 2026

• New: scheduling by recipient time zone (Pro).
• New: local API window.wapes v0.3.
• Change: the free limit went from 30 to 50 messages/day with template.