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, надішліть тест і перевірте: посилання в листі починається з вашого домену, а клік відкриває вашу сторінку. Лише після цього запускайте розсилку.
