Como Enviar SMS em Massa com Dashboard e API

Campanhas em massa sao ideais para promocoes, notificacoes transacionais, lembretes e comunicacao interna. Com a Zavu voce escolhe entre um dashboard visual ou chamadas de API. Veja como.

O que voce precisa

Conta na Zavu

Numero emissor (local ou toll-free)

Lista de contatos em formato E.164 (+5511999990000)

Conteudo aprovado e opt-ins coletados

Para EUA, registro A2P 10DLC (cuidamos disso automaticamente)

Metodo 1: Dashboard (sem codigo)

Acesse Broadcasts e clique em Create Broadcast

Nomeie a campanha (ex.: "Black Friday VIP 2025")

Escolha o canal SMS e o sender

Escreva a mensagem com variaveis {{name}}, {{order_id}} etc.

text
Ola {{name}}, nao perca 25% OFF hoje! Use FRIDAY25. https://sualoja.com/sale
Responda STOP para sair.

Adicione contatos via CSV, selecao manual ou lista existente

CSV exemplo:

csv
phone,name,order_id
+14155551234,John,ORD-001
+14155555678,Sarah,ORD-002

Revise destinatarios, custo estimado e agende ou envie na hora

Acompanhe entregas, falhas e opt-outs em tempo real

Metodo 2: API de Broadcasts

Instalacao

bash
npm install @zavudev/sdk
# ou
bun add @zavudev/sdk

Criar broadcast

typescript
import Zavudev from '@zavudev/sdk';

const client = new Zavu();
const broadcast = await client.broadcasts.create({
  name: 'Black Friday 2025',
  channel: 'sms',
  text: 'Ola {{name}}, 25% OFF hoje! FRIDAY25. Reply STOP.'
});

Adicionar contatos e enviar

typescript
await client.broadcasts.contacts.add(broadcast.id, {
  contacts: [
    { recipient: '+14155551234', templateVariables: { name: 'John' } },
    { recipient: '+14155555678', templateVariables: { name: 'Sarah' } }
  ]
});

await client.broadcasts.send(broadcast.id, {
  scheduledAt: '2025-11-29T09:00:00Z'
});

Monitorar

typescript
const progress = await client.broadcasts.progress(broadcast.id);
console.log(progress.status, progress.percentComplete);

Melhores praticas

Limite de caracteres: mantenha <160 (GSM-7). Emojis trocam para Unicode (70 caracteres).

Opt-out: inclua sempre "Reply STOP"; a Zavu gerencia bloqueios automaticamente.

Personalizacao: use variaveis para nomes, pedidos e datas.

Horario: melhores resultados entre 10h-12h e 14h-15h, de tercaa quinta.

Segmentacao: clientes VIP recebem ofertas exclusivas, novos clientes recebem boas-vindas, inativos recebem re-engajamento.

Teste: envie para voce antes de publicar; valide links e variaveis.

Custos

O valor varia por pais, comprimento da mensagem e volume. A Zavu mostra o custo estimado antes do disparo e repassa tarifas de operadora sem markup.

Compliance

EUA: TCPA + registro 10DLC + opt-in explicito
UE: GDPR, identificacao clara do remetente e direito de revogar consentimento
Canada: CASL com consentimento expresso ou implicito

Sempre mantenha registros de consentimento e atualize opt-outs imediatamente.

Recursos avancados

Smart Routing

Use channel: 'smart' para permitir que a Zavu escolha entre SMS, WhatsApp ou Email reduzindo custos.

Webhooks

Receba eventos de entregue, falha, opt-out e conclusao de broadcast para sincronizar seus sistemas.

Troubleshooting

Sem entrega: valide formato E.164, registro 10DLC e conteudo (palavras bloqueadas).
Falhas altas: limpe a lista, evite envios noturnos, revise o texto.
Lentidao: verifique seu trust score e considere vetting para maior throughput.

Proximos passos

Crie sua conta gratis

Compre um numero direto no dashboard

Importe contatos via CSV

Crie seu primeiro broadcast ou integre via API

Precisa de ajuda? Consulte a documentacao ou fale conosco. Outros links uteis: