Envois aux audiences
Un e-mail à tous les membres d'une ou plusieurs audiences, une copie distincte pour chaque personne.
Outils d'envoi aux audiences
| Outil | Ce qu'il fait |
|---|---|
| previewAudienceSend | Combien de personnes un envoi à ces audiences atteindrait, avant que rien ne soit envoyé, avec combien seraient ignorées parce qu'elles se sont désabonnées et combien parce que leur adresse est supprimée. Une personne présente dans plusieurs audiences compte une fois. |
| sendToAudience | Envoie un e-mail depuis l'une de vos adresses à tous les membres d'au plus 10 audiences, chaque personne recevant sa propre copie. Il prend html ou text avec des champs de fusion comme {{firstName|there}}, ou un modèle, et un moment d'envoi facultatif. Il répond immédiatement et l'envoi se poursuit en arrière-plan. |
| listBroadcasts | Les envois aux audiences depuis cette boîte, du plus récent au plus ancien, avec l'avancement de chacun, une page à la fois. Nommez une audience pour ne voir que les envois qui l'incluaient. |
| getBroadcast | Un envoi et son avancement : pour combien de personnes il était, combien de copies sont en attente, envoyées, en échec ou annulées, et combien de personnes ont été ignorées. |
| cancelBroadcast | Arrête un envoi. Chaque copie qui n'est pas encore partie est annulée et personne d'autre n'est ajouté. Les copies déjà envoyées ne peuvent pas être rappelées. |
Chaque copie est un e-mail ordinaire adressé à une seule personne, si bien que personne ne voit à qui d'autre il est parti, et chacune a son propre suivi et ses webhooks. Les copies ne sont pas classées dans Envoyés : l'envoi en fait foi, et getBroadcast permet de le suivre.
Les champs de fusion sont {{firstName}}, {{lastName}}, {{name}}, {{email}} et {{unsubscribeUrl}}, chacun avec une valeur de repli facultative après une barre. Chaque copie porte un en-tête de désabonnement en un clic, et un corps qui ne place pas {{unsubscribeUrl}} lui-même reçoit une courte ligne de désabonnement à la fin. Une personne qui se désabonne est marquée désabonnée dans chaque audience à laquelle cet envoi est parti, et les envois suivants à ces audiences l'ignorent, comme ils ignorent les adresses de la liste de suppression.
L'envoi entier est confronté à la formule avant que rien ne parte : un envoi que la formule ne peut pas couvrir est refusé au lieu de s'arrêter à mi-chemin. Rien ne rend sûr un sendToAudience répété : après une réponse perdue, lisez listBroadcasts avant de réessayer.
sendToAudience exige emails:send et audiences:read, previewAudienceSend exige audiences:read, listBroadcasts et getBroadcast exigent emails:read, et cancelBroadcast exige emails:send. L'assistant de l'application demande toujours avant sendToAudience, et demande avant cancelBroadcast sauf si vous l'avez demandé. Une personne dont l'accès est limité à certaines adresses n'envoie qu'aux contacts qu'elle a ajoutés.