Saltar a contenido

Primeros Pasos

Este tutorial te guiara paso a paso para crear tu primer bot de WhatsApp.

1. Crear el proyecto

mkdir mi-bot-whatsapp
cd mi-bot-whatsapp
npm init -y
npm install @arcaelas/whatsapp typescript tsx

2. Estructura basica

Crea el archivo principal:

index.ts
import { WhatsApp } from "@arcaelas/whatsapp";

async function main() {
  // Crear instancia de WhatsApp
  const wa = new WhatsApp();

  // Escuchar eventos antes de conectar
  wa.event.on("open", () => console.log("Conectado!"));
  wa.event.on("close", () => console.log("Desconectado"));
  wa.event.on("error", (err) => console.error("Error:", err.message));

  // Conectar mostrando QR en consola
  console.log("Esperando QR...");
  await wa.pair(async (data) => {
    if (Buffer.isBuffer(data)) {
      // Guardar QR como imagen
      const fs = await import("fs");
      fs.writeFileSync("qr.png", data);
      console.log("QR guardado en qr.png - Escanea con tu telefono");
    } else {
      // Codigo de 8 digitos (si usas phone)
      console.log("Codigo de emparejamiento:", data);
    }
  });

  console.log("Bot iniciado!");
}

main().catch(console.error);

3. Ejecutar

npx tsx index.ts
  1. Aparecera el archivo qr.png
  2. Abrelo y escanea con WhatsApp > Dispositivos vinculados
  3. El bot se conectara automaticamente

Listo!

Una vez conectado, la sesion se guarda en .baileys/default/ y no necesitaras escanear de nuevo.

4. Escuchar mensajes

Agrega un listener para mensajes entrantes:

index.ts
import { WhatsApp } from "@arcaelas/whatsapp";

async function main() {
  const wa = new WhatsApp();

  // Escuchar nuevos mensajes
  wa.event.on("message:created", async (msg) => {
    // Ignorar mensajes propios
    if (msg.me) return;

    // Solo procesar texto
    if (msg.type !== "text") return;

    // Obtener contenido como texto
    const content = (await msg.content()).toString();
    console.log(`[${msg.type}] ${msg.cid}: ${content}`);

    const text = content.toLowerCase();

    if (text === "hola") {
      await wa.Message.text(msg.cid, "Hola! Soy un bot. Escribe 'ayuda' para ver comandos.");
    }

    if (text === "ayuda") {
      await wa.Message.text(
        msg.cid,
        "Comandos disponibles:\n" +
        "- hola: Saludo\n" +
        "- hora: Hora actual\n" +
        "- ping: Test de respuesta"
      );
    }

    if (text === "hora") {
      await wa.Message.text(msg.cid, `Son las ${new Date().toLocaleTimeString()}`);
    }

    if (text === "ping") {
      await wa.Message.text(msg.cid, "pong!");
    }
  });

  // Conectar
  await wa.pair(async (data) => {
    if (Buffer.isBuffer(data)) {
      const fs = await import("fs");
      fs.writeFileSync("qr.png", data);
      console.log("Escanea qr.png");
    }
  });

  console.log("Bot listo!");
}

main().catch(console.error);

5. Conexion con codigo de emparejamiento

Si prefieres no escanear QR, usa el numero de telefono:

const wa = new WhatsApp({
  phone: "5491112345678", // Sin + ni espacios
});

await wa.pair(async (data) => {
  if (typeof data === "string") {
    console.log("Ingresa este codigo en tu telefono:", data);
    // Ir a WhatsApp > Dispositivos vinculados > Vincular dispositivo
    // Seleccionar "Vincular con numero de telefono"
  }
});

6. Manejar diferentes tipos de mensaje

wa.event.on("message:created", async (msg) => {
  if (msg.me) return;

  const buffer = await msg.content();

  // Mensaje de texto
  if (msg.type === "text") {
    const text = buffer.toString();
    console.log("Texto:", text);
  }

  // Imagen
  if (msg.type === "image") {
    console.log(`Imagen: ${buffer.length} bytes`);
    if (msg.caption) {
      console.log(`Caption: ${msg.caption}`);
    }
    // Guardar imagen
    const fs = await import("fs");
    fs.writeFileSync("imagen.jpg", buffer);
  }

  // Video
  if (msg.type === "video") {
    console.log(`Video: ${buffer.length} bytes`);
  }

  // Audio (nota de voz)
  if (msg.type === "audio") {
    console.log(`Audio: ${buffer.length} bytes`);
  }

  // Ubicacion
  if (msg.type === "location") {
    const coords = JSON.parse(buffer.toString());
    console.log(`Ubicacion: ${coords.lat}, ${coords.lng}`);
  }

  // Encuesta
  if (msg.type === "poll") {
    const poll = JSON.parse(buffer.toString());
    console.log(`Encuesta: ${poll.content}`);
    poll.options.forEach((opt: { content: string }, i: number) => {
      console.log(`  ${i + 1}. ${opt.content}`);
    });
  }
});

7. Enviar mensajes

const cid = "5491198765432@s.whatsapp.net";

// Texto
await wa.Message.text(cid, "Hola!");

// Texto citando mensaje
await wa.Message.text(cid, "Respuesta", "MESSAGE_ID_TO_QUOTE");

// Imagen con caption
import * as fs from "fs";
const img = fs.readFileSync("foto.jpg");
await wa.Message.image(cid, img, "Mira esta foto!");

// Video
const vid = fs.readFileSync("video.mp4");
await wa.Message.video(cid, vid, "Video interesante");

// Audio (nota de voz)
const aud = fs.readFileSync("audio.ogg");
await wa.Message.audio(cid, aud);

// Ubicacion
await wa.Message.location(cid, {
  lat: -34.6037,
  lng: -58.3816
});

// Encuesta
await wa.Message.poll(cid, {
  content: "Cual prefieres?",
  options: [
    { content: "Opcion A" },
    { content: "Opcion B" },
    { content: "Opcion C" }
  ]
});

8. Reaccionar a mensajes

wa.event.on("message:created", async (msg) => {
  if (msg.me) return;
  if (msg.type !== "text") return;

  const text = (await msg.content()).toString().toLowerCase();

  // Reaccionar con emoji
  if (text.includes("gracias")) {
    await msg.react("❤️");
  }

  if (text.includes("jaja")) {
    await msg.react("😂");
  }

  // Quitar reaccion
  // await msg.react("");
});

9. Marcar chat como leido

wa.event.on("message:created", async (msg) => {
  // Marcar chat como leido
  await wa.Chat.seen(msg.cid);
});

Siguiente paso

Ahora que tienes un bot basico funcionando, explora la documentacion detallada: