WACrew

Guia

Agente de IA no WhatsApp com Baileys

Do bot de eco no Baileys a um agente de IA de WhatsApp: guardar contexto, chamar o modelo, responder no ritmo de gente, entender áudio e expor tudo por MCP.

Atualizado em 3 min de leitura
Nesta página
  1. 1. Guarde tudo, não só a última mensagem
  2. 2. Decida quem responder primeiro
  3. 3. Transforme mídia em texto
  4. 4. Escreva como o dono do número
  5. 5. Envie como gente
  6. 6. Deixe uma pessoa no circuito
  7. 7. Exponha por MCP
  8. Ou pule a construção
  9. Perguntas frequentes

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.