Antes de começar
Git, Go 1.26 ou superior, Node 22 ou superior, npm, navegador com microfone e uma sessão de WhatsApp para teste.
01. Prepare o ambiente
Confira as versões no terminal. Instale os requisitos que estiverem faltando antes de continuar.
git --version
go version
node --version
npm --version127.0.0.1. O arquivo wacalls.db guarda credenciais da sessão: mantenha-o privado e fora do Git.02. Baixe o projeto e as dependências
git clone https://github.com/JotaDev66/WaCalls.git wacalls-go
cd wacalls-go
go mod download
cd client
npm install
npm run build
cd ..O build prepara a interface React que será servida pelo processo Go. Aguarde cada comando terminar com sucesso.
03. Inicie o servidor local
go run ./cmd/server -static client/dist -addr 127.0.0.1:8080Abra http://localhost:8080 na máquina em que o servidor está rodando. Mantenha o terminal aberto.
04. Conecte uma sessão e valide o áudio
Na interface, clique em New session. No WhatsApp, abra Aparelhos conectados e escaneie o QR. Permita o acesso ao microfone no navegador.
Combine uma chamada com um número de teste que você controla. Faça uma ligação e confira se ambos conseguem ouvir e falar. Depois teste uma ligação recebida.
- O status muda para uma chamada ativa?
- Há áudio nos dois sentidos?
- Encerrar libera a chamada e atualiza o histórico?
05. Entenda o próximo passo para IA
WaCalls fornece a chamada e a ponte de áudio com o navegador. Um agente exige que esse áudio seja enviado ao serviço de IA e que a resposta volte para a chamada.
Essa ponte precisa tratar formato de áudio, latência, interrupções e encerramento. Não há uma conexão pronta com ElevenLabs comprovada neste guia.
Se algo falhar
- Interface vazia: confirme o build de
client/dist. - Sem microfone: revise permissões e o dispositivo de entrada.
- Sem conexão: confira a sessão e os logs do terminal.
- Porta ocupada: use outra porta em
-addre abra a mesma no navegador.
