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
- Crie um cliente com a URL base e a chave em variável de ambiente.
- Envolva o POST em retry com backoff para 429 e 5xx (a fila pode estar cheia, o motor pode reiniciar).
- Exponha POST /wa-hook no seu servidor para receber eventos e responder 200 rápido — processe depois.
- 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.