ctx.events (setup only)

export async function setup(ctx) {
  const off = ctx.events.on("group-participants.update", async (update) => {
    if (update.action === "add") {
      await ctx.send.to(update.id).text("Bem-vindo! 👋");
    }
  });
  setTimeout(off, 60 * 60 * 1000); // para de ouvir em 1h

  await ctx.events.once("connection.update"); // resolve na próxima mudança de conexão
  ctx.log.success("Conexão atualizada!");

  ctx.events.on("connection.update", (update) => {
    if (update.connection === "close") ctx.log.warn("Bot desconectou.");
  });
}

on(event, handler) → retorna off(). once(event) → Promise que resolve na próxima ocorrência, tipada com o payload daquele evento. cleanup() → remove todos os listeners do plugin (chamado automaticamente pelo kernel ao descarregar).

messages.upsert: o kernel já consome esse evento internamente pra despachar plugins (é a fonte de ctx.msg). Ouvir messages.upsert via ctx.events.on te dá acesso ao evento bruto do Baileys, incluindo mensagens de chats fora da lista de permitidos — filtre manualmente se precisar disso, e prefira ctx.msg no handler normal em vez de reimplementar a lógica de despacho aqui.

Eventos disponíveis

Esses são os eventos nativos do socket Baileys (sock.ev), repassados via ctx.events:

Payloads exatos vêm de BaileysEventMap (@whiskeysockets/baileys). O pacote @manybot/types já tipa ctx.events.on/once sobre esse mapa — o handler recebe o payload correto automaticamente pra qualquer evento nativo do Baileys, sem precisar importar nada extra no seu plugin.