Sonique · Guia

Liga o teu WhatsApp à Sonique

O trabalho já acontece no WhatsApp: é lá que o artista manda voice notes, referências e aprovações. Este guia mostra como montar o teu próprio bot — com a ajuda de um agente de IA — para o grupo produtor+artista deixar de ser um buraco negro de ficheiros.

Lê isto antes de começar

Isto não é a API oficial do WhatsApp. O bot usa o Baileys, uma biblioteca não oficial que fala o protocolo do WhatsApp Web.
Há risco real de banimento da conta usada pelo bot. O WhatsApp pode bloquear números que detete como automação.
Por isso: usa sempre um número dedicado. Nunca ligues o bot ao teu número pessoal.

A visão

O grupo

Produtor e artista já falam num grupo de WhatsApp. Áudios, stems e referências caem lá todos os dias.

O bot

Um bot silencioso vive no grupo e arquiva automaticamente cada ficheiro que lá aparece, organizado por data.

O projeto

Os ficheiros acabam na secção Ficheiros do projeto na Sonique — e as masters saem como links privados /f com prazo.

Honestidade primeiro: a ligação automática do bot ao projeto na Sonique ainda está em desenvolvimento. Hoje, este guia monta o bot que captura e organiza os ficheiros do grupo na tua máquina; a subida para a Sonique continua manual por enquanto.

O que precisas

Um número dedicado

Uma eSIM barata chega (ex.: Lyca, ~5€). Números VoIP (Skype, TextNow e afins) falham a verificação do WhatsApp. Nunca uses o teu número pessoal.

Uma máquina sempre ligada

Um portátil velho, um Mac Mini ou um VPS pequeno. O bot precisa de ficar a correr para apanhar o que entra no grupo.

Um agente de IA

Claude Code ou Codex. É o agente que escreve e mantém o bot por ti — tu só colas o prompt abaixo e segues as instruções.

Passo a passo

Arranja o número

Compra uma eSIM (ex.: Lyca, ~5€) e instala-a num telemóvel. Regista uma conta WhatsApp nova com esse número.

Instala o agente de IA

Na máquina onde o bot vai correr, instala o Claude Code ou o Codex e abre uma sessão numa pasta nova (ex.: whatsapp-bot).

Cola o prompt.md

Copia o prompt abaixo e cola-o no agente. Ele escreve o bot Baileys completo e diz-te como o arrancar.

Emparelha por QR ou pairing code

Ao arrancar, o bot mostra um QR code no terminal (ou um pairing code). No telemóvel do bot: WhatsApp → Dispositivos ligados → Ligar dispositivo.

Adiciona o bot ao grupo

Adiciona o número do bot ao grupo com o teu artista. A partir daí, tudo o que lá cair fica arquivado e organizado, pronto a subir para o projeto.

O prompt

Cola este prompt no Claude Code ou no Codex, dentro de uma pasta vazia. É tudo o que o agente precisa para construir o bot.

prompt.md

# Bot WhatsApp -> Sonique (self-host, Baileys)

Constrói um bot de WhatsApp em Node.js com a biblioteca Baileys
(@whiskeysockets/baileys), para correr na minha própria máquina.

Contexto e regras que deves respeitar:
- O Baileys usa o protocolo do WhatsApp Web (não é a API oficial).
- O número usado é dedicado ao bot — nunca um número pessoal.
- O bot vive num grupo de WhatsApp onde falo com o meu artista/cliente.

O que o bot deve fazer:
1. Autenticação com sessão persistente em ./auth (multi-file auth state).
   Na primeira execução, mostrar o QR code no terminal e oferecer pairing
   code como alternativa (pedindo o número).
2. Reconectar automaticamente quando a ligação cai (excepto em logout).
3. Escutar apenas os grupos cujo JID esteja na lista ALLOWED_GROUPS
   (configurável no topo do ficheiro ou por .env). Ignorar tudo o resto.
4. Quando chegar áudio, voice note, imagem ou documento num grupo permitido:
   descarregar o ficheiro para ./inbox/[grupo]/[AAAA-MM-DD]/ com o nome
   original (ou timestamp se não existir) e registar num log simples.
5. Comando !status no grupo: responder com uptime e nº de ficheiros de hoje.
   Nenhuma outra mensagem automática — o bot é silencioso.
6. Nunca apagar, reenviar ou responder a mensagens privadas.

Qualidade:
- package.json com scripts start/dev e um README curto (como correr).
- Tratamento de erros no download de media (1 retry).
- Código simples, de preferência num só ficheiro (bot.mjs).

No fim, explica-me como emparelhar o número (QR ou pairing code) e como
descobrir o JID do grupo para o pôr em ALLOWED_GROUPS.

Lembrete final: o Baileys não é a API oficial do WhatsApp e o número do bot pode ser banido. Usa um número dedicado, mantém o bot silencioso no grupo e não uses isto para spam. Quando a ligação automática à Sonique estiver pronta, este guia será atualizado.