Перейти к содержимому

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