Синхронизация отписок с CRM

Клиент отписался в личном кабинете вашего сайта: Mailganer должен перестать ему писать. Отписался по ссылке в письме или нажал "Это спам": ваша CRM должна об этом узнать. Ниже оба направления.

Из вашей системы в Mailganer

POST /api/v2/emails/unsubscribe/:

curl --location 'https://mailganer.com/api/v2/emails/unsubscribe/' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "buyer@example.com",
    "source": "all"
}'

"source": "all" отписывает из всех списков, вместо него можно передать ID списка или массив ID. Ответ {"email_status": "unsubscribe"}. Если адреса нет в списке, придёт 404 и "Не найдено.".

Из Mailganer в вашу систему

Mailganer отправляет POST на ваш адрес каждый раз, когда у подписчика меняется статус.

1. Подключите вебхук в настройках списка на вкладке "Интеграции" или методом POST /api/v2/sites/set_webhook:

curl --location 'https://mailganer.com/api/v2/sites/set_webhook' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 49767,
    "url": "https://crm.example.com/mailganer/hook",
    "is_active": true,
    "is_use_auth_key": true,
    "is_enable_retry": true
}'

Вебхук настраивается на список. Если списков несколько, подключите его на каждом.

2. Обработайте событие. Тело приходит как application/x-www-form-urlencoded:

type=1
email=buyer@example.com
status=-1
method=unsubscribe
source_id=49767
source_name=Покупатели
timestamp=2026-10-05 15:26:19.654599

Для синхронизации отписок смотрите на type=1 и status. При отписке приходит ещё reason, причина отписки.

status	Что произошло
-1	Отписался
-3	Пожаловался на спам
-2	Адрес недоступен

Остальные значения и другие типы событий описаны в методе вебхука.

3. Ответьте 200. С is_enable_retry: true при ошибке Mailganer повторит отправку через 5 секунд, 1 час и 24 часа. С is_use_auth_key: true в заголовке Authorization придёт ключ авторизации: по нему проверяйте, что запрос пришёл от Mailganer.