ctx.chat

Informações do chat atual (runtime only, já filtrado pela lista de permitidos do manybot.toml).

ctx.chat.id;                          // string
ctx.chat.name;                        // string
ctx.chat.isGroup;                     // boolean
await ctx.chat.getParticipants();     // [] em privado — [{ id, isAdmin, isSuperAdmin }] em grupo
await ctx.chat.isAdmin(contactId);    // false em privado
await ctx.chat.isSenderAdmin();       // atalho pra isAdmin(ctx.msg.sender)
await ctx.chat.isBotAdmin();          // cheque antes de usar ctx.admin.*

if (ctx.chat.isGroup) {
  await ctx.send.text(`Olá, grupo *${ctx.chat.name}*!`);
} else {
  await ctx.send.text(`Olá, ${ctx.msg.senderName}!`);
}

if (ctx.msg.is("banir")) {
  if (!await ctx.chat.isSenderAdmin()) return void await ctx.msg.reply.text("Só admins.");
  // ...
}

ctx.chat.clearMessages() existe na interface, mas atualmente não tem efeito — só registra um aviso no log. O Baileys ainda não expõe essa funcionalidade.

---

ctx.admin

Ações de administração de grupo (runtime only). Cheque ctx.chat.isGroup e ctx.chat.isBotAdmin() antes de chamar.

await ctx.admin.kick(memberIds);              // string | string[]
await ctx.admin.add(memberIds);               // grupo atual
await ctx.admin.add(memberIds).to(groupId);   // outro grupo por ID — encadeável
await ctx.admin.promote(memberIds);
await ctx.admin.demote(memberIds);
await ctx.admin.setSubject("Novo Nome");
await ctx.admin.setDescription("...");
await ctx.admin.setProfilePic("/tmp/foto.jpg"); // ou Buffer
const link = await ctx.admin.getInviteLink();          // grupo atual
const outroLink = await ctx.admin.getInviteLink(groupId); // outro grupo, por ID
await ctx.admin.revokeInvite();

kick/add/promote/demote lançam erro se o WhatsApp rejeitar a operação pra qualquer um dos IDs informados (ex: sem permissão, já é membro, privacidade do contato) — não falham silenciosamente. Envolva em try/catch se quiser tratar isso ao invés de deixar propagar pro guard de erro do plugin (veja guardOptions).

Só add() é encadeável com .to(groupId) pra mirar outro grupo. getInviteLink() também funciona no setup() se você passar um groupId explícito (não depende de chat atual). Os demais (kick, promote, setSubject, etc.) sempre operam no chat atual e exigem contexto de runtime.

Guard padrão de comando admin:

export default async function (ctx) {
  if (!ctx.chat.isGroup) return;
  if (!ctx.msg.is("kick")) return;
  if (!await ctx.chat.isSenderAdmin()) return void await ctx.msg.reply.text("Só admins.");
  if (!await ctx.chat.isBotAdmin())    return void await ctx.msg.reply.text("Preciso ser admin.");

  await ctx.admin.kick(ctx.msg.args[0]);
  await ctx.send.text("Removido.");
}

kick ≠ ban: WhatsApp não tem ban nativo. Combine kick com ctx.contacts.block pra impedir re-entrada.

---

ctx.me

Perfil do próprio bot (setup + runtime).

await ctx.me.setName("ManyBot 🟢");
await ctx.me.setAbout("Online — digite !ajuda para começar.");
await ctx.me.setProfilePic("/tmp/avatar.jpg"); // ou Buffer

// atualizar em runtime conforme estado
if (filaCheia) await ctx.me.setAbout("Ocupado — processando downloads...");