Pular para o conteúdo principal

Introdução ao Envio em Massa

Envio em Massa​

O recurso de Envio em Massa permite que você envie a mesma mensagem para vários destinatários de uma só vez. É ideal para campanhas de marketing, avisos, notificações e comunicados em larga escala.

Como funciona​

Ao criar um envio em massa, a Ogmma API enfileira todas as mensagens e as envia de forma sequencial com um intervalo configurável entre cada envio. Isso garante que sua conta não seja banida por envio excessivo.

Principais recursos​

  • Delay configurável entre envios: defina o intervalo mínimo entre cada mensagem (mínimo de 1000ms)
  • Jitter automático: a API adiciona uma variação aleatória ao delay para simular comportamento humano e evitar detecção de automação
  • Acompanhamento de progresso: consulte o status do lote a qualquer momento para saber quantas mensagens foram enviadas, falharam ou estão pendentes
  • Cancelamento: cancele um envio em andamento a qualquer momento. As mensagens já enviadas não são afetadas
  • Webhook de conclusão: receba uma notificação via webhook quando o lote for concluído
  • Templates personalizados (WABA): envie templates com parâmetros personalizados para cada destinatário

Limite de destinatarios​

O limite maximo e de 1.000 destinatarios por lote.

Status do lote​

Um lote de envio em massa pode ter os seguintes status:

StatusDescrição
QUEUEDO lote foi criado e está aguardando processamento
IN_PROGRESSAs mensagens estão sendo enviadas
COMPLETEDTodas as mensagens foram processadas com sucesso
PARTIALLY_FAILEDO lote foi concluído, mas algumas mensagens falharam
CANCELLEDO lote foi cancelado pelo usuário antes de ser finalizado

Boas práticas​

  • Utilize um delay de pelo menos 3000ms entre envios para evitar bloqueios
  • Prefira enviar mensagens em horário comercial para melhor taxa de entrega
  • Para canais WABA, utilize templates aprovados para garantir a entrega
  • Monitore o progresso do lote e trate os erros retornados no array errors