Zur Dokumentation springen
MCP-Server

An Audiences senden

Eine E-Mail an alle in einer oder mehreren Audiences, eine eigene Kopie für jede Person.

Tools zum Senden an Audiences

ToolWas es tut
previewAudienceSendWie viele Menschen eine Sendung an diese Audiences erreichen würde, bevor irgendetwas gesendet wird, mit der Zahl derer, die übersprungen würden, weil sie sich abgemeldet haben, und derer, deren Adresse gesperrt ist. Eine Person in mehreren der Audiences zählt einmal.
sendToAudienceSendet eine E-Mail von einer Ihrer Adressen an alle in bis zu 10 Audiences, jede Person bekommt eine eigene Kopie. Nimmt html oder text mit Platzhaltern wie {{firstName|there}} oder eine Vorlage, dazu einen optionalen Sendezeitpunkt. Antwortet sofort, und der Versand läuft im Hintergrund weiter.
listBroadcastsDie Sendungen an Audiences aus diesem Postfach, die neueste zuerst, mit dem Fortschritt jeder einzelnen, Seite für Seite. Nennen Sie eine Audience, um nur die Sendungen zu sehen, die sie einschlossen.
getBroadcastEine Sendung und ihr Fortschritt: für wie viele Menschen sie war, wie viele Kopien warten, gesendet, fehlgeschlagen oder abgebrochen sind, und wie viele Menschen übersprungen wurden.
cancelBroadcastStoppt eine Sendung. Jede Kopie, die noch nicht hinausgegangen ist, wird abgebrochen, und niemand wird mehr hinzugefügt. Bereits gesendete Kopien lassen sich nicht zurückholen.

Jede Kopie ist eine gewöhnliche E-Mail an eine einzige Person, sodass niemand sieht, an wen sie sonst ging, und jede hat eigenes Tracking und eigene Webhooks. Die Kopien werden nicht unter „Gesendet“ abgelegt: Die Sendung ist der Nachweis, und getBroadcast ist der Weg, sie zu verfolgen.

Die Platzhalter sind {{firstName}}, {{lastName}}, {{name}}, {{email}} und {{unsubscribeUrl}}, jeweils mit einem optionalen Ersatzwert nach einem Strich. Jede Kopie trägt einen Ein-Klick-Abmelde-Header, und ein Text, der {{unsubscribeUrl}} nicht selbst platziert, bekommt am Ende eine kurze Abmeldezeile. Wer sich abmeldet, wird in jeder Audience, an die diese Sendung ging, als abgemeldet markiert, und spätere Sendungen an diese Audiences überspringen ihn, so wie sie Adressen auf der Sperrliste überspringen.

Die ganze Sendung wird mit dem Plan abgeglichen, bevor irgendetwas hinausgeht, sodass eine Sendung, die der Plan nicht abdecken kann, abgelehnt wird, statt auf halbem Weg stehen zu bleiben. Nichts macht ein wiederholtes sendToAudience sicher, lesen Sie also nach einer verlorenen Antwort listBroadcasts, bevor Sie es erneut versuchen.

sendToAudience braucht emails:send und audiences:read, previewAudienceSend braucht audiences:read, listBroadcasts und getBroadcast brauchen emails:read, und cancelBroadcast braucht emails:send. Der Assistent in der App fragt immer vor sendToAudience nach und vor cancelBroadcast, sofern Sie es nicht selbst verlangt haben. Wer nur auf einige Adressen Zugriff hat, sendet nur an die Kontakte, die er selbst hinzugefügt hat.