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 /v1/email/broadcasts ou com a bird email broadcasts. Os SDKs não incluem métodos de broadcast. Para uma lista de destinatários avulsa, use envio em lote ou envios individuais.

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 existe uma etapa separada de salvamento. 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:

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 respostas para outro lugar. Selecionar Review avisa se o domínio não está verificado.

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 do contato de cada destinatário preenchem as variáveis do template quando o envio é executado, então um broadcast personaliza seu 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 informa o nome da variável.

Escreva o conteúdo diretamente na área de edição abaixo do assunto, ou selecione Choose a template para começar a partir de um existente. Essa opção só está disponível enquanto o broadcast está em branco, já que escolher um template depois de ter escrito um assunto ou um corpo sobrescreveria o conteúdo. Um broadcast envia a versão publicada do template, então um template que só tem rascunho não pode ser usado para um envio.

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 fazer o envio falhar e permite escolher Send now ou selecionar um horário até um ano à frente. Um broadcast agendado continua editável, e você pode reagendá-lo até o momento em que o envio de fato 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 ponto 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 faturamento. Seu plano define o número. Rascunhos salvos não contam para esse limite, e cancelar um broadcast não devolve a cota. Depois de esgotá-la, você espera pelo próximo período de faturamento ou muda para um plano com limite maior.

O segundo limita broadcasts simultâneos. Se você selecionar Send now enquanto o limite está atingido, a solicitação é rejeitada. Um broadcast agendado aguarda um slot livre.

Pesquise a lista por tag ou nome de template, ou filtre por status, audiência ou um intervalo de datas. O intervalo de datas filtra pela data de criação de cada broadcast, não pela data de envio, então 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. Acima de 50.000 linhas, a exportação é recusada em vez de ser silenciosamente truncada. Refine os filtros e tente novamente.

Um broadcast está sempre em um de quatro estágios, e o filtro Status na lista usa esses quatro:

O badge de cada linha mostra o status exato dentro do seu estágio. Esse mesmo valor é o que o campo status da API retorna.

Cancele um broadcast agendado ou em envio pela sua página de detalhes. Destinatários que ainda não foram alcançados são ignorados, e qualquer mensagem já a caminho não pode ser revogada. Excluir só funciona em rascunhos e é permanente.

Um broadcast que falhou mostra o motivo na sua página de detalhes: a razão e depois uma frase identificando 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 só é verificada 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 ponto. Verifique o domínio e envie o broadcast novamente.

Broadcasts e envios individuais usam a mesma cota de e-mails. O cartão do plano na visão geral de faturamento da sua organização mostra quanto dela você já usou. Planos e preços cobre o que cada plano inclui.

Quando o envio começa, a aba Overview do broadcast mostra as contagens de destinatários e enviados, depois as taxas e contagens de entrega, abertura, clique, bounce e reclamação. A aba Recipients lista cada destinatário com seu status de entrega, o motivo caso não tenha sido entregue, quando foi entregue 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 um domínio falha na validação, marca a caixa como inválida e deixa a tabela mostrando o que mostrava antes. Um botão acima da tabela exporta a aba como CSV, limitado a 200.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.

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 para a sua cota de envio, então o ensaio consome a mesma cota que o envio real consumiria.