botozap-js

Monorepo das ferramentas públicas do BotoZap — a plataforma dev-first multi-tenant sobre a WhatsApp Cloud API oficial. O core da plataforma é fechado; o que vive aqui é a camada que ajuda quem integra.

Status: preview público 0.x. Os pacotes estão publicados no npm. A API REST continua sendo a interface oficial e estável — tudo aqui é um envelope fino sobre ela. Tudo é 0.x, sem promessa de estabilidade de API até a 1.0; se algo faltar ou quebrar nos pacotes, o fallback é sempre a API REST direto.

Node suportado: >=20.19, validado em CI nos majors 20.19, 22 e 24 (typecheck, testes, build, imports ESM/CJS, smokes de CLI/MCP e instalação dos tarballs reais num projeto limpo). A matriz contratual completa também está verde contra os handlers reais no repositório privado do core.

Bugs: issues deste repositório — nunca inclua sua chave de API no relato.

Pacotes

O SDK é a única implementação do cliente HTTP: CLI e MCP consomem @botozap/sdk (workspace) — autenticação, envelopes, paginação, erros e tipos vivem num lugar só.

Related MCP server: lingtai-whatsapp

Exemplos

Em examples/: envio sandbox em JavaScript e TypeScript, receptor de webhook (HMAC + idempotência transacional) e configuração do MCP com chave sandbox.

Desenvolvimento

Requer Node ≥ 20.19 e pnpm (exclusivamente — nunca npm/yarn/bun).

pnpm install
pnpm typecheck
pnpm test
pnpm build

Versionamento com Changesets — tudo 0.x, sem promessa de estabilidade prematura.

Licença

MIT