API та інтеграції
Підключення SendPulse крок за кроком
Як дати кожному підписнику SendPulse персональне посилання на вашому домені під захистом Anti-Bot фільтра. Перший раз — хвилин 15, далі — дві команди перед кожною розсилкою.
Створюйте свіжі коди на кожну розсилку. Код живе 60 днів і відкриває сторінку до 3 разів, тож посилання, один раз записане в поле підписника й використане через місяці, перестане працювати.
1Назва змінної: cl_link
У SendPulse додаткові дані підписника — це змінні адресної книги. Заздалегідь нічого створювати не треба: змінну cl_link (тип «Рядок») ви створите під час імпорту на кроці 6. Назва має збігатися точно, з урахуванням регістру, — інакше SendPulse не підставить посилання в лист.
2Візьміть посилання й ключ
У кабінеті createlink.link створіть посилання, куди має вести розсилка, або візьміть наявне — його номер це LINK_ID. Потім відкрийте меню акаунта → API і створіть ключ із назвою «SendPulse» — це YOUR_KEY.
3Вивантажте одержувачів з SendPulse
Вивантажте список чи сегмент, на який будете відправляти, у файл 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Заберіть файл для SendPulse
Підставте job_id у команду. Файл вийде з тими назвами колонок, яких чекає SendPulse.
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Імпортуйте файл у ту саму адресну книгу
Відкрийте адресну книгу, на яку відправляєте, → додати контакти → «Завантажити файл» і виберіть links.csv. Колонку email зіставте з email, для колонки cl_link створіть нову змінну cl_link типу «Рядок». Обов’язково ввімкніть «Оновити значення змінних для наявних контактів» — інакше підписники, що вже є в книзі, лишаться зі старим посиланням. Потім натисніть «Додати».
7Вставте посилання в лист
У редакторі листа вставте мітку {{cl_link}} як адресу кнопки чи посилання — вручну або через кнопку «Змінні». У HTML це виглядає так:
<a href="{{cl_link}}">…</a>
8Перевірте відстеження посилань
Коли в SendPulse увімкнене відстеження, кожне посилання в листі загортається в домен відстеження (за замовчуванням — stat-pulse.com), і одержувачі бачать його замість вашого домену. Вимкніть відстеження посилань для цієї розсилки. Довідка SendPulse не описує, де саме це налаштування, тож перевірте результат у тестовому листі (наступний крок): посилання має починатися з вашого домену.
9Надішліть тест собі
Додайте свою адресу до списку перед кроком 3, надішліть тест і перевірте: посилання в листі починається з вашого домену, а клік відкриває вашу сторінку. Лише після цього запускайте розсилку.