Skip to main content
Quando você envia uma mensagem, a Zenvio não tenta “empurrar” ela para o WhatsApp de qualquer jeito. Nós iniciamos um processo de engenharia robusto para garantir que ela chegue. Entender esse ciclo ajuda você a depurar problemas e a escolher a estratégia certa para cada tipo de envio.

​
Os Status da Mensagem

Ao consultar uma mensagem você verá um campo status. Aqui está o que cada um significa:
  • QUEUED Significa que recebemos sua mensagem e registramos internamente.
  • SCHEDULED Significa que a mensagem está agendada para um momento futuro.
  • PROCESSING Significa que estamos no processo de enviar sua mensagem para o WhatsApp.
  • SENT Significa que sua mensagem foi entregue com sucesso na rede do WhatsApp.
  • FAILED Significa que algo deu errado. Pode ser algo temporário ou permanente, como número inválido.
  • CANCELLED Significa que a mensagem foi cancelada, portanto não foi enviada para o destino. Esse status só pode ocorrer se a mensagem estiver em QUEUED ou SCHEDULED .
Além dos status acima que se refere ao processamento da mensagem, também temos os status que indicam engajamento e alteração da mensagem, são eles:
  • DELIVERED Significa que a mensagem foi entregue ao destinatário.
  • READ Significa que o destinatário abriu a conversa e viu a mensagem.
  • DELETED Significa que a mensagem foi deletada para todos.
  • EDITED Significa que a mensagem foi atualizada para todos.
  • RESPONDED Significa que a mensagem foi respondida pelo destinatário.
Alguns usuários podem desabilitar a confirmação de leitura do WhatsApp. Isso significa que o destinatário pode ter lido sua mensagem e isso não ser registrado.

​
A Fila de Prioridade

Imagine que você está disparando uma campanha de Marketing para 50.000 pessoas. Ao mesmo tempo, um usuário está tentando fazer login e precisa receber um código (OTP). Se todos entrarem na mesma fila, o código de login vai ficar preso atrás de 49.999 promoções. A Solução Zenvio: Nós separamos o tráfego em duas pistas no Redis:
  1. Pista Expressa: Processada 3x mais rápido. Exclusiva para mensagens críticas (OTP, Alertas).
  2. Pista Normal: Para notificações gerais e marketing.
Para usar a pista expressa, basta adicionar "options": { "priority": "high" } no seu JSON.
Atenção: Não use a fila de prioridade para levar vantagens sem o propósito apropriado. Você correrá risco de perder sua conta em nossa plataforma.

​
Política de “Não Desistir” (Retries)

A internet oscila. Se o envio falhar por um erro temporário, a Zenvio aplica Backoff Exponencial:
  1. Falhou? Esperamos 30 segundos.
  2. Falhou de novo? Esperamos 5 minutos.
  3. Ainda nada? 30 minutos e depois 2 horas.
Se após tudo isso a mensagem não for entregue, ela vai para a Dead Letter Queue (Cemitério de Mensagens) e marcamos como FAILED, notificando você via webhook para auditoria.