Envio para audiências
Um e-mail para todos em uma ou mais audiências, uma cópia separada para cada pessoa.
Ferramentas de envio para audiências
| Ferramenta | O que faz |
|---|---|
| previewAudienceSend | Quantas pessoas um envio para estas audiências alcançaria, antes de se enviar alguma coisa, com quantas seriam ignoradas por terem cancelado a subscrição e quantas por o endereço estar suprimido. Uma pessoa em várias das audiências conta uma vez. |
| sendToAudience | Envia um e-mail de um dos seus endereços para todos em até 10 audiências, cada pessoa com a sua própria cópia. Aceita html ou text com campos de fusão como {{firstName|there}}, ou um modelo, e uma hora de envio opcional. Responde de imediato e o envio continua em segundo plano. |
| listBroadcasts | Os envios para audiências a partir desta caixa, do mais recente para o mais antigo, com o ponto a que cada um chegou, uma página de cada vez. Indique uma audiência para ver só os envios que a incluíram. |
| getBroadcast | Um envio e o ponto a que chegou: para quantas pessoas era, quantas cópias estão à espera, foram enviadas, falharam ou foram canceladas, e quantas pessoas foram ignoradas. |
| cancelBroadcast | Para um envio. Cada cópia que ainda não saiu é cancelada e ninguém mais é adicionado. As cópias já enviadas não podem ser recuperadas. |
Cada cópia é um e-mail normal endereçado a uma só pessoa, por isso ninguém vê para quem mais foi, e cada uma tem o seu próprio seguimento e webhooks. As cópias não são arquivadas em Enviados: o envio é o registo, e getBroadcast é a forma de o acompanhar.
Os campos de fusão são {{firstName}}, {{lastName}}, {{name}}, {{email}} e {{unsubscribeUrl}}, cada um com um valor alternativo opcional depois de uma barra. Cada cópia leva um cabeçalho para cancelar a subscrição com um clique, e um corpo que não coloque {{unsubscribeUrl}} por si recebe uma curta linha para cancelar a subscrição no fim. Quem cancela a subscrição fica marcado como tal em todas as audiências para onde esse envio foi, e os envios seguintes para essas audiências ignoram-no, tal como ignoram os endereços na lista de supressão.
O envio inteiro é comparado com o plano antes de sair qualquer coisa, por isso um envio que o plano não consegue cobrir é recusado em vez de parar a meio. Nada torna seguro repetir sendToAudience, por isso depois de uma resposta perdida consulte listBroadcasts antes de tentar de novo.
sendToAudience precisa de emails:send e audiences:read, previewAudienceSend precisa de audiences:read, listBroadcasts e getBroadcast precisam de emails:read, e cancelBroadcast precisa de emails:send. O assistente da aplicação pergunta sempre antes de sendToAudience, e pergunta antes de cancelBroadcast a não ser que o tenha pedido. Quem só tem acesso a alguns endereços envia só para os contactos que adicionou.