Início rápido Siga estes passos para conectar seu WhatsApp e enviar a primeira mensagem.
Copie sua API KeyUse a chave padrão gerada com a sua conta.
••••••••••
Instale o SDKO SDK pode ser instalado via npm ou yarn.
1
npm install loce-zap-sdk
OU
1
yarn add loce-zap-sdk
Conecte um WhatsAppGere o QR Code através do nosso SDK ou pelo painel.
1
2
3
4
5
6
7
8
9
import { LoceZap } from "loce-zap-sdk";
 
const zap = new LoceZap({ apiKey: process.env.LOCE_ZAP_API_KEY! });
 
const result = await zap.connect("my-session-id", {
webhookUrl: "https://acme.com/webhooks/loce-zap",
});
 
console.log(result.qrCode);
Configure o webhookReceba eventos assinados no seu endpoint. No plano Free, mensagens recebidas (MESSAGE-RECEIVED) já disparam webhooks; eventos de status — enviada, entregue, lida — estão nos planos pagos.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import express from 'express';
import { LoceZap } from 'loce-zap-sdk';
 
const app = express();
app.use(express.json({ verify: (req, _res, buf) => { (req as any).rawBody = buf; } }));
 
const zap = new LoceZap({ apiKey: process.env.LOCE_ZAP_API_KEY! });
 
app.post('/webhooks/loce-zap', (req, res) => {
const rawBody = (req as any).rawBody ?? JSON.stringify(req.body);
 
if (!zap.webhooks.verifySignature({ headers: req.headers as any, rawBody })) {
return res.status(401).json({ error: 'invalid signature' });
}
 
const event = zap.webhooks.parseEvent(rawBody);
 
if (event.type === 'SESSION-CONNECTED') {
console.log('[Webhook] sessão conectada');
}
 
if (event.type === 'MESSAGE-RECEIVED') {
console.log('[Webhook] nova mensagem recebida:', event.payload);
}
res.status(200).send('OK');
});
Envie sua primeira mensagemCom a sessão online, chame o SDK ou o endpoint REST.
1
2
3
4
await zap.sendMessageText("my-session-id", {
to: "5564999999999",
text: "Olá 👋",
});
Acompanhe as entregasCada disparo de webhook fica registrado no painel, com status, tentativas e payload — e você pode reenviar entregas que falharam.
Dica: consulte a documentação para mais informações.
Loce Zap

Dashboard em desktop

A versão mobile do painel ainda está em construção. Acesse pelo desktop para continuar usando o Loce Zap.

Foi mal... ✌️