Broadcasts
Um broadcast envia um e-mail para toda uma audiência: uma newsletter, um comunicado ou qualquer conteúdo único que vai para muitos destinatários de uma vez. Os membros da audiência são resolvidos na lista de destinatários quando o envio começa, então o broadcast alcança quem for membro da audiência naquele momento.
Crie broadcasts em Email > Broadcasts no dashboard, pela API de broadcasts, com bird email broadcasts, ou pelo servidor MCP. Os SDKs de TypeScript, Python, Go e PHP oferecem um recurso broadcasts para todo o ciclo de vida: criar um rascunho, alterá-lo enquanto ainda for rascunho, enviá-lo agora ou em um horário futuro, listar os broadcasts do espaço de trabalho, consultar um com seus contadores, cancelar um que esteja agendado ou em envio, excluir um que ainda esteja em rascunho, e consultar seus destinatários, eventos, links clicados, a cota de envio que um envio consumiria e as contagens de audiência contra as quais um envio é resolvido. Para uma lista de destinatários avulsa, use envio em lote ou envios individuais.
Crie um rascunho
Comece na lista de Broadcasts com New broadcast. O compositor é uma página única: uma barra de audiência e remetente no topo, o conteúdo do e-mail abaixo, e um controle de configurações para categoria, rastreamento e tags. Não há etapa de salvamento separada. Toda alteração é salva automaticamente assim que o broadcast tem uma audiência e um remetente, então um rascunho existe assim que esses dois são definidos, e enviá-lo depois é uma ação separada e explícita.
Use o campo To para escolher uma audiência, ou selecione New para criar uma sem sair do compositor.
Abra o controle de configurações no cabeçalho do compositor para mais três itens:
- As chaves de rastreamento de abertura e clique.
- Até 20 tags, cada uma com um nome e um valor, para filtrar esse broadcast depois.
- A categoria, cujo padrão é
marketing.
O endereço de remetente
Um broadcast envia a partir de um endereço em um domínio de envio verificado. Combine uma parte local com um dos seus domínios verificados e adicione um nome de exibição se quiser. Adicione um endereço Reply-To se quiser direcionar as respostas para outro lugar. Selecionar Review avisa você se o domínio não estiver verificado.
O template
Um broadcast aponta para um dos templates de e-mail do seu espaço de trabalho, e o template contém o assunto e o corpo que o broadcast envia. As propriedades de contato de cada destinatário preenchem as variáveis do template quando o envio é executado, então um único broadcast personaliza o conteúdo por destinatário. Um broadcast só pode preencher propriedades de contato, então uma variável de template que referencia qualquer outra coisa é recusada quando você envia, e o erro nomeia a variável.
Escreva o conteúdo diretamente no canvas abaixo do assunto, ou selecione Choose a template para começar a partir de um existente. Essa opção só fica disponível enquanto o broadcast está em branco, já que escolher um template depois de ter escrito um assunto ou corpo o sobrescreveria. Um broadcast envia a versão publicada do template, então um template que só tem rascunho não pode sustentar um envio.
Um template com mais de um idioma envia um deles para toda a audiência. Informe-o como template.language ao criar ou atualizar o broadcast, e omita-o para enviar o idioma padrão do template. Alterar apenas o idioma mantém o broadcast na versão à qual ele está fixado, quando já tiver uma. Um broadcast é fixado a uma versão quando é preparado para envio, então um broadcast agendado envia a versão publicada naquele momento, independentemente de você alterar o idioma antes disso.
Enviar ou agendar
O envio é uma ação separada e explícita, disponível pelo botão Review do compositor ou pela página de detalhes do broadcast em Send or reschedule. Cada um abre um diálogo que verifica se o broadcast está completo, avisa sobre qualquer coisa que possa causar falha no envio e permite escolher Send now ou selecionar um horário com até um ano de antecedência. Um broadcast agendado permanece editável, e você pode reagendá-lo até o momento em que o envio realmente começa.
O envio verifica se a audiência ainda tem alguém para alcançar. Uma audiência em que ninguém tem endereço de e-mail, ou em que todos os endereços estão suprimidos, é recusada nesse momento em vez de falhar depois.
Dois limites no nível da organização são verificados quando você envia.
O primeiro é quantos broadcasts você pode enviar em um período de cobrança. Seu plano define o número. Rascunhos salvos não contam, e cancelar um broadcast não devolve a cota. Depois que você a usa toda, ou espera o próximo período de cobrança ou muda para um plano com limite maior.
O segundo limita broadcasts simultâneos. Se você seleciona Send now enquanto o limite está atingido, a solicitação é rejeitada. Um broadcast agendado aguarda uma vaga livre.
Encontrar um broadcast
Pesquise a lista por tag ou nome de template, ou filtre por status, audiência ou intervalo de datas. O intervalo de datas filtra pela data de criação de cada broadcast, não pela data de envio. Assim, um broadcast que você agendou na semana passada para envio no mês que vem ainda aparece em "Last 7 days."
Exporte a visualização atual como CSV pelo botão acima da tabela, ou chame Exportar broadcasts como CSV, que aceita os mesmos filtros. Acima de 50.000 linhas, a exportação é recusada em vez de cortada silenciosamente. Restrinja os filtros e tente novamente.
Status do broadcast
Um broadcast está sempre em um de quatro estágios, e o filtro Status na lista usa esses quatro:
| Estágio | Onde o broadcast está | Valores de status |
|---|---|---|
| Rascunho | Salvo sem compromisso de envio | draft |
| Agendado | Confirmado com horário de envio futuro, ainda editável | scheduled |
| Enviando | A caminho, ou sendo cancelado | accepted, sending, canceling |
| Concluído | Finalizado, seja enviado, cancelado ou com falha | sent, canceled, failed |
O badge de cada linha mostra o status exato dentro do estágio. Esse mesmo valor é o que o campo status da API retorna.
Cancelar ou excluir
Cancele um broadcast agendado ou em envio pela página de detalhes, com bird email broadcasts cancel, ou com Cancelar um broadcast e o método broadcasts.cancel SDK. Destinatários ainda não alcançados são ignorados, e qualquer mensagem já a caminho não pode ser revogada. A exclusão funciona apenas em rascunhos e é permanente, pelas mesmas três vias: a página de detalhes, bird email broadcasts delete, ou Excluir um broadcast.
Quando um broadcast falha
Um broadcast com falha mostra o motivo na página de detalhes: a razão e, em seguida, uma frase indicando a causa exata. Pela API, esses dois são os campos failure_reason e failure_detail. failure_detail é o que indica qual das várias causas de uma razão você de fato encontrou.
A configuração de envio de um broadcast é verificada somente quando o envio começa. Se o domínio de envio estava verificado no agendamento, mas perdeu a verificação antes do envio, o broadcast falha nesse momento. Verifique o domínio e envie o broadcast novamente.
failure_reason | O que aconteceu | O que fazer |
|---|---|---|
content_invalid | Não foi possível preparar o broadcast para envio. A causa geralmente está na configuração, não no conteúdo: um domínio de envio não verificado, um template ausente ou não publicado, um template com loop, ou um pool de IPs indisponível | Corrija o que failure_detail indica e envie novamente |
empty_audience | A audiência não tem membros, ou as supressões excluem todos os membros | Adicione membros ou verifique suas supressões |
audience_unavailable | A audiência não existe mais | Aponte o broadcast para outra audiência |
quota_exceeded | O envio ultrapassou a cota diária ou mensal de e-mails da sua organização, seja antes de começar ou durante o envio | Aguarde a cota ser renovada, reduza a audiência ou faça upgrade |
insufficient_funds | O saldo do espaço de trabalho não cobriu o envio | Recarregue a carteira |
internal_error | Algo deu errado do nosso lado | Tente novamente e abra um ticket de suporte se o erro se repetir |
Broadcasts e envios únicos usam a mesma cota de e-mails. O cartão do plano na visão geral de cobrança da sua organização mostra quanto dela você já usou. Planos e preços descreve o que cada plano inclui.
Acompanhar a entrega
Assim que o envio começa, a aba Overview do broadcast mostra os contadores de destinatários e enviados, e depois as taxas de entrega, abertura, clique, bounce e reclamação com seus respectivos contadores. A aba Recipients lista cada destinatário com seu status de entrega, o motivo caso não tenha sido entregue, a data de entrega e suas aberturas e cliques. A caixa de busca exige um endereço de e-mail completo e válido; um endereço parcial ou apenas um domínio falha na validação, marca a caixa como inválida e mantém a tabela exibindo o que já estava. Um botão acima da tabela exporta a aba como CSV, e Exportar destinatários de um broadcast como CSV retorna o mesmo arquivo para uma chave API; ambos têm limite de 500.000 linhas, com o mesmo comportamento de recusar em vez de truncar da exportação da lista de broadcasts. A aba Events é o feed bruto de eventos do broadcast, usando os tipos de evento descritos em eventos e webhooks.
Ensaiar um broadcast
Coloque um endereço sandbox na audiência e esse contato será simulado em vez de receber o envio: delivered@messagebird.dev reporta como entregue, bounce@messagebird.dev como bounce, e cada um produz os mesmos eventos e webhooks que um destinatário real produziria. É assim que você exercita uma campanha, e o handler que lê seus eventos, sem enviar e-mail para ninguém. Uma audiência pode misturar contatos sandbox e reais; cada contato recebe seu próprio resultado. Um destinatário simulado ainda conta na sua cota de envio, então o ensaio consome a mesma cota que o envio real consumiria.
Próximos passos
- Audiências: as listas de destinatários para as quais um broadcast envia
- Templates de e-mail: o assunto e o corpo para os quais um broadcast aponta
- Métricas de e-mail: a visão geral do espaço de trabalho alimentada pelos broadcasts
bird email broadcasts: um comando CLI por operação de broadcast- Criar um broadcast: a referência API, com schemas completos de requisição e resposta e um exemplo de código por SDK
- Envios de email em massa: um email para toda a sua audiência: um vídeo que envia um broadcast e lê seus resultados
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.