Ir para o conteúdo
WACore api
Entrar
CódigoNode.js

WhatsApp em Node.js: cliente HTTP e webhook

O Node 22 traz fetch nativo e crypto — suficiente para um cliente de WhatsApp de produção com retry e verificação de assinatura. Nenhuma dependência além do express para o webhook.

Por que usar a API própria nesse caso

O mesmo processo que já roda o seu SaaS pode enviar mensagem, sem subir um serviço só para isso. A sessão do chip fica no WACore, não no seu processo: seu deploy não derruba o WhatsApp.

Passo a passo

  1. Crie um cliente com a URL base e a chave em variável de ambiente.
  2. Envolva o POST em retry com backoff para 429 e 5xx (a fila pode estar cheia, o motor pode reiniciar).
  3. Exponha POST /wa-hook no seu servidor para receber eventos e responder 200 rápido — processe depois.
  4. Valide o HMAC do header se você configurou secret no webhook.

Exemplo de código

const KEY = process.env.WACORE_KEY;
const API = 'https://wacoreapi.zapboot.com/v1';

export async function enviar(number, text, instance = 'principal', tentativa = 0) {
  const r = await fetch(`${API}/messages/text`, {
    method: 'POST',
    headers: { 'content-type': 'application/json', apikey: KEY },
    body: JSON.stringify({ instance, number: String(number).replace(/\D/g, ''), text }),
  });
  if (r.status === 429 && tentativa < 3) {
    await new Promise((ok) => setTimeout(ok, 4000 * (tentativa + 1)));
    return enviar(number, text, instance, tentativa + 1);
  }
  if (!r.ok) throw new Error(`WACore ${r.status}: ${await r.text()}`);
  return r.json();
}

Duas dicas que evitam retrabalho

  • Nunca use await em série dentro de for para listas longas: mande em paralelo limitado (p-limit ou um semáforo de 5).
  • O webhook pode repetir em caso de timeout — use o messageId como chave de idempotência.
Contrato da API: todos os campos, códigos de erro e limites estão em /api. Se você precisa do mesmo endpoint em outra linguagem, a chamada é a mesma — muda só o cliente HTTP.

Como contratar

A contratação é sob consulta. Descreva o cenário (quantos números, volume e qual sistema integra) e receba a proposta com prazo de instalação e chave de API.

Ver planos