---
title: Como Enviar SMS em Massa com Dashboard e API
description: Aprenda a disparar SMS em massa usando o dashboard da Zavu ou a API. Tutorial completo com exemplos de codigo, boas praticas e requisitos de compliance.
date: 2025-12-18
author: Victor Villalobos
locale: pt
source: https://www.zavu.dev/pt/blog/how-to-send-bulk-sms
tags: SMS, Mensagens em Massa, API, Tutorial
---

# 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

1. Conta na [Zavu](https://dashboard.zavu.dev)
2. Numero emissor (local ou toll-free)
3. Lista de contatos em formato E.164 (+5511999990000)
4. Conteudo aprovado e opt-ins coletados
5. Para EUA, registro [A2P 10DLC](/blog/what-is-a2p-10dlc) (cuidamos disso automaticamente)

## Metodo 1: Dashboard (sem codigo)

1. Acesse **Broadcasts** e clique em **Create Broadcast**
2. Nomeie a campanha (ex.: "Black Friday VIP 2025")
3. Escolha o canal **SMS** e o sender
4. Escreva a mensagem com variaveis {{name}}, {{order_id}} etc.

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

5. Adicione contatos via CSV, selecao manual ou lista existente

CSV exemplo:

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

6. Revise destinatarios, custo estimado e agende ou envie na hora
7. 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

1. **Limite de caracteres**: mantenha <160 (GSM-7). Emojis trocam para Unicode (70 caracteres).
2. **Opt-out**: inclua sempre "Reply STOP"; a Zavu gerencia bloqueios automaticamente.
3. **Personalizacao**: use variaveis para nomes, pedidos e datas.
4. **Horario**: melhores resultados entre 10h-12h e 14h-15h, de tercaa quinta.
5. **Segmentacao**: clientes VIP recebem ofertas exclusivas, novos clientes recebem boas-vindas, inativos recebem re-engajamento.
6. **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

1. **[Crie sua conta gratis](https://dashboard.zavu.dev)**
2. **Compre um numero** direto no dashboard
3. **Importe contatos** via CSV
4. **Crie seu primeiro broadcast** ou integre via API

Precisa de ajuda? Consulte a [documentacao](https://docs.zavu.dev) ou [fale conosco](/contact-us). Outros links uteis:
- [O que e A2P 10DLC?](/blog/what-is-a2p-10dlc)
- [GSM-7](/glossary/what-is-gsm7)
- [Segmentacao de clientes](/glossary/what-is-customer-segmentation)