Como a apiwpp protege o seu número e os seus dados
Sessões criptografadas, webhooks assinados, chaves de API com escopo e rotação, e limites que barram abuso. Tudo o que está nesta página está em produção.

Sessões dos números
A sessão é o que mantém o número conectado. Ela fica guardada com cuidado e sai quando você manda.
- Criptografada em repouso
- A sessão de cada número fica salva no banco de dados, criptografada.
- Desconectar ou fazer logout
- Desconectar mantém a sessão para reconectar sem QR code. O logout apaga a sessão, para trocar o número.
- Excluir a conexão
- Remove a conexão junto com a sessão, os templates e o histórico.
- Aparelho conectado
- O número aparece em Aparelhos conectados no celular, onde você pode desconectá-lo a qualquer momento.
Webhooks assinados
Cada evento que chega no seu servidor pode ser verificado antes de ser processado.
- HMAC-SHA256
- Com um segredo definido no projeto, cada entrega traz X-Sales-Timestamp e X-Sales-Signature, calculada sobre o timestamp e o corpo bruto.
- Proteção contra repetição
- Cada tentativa é assinada de novo; rejeite timestamps a mais de 300 segundos do seu relógio.
- Só HTTPS público
- O endereço do webhook precisa ser https público, e redirecionamentos não são seguidos.
- Mídia recebida
- Arquivos de mensagens recebidas chegam por uma URL assinada e temporária.
Chaves de API
Cada projeto tem as próprias chaves, e cada chave só faz o que o escopo dela permite.
- Escopos
- connections:read, connections:write, messages:send, webhooks:write e outros: dê a cada parte do sistema só o que ela usa.
- Rotação sem interrupção
- Gere uma chave nova com uma janela de sobreposição e troque sem derrubar nada.
- Expiração e revogação
- Defina validade para a chave ou revogue na hora uma que vazou.
- Um projeto por sistema
- Projetos separam sistemas ou clientes, cada um com chaves e webhook próprios.
Proteção da plataforma
Limites e verificações que barram abuso antes de ele chegar ao seu número.
- Limite de requisições
- 600 requisições por minuto por IP de origem e no máximo 20 falhas de autenticação a cada 5 minutos.
- Download seguro de mídia
- Mídia é enviada por URL https pública; endereços privados ou internos são recusados.
- Ritmo por número
- A fila limita envios por minuto, hora e dia e o número de destinatários novos, para reduzir o risco de bloqueio.
- Logs com prazo
- Registros de mensagens e de webhooks ficam 7 dias no painel, por padrão.
Verificar a assinatura de um webhook
Leia o corpo bruto, recuse timestamps antigos e compare a assinatura em tempo constante. O guia de webhooks da documentação traz o mesmo exemplo também em PHP.
import { createHmac, timingSafeEqual } from 'node:crypto'
// Segredo do webhook, definido no projeto
const SECRET = process.env.WHATSAPP_WEBHOOK_SECRET
function isSigned(rawBody, timestamp, signature) {
if (!/^\d+$/.test(timestamp ?? '') || !signature) return false
// Mais de 300 s de diferença: entrega antiga, recuse
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false
const mac = createHmac('sha256', SECRET)
.update(`${timestamp}.`)
.update(rawBody)
.digest('hex')
const expected = Buffer.from(`sha256=${mac}`)
const received = Buffer.from(signature)
return expected.length === received.length && timingSafeEqual(expected, received)
}Status público e limites claros
Página de status
status.apiwpp.com mostra o estado de cada componente, alimentado por um teste que envia mensagens reais entre dois números a cada 10 minutos.
Erros explícitos
Cada erro volta em JSON com o campo error e, em validações e limites, um code; um limite de ritmo responde 429 com Retry-After.
Sem números inventados
Não publicamos porcentagens de disponibilidade nem taxas de entrega que não possamos mostrar. O que está no ar aparece na página de status.
Perguntas sobre segurança
A sessão do meu número fica salva?
Fica, criptografada em repouso no banco de dados. É ela que permite reinícios e atualizações sem pedir um novo QR code. O logout apaga a sessão, e excluir a conexão remove a sessão, os templates e o histórico.
Como sei que um webhook veio da apiwpp?
Defina um segredo no projeto. Cada entrega passa a trazer X-Sales-Timestamp e X-Sales-Signature (HMAC-SHA256 do timestamp e do corpo bruto). Recalcule a assinatura, compare em tempo constante e recuse timestamps a mais de 300 segundos.
O que faço se uma chave de API vazar?
Revogue a chave no painel e gere outra. Para trocar chaves sem pressa, use a rotação com janela de sobreposição: a antiga continua valendo por um tempo enquanto você atualiza o sistema.
A apiwpp garante que o número não será bloqueado?
Não. A fila por número, o aquecimento de 14 dias e o teto de destinatários novos reduzem o risco, mas nada garante que o WhatsApp nunca vá restringir um número.
Encontrou uma falha de segurança?
Escreva para [email protected] com os detalhes e os passos para reproduzir. Não inclua chaves de API, segredos ou dados de terceiros na mensagem.