> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Broadcast Engine

> Agendamento e gerenciamento de campanhas de WhatsApp em massa com precisão de audiência.

O Broadcast Engine foi projetado para entrega de mensagens em alto volume. Seja enviando uma newsletter semanal ou uma notificação de promoção-relâmpago, o engine oferece as ferramentas para gerenciar distribuição em grande escala com confiança.

## Criação de Campanha

Construir um broadcast segue um fluxo de trabalho simplificado para garantir precisão e conformidade.

### 1. Seleção de Audiência

Selecione destinatários do seu banco de contatos usando:

* **Tags**: Direcione segmentos específicos como `vip-customers` ou `beta-testers`.
* **Listas Importadas**: Use contatos de uma importação de CSV recente.
* **Filtros**: Combine critérios (ex.: "Tag = 'Newsletter' AND Region = 'UK'").

### 2. Preview de Audiência

Antes de enviar, a ferramenta de **Preview de Audiência** mostra uma amostra dos destinatários. Isso ajuda a verificar se seus mapeamentos de variáveis (como `{{name}}`) estão trazendo dados corretamente dos registros de contato.

### 3. Configuração de Template

Selecione um template aprovado e mapeie variáveis para campos de contato. O preview atualizará dinamicamente para mostrar como a mensagem aparece para a amostra de audiência selecionada.

## Agendamento e Envio

O Broadcast Engine suporta tanto entrega imediata quanto planejada.

### Seletor de Agendamento

* **Enviar Agora**: Disparo imediato para o fan-out engine.
* **Envio Agendado**: Selecione uma data e hora específicas no futuro.
* **Consciência de Timezone**: Escolha entre enviar em um horário UTC fixo ou no horário local do destinatário (requer dados de timezone do contato).

### Fan-out Engine

Nosso fan-out engine proprietário gerencia a entrega em escala:

* **Rate Limiting**: Respeita automaticamente os limites atuais do tier de mensagens do seu WABA.
* **Gerenciamento de Fila**: Prioriza mensagens para garantir entrega pontual mesmo durante picos de tráfego.
* **Monitoramento de Throughput**: Rastreamento em tempo real das taxas de sucesso de envio.

## Analytics e Relatórios

Depois que um broadcast está no ar, monitore o desempenho no dashboard:

* **Taxa de Entrega**: Percentual de mensagens aceitas com sucesso pelo WhatsApp.
* **Taxa de Leitura**: Percentual de mensagens entregues que foram abertas.
* **Taxa de Cliques**: Engajamento com botões ou links.
* **Rastreamento de Conversão**: Sucesso em relação às metas de campanha predefinidas.
* **Uso e Custo Meta**: Settings → Usage entrega estimativas de custo Meta por template entregue, tráfego em janela de serviço gratuita e atribuição de gasto por campanha nas janelas de 7 dias, 30 dias e mês até a data.

Veja [Monitor de Uso e Custo Meta](/pt-BR/operations/meta-usage-cost-monitor) para o modelo de estimativa e ressalvas.

## Medidas de Segurança

* **Deduplicação**: Previne automaticamente o envio do mesmo broadcast para um contato múltiplas vezes dentro de uma janela de 12 horas.
* **Tratamento de Opt-out**: Exclui automaticamente contatos que usaram o botão "Opt-out" em mensagens de marketing anteriores.
* **Preflight de Segurança (opt-in)**: Um workspace pode exigir que um preflight `campaign_safety_audits` seja aprovado antes de uma campanha ser autorizada a ser lançada — uma escada de severidade de hard-block bloqueia o lançamento, e uma verificação de hash do conjunto de destinatários recusa o lançamento se os destinatários mudaram desde a execução do audit. Veja [Preflight de Segurança de Campanha](/pt-BR/operations/campaign-safety-preflight) para o modelo completo de gate e formato de dados.