Документация / Каналы

ListMonk

Подключите списки своего сервера рассылок ListMonk и отправляйте посты письмами подписчикам.

English version · API для разработчиков

Содержание

ListMonk — сервер email-рассылок, который вы ставите у себя. Канал followers.vc — это один список рассылки, а пост превращается в кампанию: письмо всем подписчикам этого списка. Общие вещи о каналах описаны в разделе Каналы: обзор.

Что можно публиковать

  • Текст и ссылка — письмо из подписи. Для ссылки адрес добавляется в конец письма после пустой строки.
  • Изображения — до 10, они идут в конце письма.

Как подпись превращается в письмо:

  1. Первая непустая строка — тема письма.
  2. Всё, что ниже, — текст письма в Markdown, оформленный шаблоном сервера по умолчанию.

Тема не может быть пустой.

Перед началом

Нужен ListMonk версии 4 или новее, открытый из интернета по https. В ListMonk откройте Admin → Users, создайте пользователя типа API с доступом к кампаниям и спискам и скопируйте его токен.

Токен хранится вместе с каналом и отправляется только на ваш сервер ListMonk.

Подключение

  1. Откройте Каналы и нажмите Добавить каналы.
  2. В карточке ListMonk нажмите ListMonk. Если карточки нет, канал ещё не включил администратор сайта.
  3. На странице Подключить списки ListMonk введите адрес сервера, пользователя API и токен и нажмите Подключить. Сервис проверяет доступ, читая списки сервера.
  4. На странице Добавьте новые каналы отметьте нужные списки и нажмите Добавить новый. Каждый список становится отдельным каналом.

Настройки в редакторе поста

Когда выбран канал ListMonk, под полем текста появляется блок ListMonk с флажком Создать кампанию, но не отправлять. С ним кампания появится в ListMonk черновиком — проверьте её и запустите там сами.

Если что-то не работает

  • Сервер ListMonk должен открываться по https. — адрес начинается с http://; включите https на сервере.
  • Если токен не подошёл, сервис показывает ответ ListMonk. Проверьте пользователя API и его права.
  • На сервере ListMonk пока нет списков. — создайте список в ListMonk и подключите снова.
  • ListMonk создал кампанию, но не запустил её. — кампания уже есть в ListMonk черновиком; причина указана в сообщении. Запустите её в ListMonk, повторная публикация создала бы вторую.
  • У канала ListMonk нет ключа API. Переподключите его. — нажмите Переподключить на карточке канала.