API и интеграции
Подключение MailWizz шаг за шагом
Как дать каждому подписчику MailWizz персональную ссылку на вашем домене под защитой Anti-Bot фильтра. Первый раз — минут 15, дальше — две команды перед каждой рассылкой.
Создавайте свежие коды на каждую рассылку. Код живёт 60 дней и открывает страницу до 3 раз, поэтому ссылка, один раз записанная в поле подписчика и использованная через месяцы, перестанет работать.
Ещё проще: ссылка с меткой
Если не хочется выгружать и импортировать списки, включите «Ссылка с меткой» на карточке ссылки и вставьте в письмо один адрес — MailWizz сама допишет метку каждого подписчика после r=, а персональный код создастся при первом клике.
<a href="https://YOUR-DOMAIN/CODE?r=[EMAIL]">…</a>
Нужен агент 2026.10.18-1 или новее. Каждый новый подписчик, который кликнул, стоит 1 ссылку, как любой код. Точную метку подписчика сверьте со списком доступных меток вашей платформы.
1Создайте поле {field}
Откройте Lists → ваш список → Fields и добавьте поле типа Text. Label — любой, напр. «Персональная ссылка»; Tag: CL_LINK.
2Возьмите ссылку и ключ
В кабинете createlink.link создайте ссылку, куда должна вести рассылка, или возьмите существующую — её номер это LINK_ID. Затем откройте меню аккаунта → API и создайте ключ с названием «MailWizz» — это YOUR_KEY.
3Выгрузите получателей из MailWizz
Выгрузите список или сегмент, на который будете отправлять, в файл CSV и сохраните как export.csv. Запомните, в какой колонке email — считая с 1.
4Создайте коды
Отправьте файл в createlink.link. Подставьте LINK_ID и YOUR_KEY; если email не в первой колонке — измените column=1.
curl -X POST "https://createlink.link/api/v1/links/LINK_ID/codes?column=1&skip_header=1" \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: text/csv" \ --data-binary @export.csv
В ответе будет job_id. До 1 000 получателей готовы сразу; больший список — от нескольких секунд до пары минут.
5Заберите файл для MailWizz
Подставьте job_id в команду. Файл выйдет с теми названиями колонок, которых ждёт MailWizz.
curl "https://createlink.link/api/v1/jobs/JOB_ID?format=csv&columns=EMAIL:ref,CL_LINK:url" \ -H "Authorization: Bearer YOUR_KEY" -o links.csv
Если партия ещё делается, вместо файла придёт короткий ответ со "status": "running" — повторите команду через минуту.
6Импортируйте файл в тот же список
Откройте список → Import → CSV и загрузите links.csv. MailWizz находит подписчиков по email: существующие получают новую ссылку, дублей не будет. Программист может сделать то же через API MailWizz, обновив подписчика с data[CL_LINK].
7Вставьте ссылку в письмо
В шаблоне кампании используйте метку [CL_LINK] как адрес ссылки. Она появляется среди Available Tags, только если поле есть в списке, выбранном для кампании:
<a href="[CL_LINK]">…</a>
8Отключите URL tracking
В настройках кампании поставьте URL tracking = «no» (в API MailWizz — options[url_tracking]=no). Иначе MailWizz подменит вашу ссылку своим адресом отслеживания, и получатели увидят его домен вместо вашего.
9Отправьте тест себе
Добавьте свой адрес в список перед шагом 3, отправьте тест и проверьте: ссылка в письме начинается с вашего домена, а клик открывает вашу страницу. Только после этого запускайте рассылку.
