Boas práticas (API não oficial)

Como usar a API do Zynzap sem perder números, com aquecimento, ritmo de envio, consentimento e sinais de alerta.

O Zynzap conecta seus números como um aparelho vinculado (o mesmo mecanismo do WhatsApp Web), não pela API oficial da Meta (WhatsApp Business Platform). Isso traz liberdade (sem aprovação de modelos, sem tarifa por conversa da Meta) e custo baixo, mas o WhatsApp continua aplicando as próprias regras contra spam. Números que se comportam como robôs de disparo são restringidos ou banidos, e o Zynzap não tem como reverter isso.

Sem spam

Envie só para quem pediu para receber. Mensagens não solicitadas em massa violam os Termos do WhatsApp e a LGPD, e são o caminho mais rápido para perder o número.

Números novos: aqueça antes

Um número recém-criado ou recém-conectado que começa enviando centenas de mensagens é bloqueado rápido. Antes de usar em produção:

Use o Aquecimento do Zynzap (painel ou StartWarmup) por alguns dias: ele troca conversas naturais entre os seus próprios números.
Complete o perfil (foto, nome, recado) e use o número também "como pessoa" nos primeiros dias.
Aumente o volume aos poucos, semana a semana.

Ritmo de envio

Para listas, use campanhas (StartCampaign), não laços de SendMessage: elas aplicam intervalos aleatórios, janelas de horário, limites diários e as regras de opt-out da conta.
Se precisar enviar mensagens individuais em sequência, espaçe-as (segundos, não milissegundos) e use simulate_typing.
Distribua o volume entre vários números aquecidos em vez de concentrar num só.
Evite horários fora do comercial e rajadas em feriados.

Conteúdo

Personalize (nome, pedido, contexto). Textos idênticos para muitos contatos são sinal de spam: use variações (PreviewVariations ajuda a conferir).
Evite encurtadores de link e muitos links por mensagem.
Sempre ofereça uma forma de sair ("responda SAIR") e respeite: marque com SetContactCommStatus e o Zynzap deixa o contato fora das campanhas.
Prefira conversas iniciadas pelo cliente. Responder dentro de 24 horas também sai de graça no Zynzap.

Sinais de alerta

Pare ou reduza os envios se notar:

muitas mensagens sem confirmação de entrega (MessageStatusUpdated sem delivered);
clientes bloqueando ou denunciando;
desconexões frequentes (SessionDisconnected) ou SESSION_WA_STATUS_TEMP_BANNED (respeite ban_retry_after_unix_ms antes de reconectar).

Integração robusta

Uma chave por sistema, mínimo de permissões, IPs permitidos e rotação periódica (veja Autenticação).
Trate 429 com backoff e nunca repita envios pagos às cegas (veja Erros).
Receba eventos por webhook, responda 2xx rápido e processe numa fila; deduplique por id.
Monitore o requestId dos erros nos seus logs.

O que o Zynzap faz por você

Cotação antes de cada operação paga e limites por conta e por chave.
Campanhas com ritmo seguro, janelas de horário e opt-out.
Aquecimento automático entre seus números.
Registro de tudo no atendimento, com responsável, histórico e indicadores.

O Zynzap não é afiliado, associado, autorizado nem endossado pelo WhatsApp ou pela Meta Platforms, Inc.