Skip to main content
Nós sabemos o que você está pensando: “Usar uma API não oficial não vai banir meu número? E se o sistema der pau e mandar a mesma mensagem duas vezes?” A maioria das APIs “caseiras” ou bibliotecas open-source falham porque não têm freios e não tratam falhas de rede. A Zenvio é diferente. Nós não somos apenas um disparador de mensagens; somos uma infraestrutura de proteção entre o seu código e o WhatsApp. Veja como blindamos a sua operação:

​
O “Comportamento Humano” (Smart Delay)

Quando um humano envia uma mensagem, ele leva tempo para digitar, pensar e apertar enviar. Robôs mandam 50 mensagens em 1 segundo. Para evitar que seu número seja marcado como spam, implementamos nativamente o Smart Delay com Jitter (Atraso Variável).

​
Como funciona nos bastidores:

  1. Você envia a mensagem via API.
  2. Nós não repassamos imediatamente ao WhatsApp.
  3. O sistema cria um delay inteligente utilizando algoritmos precisos com base em caracteres.
  4. Só então a mensagem é despachada.
Além disso, temos um Rate Limit de segurança por instância. Se você tentar mandar 1.000 mensagens de uma vez, nós aceitamos todas, mas as enfileiramos e entregamos de forma suave para não estressar o seu chip.

​
O Escudo do “Duplo Clique” (Idempotência)

Sabe quando a internet do seu servidor oscila, dá um timeout, e seu sistema tenta enviar a mesma mensagem de cobrança de novo? Em provedores comuns, seu cliente recebe a fatura duas vezes (e reclama com você). Na Zenvio, basta você nos enviar um header mágico: o Idempotency-Key (ou X-Idempotency-Key). Se você enviar uma requisição com uma chave de idempotência e, por qualquer motivo, enviar a mesma requisição de novo nas próximas 24 horas, nós não criamos uma nova mensagem. A API simplesmente devolve um status 200 OK com a resposta exata da primeira tentativa.
Sua aplicação pode tentar quantas vezes quiser. O cliente só recebe uma vez.

​
Travas Distribuídas (Locks de Processamento)

E se os nossos servidores piscarem? Para garantir que um pico de escala na nossa infraestrutura não faça a mesma mensagem ser processada por dois workers simultaneamente, usamos Travas Distribuídas (Locks).
Antes de iniciar o envio ao WhatsApp, nosso sistema tranca aquela mensagem específica. Se outro processo tentar pegá-la, ele vê a trava e recua. Tolerância a falhas levada a sério.

​
Resiliência: Nada se perde

A internet cai. Servidores reiniciam. Em sistemas amadores, a mensagem se perde no limbo. Na Zenvio, aplicamos engenharia de resiliência:
  • Se nosso gerenciador de filas ficar indisponível no exato milissegundo do seu envio, nós salvamos o job. Quando a fila voltar, as mensagens são reenfileiradas automaticamente.
  • Se a conexão com o WhatsApp der erro temporário? Nós tentamos de novo com retentativas exponenciais.
  • Se a mensagem falhar definitivamente (ex: número inválido), ela não some. Nós salvamos e te avisamos para você auditar depois*.
Recurso exclusivo para alguns planos pagos.

​
Proteção de Dados e Privacidade (LGPD)

Segurança não é só sobre infraestrutura, é sobre os dados dos seus clientes e da sua empresa.
  • Isolamento Total: Nossa arquitetura é Multi-tenant. Cada requisição é estritamente isolada e validada por Workspace.
  • Logs Sanitizados (Redação): O conteúdo dos seus logs de API passa por um filtro automático. Senhas, tokens e dados sensíveis são substituídos por [REDACTED] antes de serem salvos no nosso banco.
  • Criptografia: Suas chaves de API (zv_live_...) são cacheadas e armazenadas usando algoritmos de hash unidirecional (Bcrypt). Nem os nossos engenheiros conseguem ver a sua chave original.