Rodar o zapbip localmente

Localmente, o zapbip roda o mesmo Worker da produção. Um sandbox de desenvolvimento responde no lugar do WhatsApp, como o celular do dono, então você não precisa de conta da Meta e nada chega a um celular de verdade.

O que você precisa

Node 24 ou mais novo e pnpm
Git
Ou Docker com Compose, para a opção Docker

No seu computador

Baixe o código e instale:

git clone https://github.com/dhyegocalota/zapbip.git
cd zapbip
pnpm install

Crie apps/api/.dev.vars com quatro segredos aleatórios e prepare o banco local:

printf 'MEDIA_LINK_SIGNING_KEY=%s\nUPLOAD_LINK_SIGNING_KEY=%s\nNUMBER_REGISTRY_KEY=%s\nMETA_APP_SECRET=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" "$(openssl rand -base64 32)" "$(openssl rand -hex 16)" > apps/api/.dev.vars
pnpm migrate:development

Inicie o Worker e confira:

pnpm --filter @zapbip/api dev
curl http://localhost:8787/health

Crie um dono e um agente. O comando mostra o segredo do agente uma única vez:

pnpm --silent --filter @zapbip/api dev:seed --phone <digits> --agents alpha

Conecte sua IA com o segredo mostrado:

claude mcp add --transport http alpha http://localhost:8787/c/<alpha-secret>/mcp

O guia da pilha local percorre uma conversa completa, em inglês.

Docker

Um comando constrói a imagem e inicia o Worker na porta 8787:

git clone https://github.com/dhyegocalota/zapbip.git
cd zapbip
docker compose up --build

O banco, os arquivos e os segredos gerados ficam no volume zapbip-data, então sobrevivem a uma reinicialização. Defina MEDIA_LINK_SIGNING_KEY, UPLOAD_LINK_SIGNING_KEY, NUMBER_REGISTRY_KEY ou META_APP_SECRET no seu ambiente para escolhê-los você mesmo. Crie um dono e um agente dentro do contêiner:

docker compose exec zapbip pnpm --silent dev:seed --phone <digits> --agents alpha

Primeiros passos

IAs

Funcionalidades

Ajuda

Para desenvolvedores

Código aberto

Rodar o zapbip localmente

O que você precisa

No seu computador

Docker