Отправка аудиториям
Одно письмо всем в одной или нескольких аудиториях, отдельная копия каждому человеку.
Инструменты отправки аудиториям
| Инструмент | Что делает |
|---|---|
| previewAudienceSend | Скольких людей достигнет отправка этим аудиториям, ещё до того как что-либо будет отправлено, и сколько будет пропущено, потому что они отписались, и сколько — потому что их адрес подавлен. Человек, состоящий в нескольких аудиториях, считается один раз. |
| sendToAudience | Отправляет одно письмо с одного из ваших адресов всем в аудиториях, их может быть до 10, каждому человеку своя копия. Принимает html или text с полями слияния вроде {{firstName|there}} или шаблон, а также необязательное время отправки. Отвечает сразу, а отправка продолжается в фоне. |
| listBroadcasts | Отправки аудиториям из этого ящика, сначала новые, с тем, насколько продвинулась каждая, по одной странице. Укажите аудиторию, чтобы видеть только отправки, в которые она входила. |
| getBroadcast | Одна отправка и насколько она продвинулась: для скольких людей она была, сколько копий ждут, отправлены, не удались или отменены, и скольких людей пропустили. |
| cancelBroadcast | Останавливает отправку. Каждая копия, которая ещё не ушла, отменяется, и больше никто не добавляется. Уже отправленные копии вернуть нельзя. |
Каждая копия — обычное письмо одному человеку, поэтому никто не видит, кому ещё оно ушло, и у каждой своё отслеживание и вебхуки. Копии не складываются в «Отправленные»: запись — это сама отправка, а следить за ней можно через getBroadcast.
Поля слияния: {{firstName}}, {{lastName}}, {{name}}, {{email}} и {{unsubscribeUrl}}, у каждого может быть запасное значение после черты. Каждая копия несёт заголовок отписки в один щелчок, а текст, который сам не ставит {{unsubscribeUrl}}, получает в конце короткую строку отписки. Отписавшийся помечается как отписанный во всех аудиториях, куда ушла эта отправка, и последующие отправки этим аудиториям его пропускают, так же как пропускают адреса из списка подавления.
Вся отправка сверяется с тарифом до того, как что-либо уйдёт, поэтому отправка, которую тариф не покрывает, отклоняется, а не останавливается на полпути. Ничто не делает повторный sendToAudience безопасным, поэтому после потерянного ответа прочитайте listBroadcasts, прежде чем пробовать снова.
sendToAudience требует emails:send и audiences:read, previewAudienceSend требует audiences:read, listBroadcasts и getBroadcast требуют emails:read, а cancelBroadcast требует emails:send. Ассистент в приложении всегда спрашивает перед sendToAudience и спрашивает перед cancelBroadcast, если вы сами об этом не попросили. Тот, чей доступ ограничен некоторыми адресами, отправляет только добавленным им контактам.