Ръководството на Мокапен

ActiveCampaign Campaigns

Интеграцията ActiveCampaign Campaigns свързва вашия акаунт ActiveCampaign с Mokapen, за да синхронизира вече изпратени имейл кампании, свързаните им KPI (изпратени, отваряния, кликове) и действията на получателите (кой е отворил имейла, кой е кликнал връзка). Данните попадат в Маркетинг → Кампании, в отчетите и — ключово — в записа на контакта, където виждате дали това лице е отворило или кликнало кампания.

Това е входяща интеграция: данните текат от ActiveCampaign към Mokapen. Mokapen не създава и не променя кампании в ActiveCampaign.

Преглед: Интеграции. Модул назначение: Кампании.

Изисквания

• Акаунт ActiveCampaign с поне една вече изпратена кампания.
• API URL и API key от ActiveCampaign Settings → Developer (права за четене на кампании и данни от отчети).
• План Mokapen, който включва интеграцията (подходящ Premium план — икона на медал на страницата, ако не е налична).
• Модул Маркетинг → Кампании за преглед на списъка и KPI (включен в по-високи Premium планове, където е приложимо; иначе икона на медал на страницата).

Свързване на ActiveCampaign Campaigns

1. Потребителско меню → Интеграции → ActiveCampaign Campaigns.
2. Кликнете Sync ActiveCampaign Campaigns (нужен е подходящ Premium план).
3. Въведете API URL (напр. https://youraccount.api-us1.com) и API key, след това Connect.
4. Когато се появи Account connected, конфигурирайте посока на синхронизация, карта на полетата, дубликати/конфликти, автоматична синхронизация и поверителност.
5. Потвърдете упълномощяването за синхронизация и кликнете Save или Sync.

На страницата изрично е посочено: Only sent campaigns are synced. Чернови и планирани, но още неизпратени кампании не се импортират в Mokapen.

Какво се синхронизира

При първо свързване (и после с автоматична/ръчна синхронизация и webhooks) Mokapen импортира:

• Изпратени кампании — заглавие, статус, дати, тип, източник ActiveCampaign. Появяват се в Маркетинг → Кампании.
• KPI на кампаниите — обикновено изпратени, отваряния, кликове (агрегирана статистика на изпращане).
• Действия на абонати — за всеки получател с релевантни взаимодействия Mokapen синхронизира отваряния и кликове по кампанията.
• Контакти / lead на кампании — ако имейлът на абоната съвпада с съществуващ контакт (или се създава/актуализира според картата и правилата за дубликати), ангажираността се свързва с този запис и кампанията.

На практика синхронизацията на активност обхваща абонати, които са отворили или кликнали (не се импортират тези без взаимодействие). При активна автоматична синхронизация отварянията и кликовете могат да пристигат и в почти реално време чрез ActiveCampaign webhooks (open, click).

Посоката на синхронизация е само към Mokapen (еднопосочно): не експортирате кампании от Mokapen към ActiveCampaign.

Настройки за конфигуриране

Посока на синхронизация

Налична само към Mokapen (входяща). Няма двупосочна синхронизация на кампании.

Карта на полетата

В секцията Connect fields съпоставете полета на ActiveCampaign с полета за контакт в Mokapen. Email е задължителен и обикновено вече е свързан: без имейл ангажираността не се свързва с CRM. Всяка колона в Mokapen може да се използва само веднъж; оставете празно («skip») за това, което не ви трябва.

Дубликати и конфликти

• Avoid duplicates — сравнение по имейл: ако получателят вече съществува в Директорията, Mokapen актуализира този запис вместо да създаде втори.
• Manage conflicts — при разлика в същите съпоставени полета изберете дали ActiveCampaign или Mokapen има предимство.

Автоматична синхронизация и поверителност

• Automatic sync — периодични актуализации + webhook събития при отваряния/кликове (ако е активно и интеграцията не е на пауза).
• Manual sync — стартирате синхронизация, когато е нужно.
• Privacy — видимост на импортираните данни (публично за членове или ограничено до избрани collaborators), както при други маркетинг интеграции.

Само който е свързал акаунта (или е получил споделено управление на синхронизация) може да променя настройки, да синхронизира или да прекъсне.

Къде виждате данните

• Маркетинг → Кампании — списък на имейл кампании от ActiveCampaign с източник, статус, KPI (изпратени / отваряния / кликове) и свързани lead, заедно с Ads и други бюлетини.
• Reports → Campaigns — сравнения по източник и период (бюлетин срещу Ads, ефективност по кампания).
• Запис на контакт → timeline / updates — дали контактът е отворил или кликнал кампания (с име на кампанията и колко пъти), филтрируемо и по маркетинг канал.
• Запис на контакт → Connections → Campaigns — кампанията остава свързана с контакта като свързан обект.

Какво виждате на контакта (отваряния и кликове)

Това е оперативната стойност на синхронизацията: не само общи суми в Кампании, а индивидуално поведение.

• Отворете контакт в Директорията.
• В timeline (updates / marketing) се появяват записи като: контактът е отворил «Име на кампания» N пъти, или е кликнал «Име на кампания» N пъти.
• Контактът може да има свързана кампания / източник към този бюлетин, така че продажби и маркетинг знаят от кое изпращане идва интересът.

Пример: изпращате продуктов бюлетин → в Маркетинг → Кампании виждате общи отваряния и кликове → отворите контакт «Maria Rossi» и в timeline четете, че е отворила кампанията и е кликнала връзката: можете да я обадите или да възложите follow-up без да отваряте ActiveCampaign.

Автоматизации

Няма отделен trigger «ActiveCampaign campaign open», но контакти, създадени или актуализирани от ангажираност (когато синхронизацията създава/актуализира записа) могат да хранят автоматизации за контакти (напр. Contact Created / Contact Created or Modified), ако планът включва автоматизации. Полезно да възложите търговец или да създадете follow-up дейност за кликнали.

Ограничения

• Само изпратени кампании — чернови и планирани, но още неизпратени, не се синхронизират.
• Само входяща — не променяте кампании в ActiveCampaign от Mokapen.
• Релевантна ангажираност — обикновено се импортират отворили или кликнали; без взаимодействие няма ред активност по кампания.
• Задължителен имейл — без съпоставен имейл свързването с CRM контакт не работи.
• API credentials — нужни са валидни API URL + API key от ActiveCampaign Developer settings; грешен или регенериран key прекъсва връзката.
• Модул Кампании на по-висок план — свързването изисква подходящ Premium план; прегледът Маркетинг → Кампании може да изисква по-високо ниво (икона на медал на страницата).

Чести проблеми

• Няма кампании в списъка — проверете изпратени кампании в ActiveCampaign, че синхронизацията е стартирана и че модулът Кампании е наличен на вашия план.
• Connection failed — грешен API URL, изтекъл/регенериран API key или недостатъчни права: копирайте credentials от Settings → Developer, disconnect и reconnect.
• Не виждам отваряния/кликове на контакта — проверете картата на имейл, че абонатът наистина е взаимодействал и че записът е със същия имейл; повторете sync или изчакайте webhooks при активна автоматична синхронизация.
• Дубликати в Директорията — включете «Avoid duplicates» и проверете картата на имейл преди масова синхронизация.
• Не мога да променя настройките — само свързалият (или със споделен sync) управлява страницата; помолете този потребител или Owner.

Прекъсване

От Integrations → ActiveCampaign Campaigns кликнете Disconnect. В прозореца можете да изберете да запазите Кампаниите, вече синхронизирани в Mokapen. Контактите и записите в timeline, вече създадени, не се изтриват автоматично при disconnect. За потвърждение въведете изисквания текст в модала.

Примери за употреба

• Follow-up на кликнали — след бюлетин филтрирайте контакти с кликове в timeline и ги възложете на търговец за обаждане.
• KPI на бюлетини на едно място с Ads — сравнявайте отваряния/кликове ActiveCampaign с разход/кликове Facebook или Google в Маркетинг → Кампании и в отчети, без три конзоли.
• История на ангажираност на записа — търговецът отваря контакта и вижда кои кампании е отворил или кликнал през последните месеци, преди обаждането.
• Атрибуция на кампания — контактът остава свързан с изходната кампания: знаете кое изпращане е генерирало интерес.
• Ангажираност почти в реално време — с автоматична синхронизация и webhooks отварянията и кликовете се появяват на контакта скоро след взаимодействието.

Често задавани въпроси

В: Какво се синхронизира?

О: Изпратени имейл кампании, агрегирани KPI (изпратени, отваряния, кликове) и действия на получатели (opened / clicked), свързани с CRM контакти при съпоставен имейл.

В: Къде виждам дали контакт е отворил или кликнал?

О: В записа на контакта, в timeline / updates (и в connections към кампании). Появяват се името на кампанията и колко пъти е отворил или кликнал.

В: Свързване с OAuth или API key?

О: С API URL + API key от ActiveCampaign Settings → Developer (не OAuth).

В: Защо не виждам чернови?

О: Синхронизират се само вече изпратени кампании.

В: Mokapen променя ли кампаниите ми в ActiveCampaign?

О: Не. Интеграцията е read-only към Mokapen.

В: Какъв план ми трябва?

О: Подходящ Premium план за свързване; модул Маркетинг → Кампании може да изисква по-високо ниво. Ако функция липсва, на страницата се показва икона на медал.

В: Какво става при disconnect?

О: Можете да изберете дали да запазите вече импортираните кампании. Контактите и историята open/click в CRM остават.