Um bot em Baileys que responde "recebi sua mensagem" sai em trinta linhas. Um agente de IA que as pessoas não percebem que é agente dá muito mais trabalho, e quase nada disso é a chamada ao modelo. Este guia passa pelas camadas, com o que aprendemos construindo o WACrew em cima do Baileys.
Ainda não conhece a biblioteca? Comece por Baileys: como funciona, com estado de autenticação, eventos, JIDs e um bot mínimo.
1. Guarde tudo, não só a última mensagem
O modelo precisa de histórico. Grave todo evento de messages.upsert (texto, autor, horário, mensagem citada, caminho da mídia) num armazenamento seu. Filtre type === "notify" para disparar resposta, mas guarde também o que vem da sincronização, para contexto.
sock.ev.on("messages.upsert", async ({ type, messages }) => {
for (const m of messages) await store.append(m.key.remoteJid!, normalizar(m));
if (type !== "notify") return;
for (const m of messages) if (!m.key.fromMe) fila.tocar(m.key.remoteJid!);
});
2. Decida quem responder primeiro
Não responda dentro do evento. Coloque as conversas numa fila por tempo de espera e junte mensagens seguidas num bloco só. Gente manda três balões em sequência; responder cada um separado é a primeira pista de robô.
3. Transforme mídia em texto
Baixe o áudio e transcreva (Whisper vai bem em português). Print e foto podem ir direto para um modelo multimodal. Sem isso, o agente responde ao redor do que importa.
4. Escreva como o dono do número
Meça como o dono escreve naquela conversa: tamanho, pontuação, saudação, emoji. Dê ao modelo essas medidas e as últimas mensagens, em vez de uma persona genérica. Depois revise o rascunho em código: barre abertura com dois-pontos, travessão, desculpa repetida, a mesma abertura da última vez, bom dia às oito da noite. As regras genéricas do WACrew estão publicadas no botsmell.
5. Envie como gente
await sock.readMessages([ultimaKey]);
await sock.sendPresenceUpdate("composing", jid);
await esperar(tempoDigitando(texto));
await sock.sendMessage(jid, { text: texto });
await sock.sendPresenceUpdate("paused", jid);
Espere antes de começar conforme a conversa (segundos num papo ativo, mais numa conversa fria), quebre respostas longas em balões e cancele se chegar mensagem nova ou se o dono responder pelo celular. Devolva um ticket para quem chamou poder acompanhar.
6. Deixe uma pessoa no circuito
Toda conversa começa num modo em que o rascunho vai para o dono antes. O modo autônomo liga conversa por conversa, nunca para tudo. Se alguém perguntar se está falando com IA, não minta: pare e devolva a conversa.
7. Exponha por MCP
Com armazenamento, fila, transcrição e entrega prontos, o servidor MCP é uma camada fina: listar conversas, ler, buscar, transcrever, preparar resposta, enviar com ticket e cancelar. Assim o Claude Code, o Codex ou o Cursor dirigem o mesmo agente. As 36 do WACrew estão em ferramentas MCP.
Ou pule a construção
Tudo isso está aberto no WACrew (Apache 2.0). Dá para usar como está ou ler src/whatsapp/ para ver o Baileys isolado atrás de portas e adaptadores.
Perguntas frequentes
Qual pacote do Baileys instalo? Siga a instrução atual do README do Baileys; o nome e a versão do pacote mudaram com o tempo.
Dá para rodar o modelo local? Dá. O laço do agente não liga para onde o modelo roda, desde que a latência caiba na entrega no ritmo humano.
Meu número pode ser banido? Pode, com qualquer cliente não oficial. Responder quem escreveu para você, no ritmo de gente, é o uso de menor risco.



