WhatsApp no seu Node.js com uma SDK tipada de verdade

A maioria das APIs de WhatsApp te entrega uma documentação REST e boa sorte. O Loce Zap mantém uma SDK oficial pra Node.js, com tipos de verdade: autocomplete no editor, erro de compilação quando o payload está errado e respostas tipadas.

npm install loce-zap

Conectar e enviar em 15 linhas

import { LoceZap } from 'loce-zap';

const zap = new LoceZap({
    apiKey: process.env.LOCE_ZAP_API_KEY!,
});

// Conecta um número: o qrCode volta pronto pra renderizar
const { qrCode } = await zap.connect({
    sessionName: 'WhatsApp do Zé',
    webhookUrl: 'https://example.com/webhook',
});

// Envia a primeira mensagem
await zap.sendMessageText('my-session-id', {
    to: '5564999999999',
    text: 'Olá 👋',
});

O webhookUrl é opcional na conexão: dá pra configurar depois, por sessão. Os eventos chegam assinados no seu servidor (como funcionam os webhooks).

Higienize listas antes de enviar

Números sem WhatsApp queimam cota e aumentam risco de bloqueio. A SDK verifica em lote antes do disparo:

const { results, summary } = await zap.checkContacts('minha-sessao', {
  phones: ['5564999999999', '5511888888888'],
});

console.log(summary); // { total: 2, exists: 1, notExists: 1 }

Por que uma SDK tipada importa

• ▸Você descobre o campo errado no editor, não em produção às 2h da manhã.
• ▸Payloads de webhook tipados: o TypeScript sabe a diferença entre mensagem recebida e status de entrega.
• ▸Upgrade de versão vira diff de tipos: o compilador aponta o que mudou.

Não é só Node

Tem SDK Python com a mesma cobertura e a API REST documentada pra qualquer outra linguagem. Tudo que a SDK faz é HTTP: nenhum recurso é exclusivo dela. Pacote no npm: loce-zap.