Перейти до вмісту

API та інтеграції

Підключення Mumara крок за кроком

Як дати кожному підписнику Mumara персональне посилання на вашому домені під захистом Anti-Bot фільтра. Перший раз — хвилин 15, далі — дві команди перед кожною розсилкою.

Створюйте свіжі коди на кожну розсилку. Код живе 60 днів і відкриває сторінку до 3 разів, тож посилання, один раз записане в поле підписника й використане через місяці, перестане працювати.

Ще простіше: посилання з міткою

Якщо не хочеться вивантажувати й імпортувати списки, увімкніть «Посилання з міткою» на картці посилання і вставте в лист одну адресу — Mumara сама допише мітку кожного підписника після r=, а персональний код створиться при першому кліку.

<a href="https://YOUR-DOMAIN/CODE?r=%%email%%">…</a>

Потрібен агент 2026.10.18-1 або новіший. Кожен новий підписник, що клікнув, коштує 1 посилання, як будь-який код. Точну мітку підписника звірте зі списком доступних міток вашої платформи.

1Створіть поле {field}

У Mumara відкрийте Lists → Custom Fields → Add New. Назва: cl_link, тип: текст. У «Assign to Contact Lists» позначте список, на який відправляєте, — поле має значення лише в списках, до яких призначене. Назву потім не змінити, тож введіть її точно.

2Візьміть посилання й ключ

У кабінеті createlink.link створіть посилання, куди має вести розсилка, або візьміть наявне — його номер це LINK_ID. Потім відкрийте меню акаунта → API і створіть ключ із назвою «Mumara» — це YOUR_KEY.

3Вивантажте одержувачів з Mumara

Вивантажте список чи сегмент, на який будете відправляти, у файл 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Заберіть файл для Mumara

Підставте job_id у команду. Файл вийде з тими назвами колонок, яких чекає Mumara.

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Імпортуйте файл у той самий список

Імпортуйте контакти в той самий список. Колонку email зіставте з Email, колонку cl_link — з полем cl_link. Для дублікатів оберіть Update — наявні контакти знаходяться за email і отримують нове посилання.

7Вставте посилання в лист

Використайте мітку %%cl_link%% там, де має бути посилання, — адресою кнопки чи текстового посилання:

<a href="%%cl_link%%">…</a>

8Перевірте відстеження посилань

Якщо ваша Mumara переписує посилання в листах через власну адресу відстеження, вимкніть це для цієї розсилки — інакше одержувачі бачать домен відстеження замість вашого. Документація Mumara описує це налаштування нечітко, тож перевірте результат у тестовому листі (наступний крок).

9Надішліть тест собі

Додайте свою адресу до списку перед кроком 3, надішліть тест і перевірте: посилання в листі починається з вашого домену, а клік відкриває вашу сторінку. Лише після цього запускайте розсилку.