Что это
Mailchimp Marketing API позволяет программе работать с аудиториями, кампаниями и результатами email-маркетинга в Mailchimp. Его используют для синхронизации данных с CRM и подготовки отчетов. Это не Mailchimp Transactional API и не отдельная языковая модель.
Возможности зависят от тарифа и прав учетной записи. Ключ нельзя ограничить отдельными endpoints или сделать только читающим: обращаться с ним нужно как с паролем. Для клиентской интеграции с чужим аккаунтом предусмотрен OAuth.
По действующим условиям Mailchimp Россия включена в ограничения допустимости использования сервиса. Для бизнеса в России это нельзя рекомендовать как доступный способ запуска рассылок. Описанный ниже учебный сценарий относится к аккаунтам, которые соответствуют условиям сервиса, и не включает отправку писем.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Кампании и аудитории доступны для программной синхронизации.
- Список кампаний поддерживает выбор статуса, полей и постраничную загрузку.
- Для интеграций с чужими аккаунтами предусмотрен OAuth.
- Можно начать с чтения черновиков и проверки подключения без отправки писем.
Ограничения
- Условия сервиса ограничивают использование для пользователей, находящихся в России.
- API-ключ не имеет ограничения только на чтение или отдельные endpoints.
- Функции API зависят от плана и прав аккаунта; наличие ключа не включает все возможности.
- Есть лимиты запросов; дубли контактов, отписки и отправку нужно контролировать в своей интеграции.
Как использовать
1. Подготовка. Проверьте, соответствует ли аккаунт условиям сервиса; для аккаунта из России этот маршрут не подходит. В разрешенном аккаунте создайте учебный черновик кампании без отправки и запишите его название.
2. Настройка. Получите API-ключ для своего аккаунта и определите его data center: например, us6 из суффикса ключа. Используйте https://{dc}.api.mailchimp.com/3.0 и HTTP Basic Auth с произвольным именем пользователя и ключом как паролем. Держите ключ только на сервере.
3. Первый результат. Выполните GET /ping для проверки подключения, затем GET /campaigns?status=save&count=5 для списка черновиков. Сохраните их ID и названия в учебный отчет. Не вызывайте send и не изменяйте подписчиков.
4. Проверка. Сверьте полученные черновики с интерфейсом. Пустой список не подтверждает сбой авторизации: проверьте статус и аккаунт. Для полной выгрузки используйте offset и total_items, учитывайте ошибки и 429. Перед будущей записью проверьте согласия, отписки и защиту от повторных действий.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Работа в РФ: Нет
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Есть бесплатный план Mailchimp, но доступные функции и лимиты зависят от плана. Россия указана в ограничениях текущих Standard Terms of Use; VPN или наличие ключа не подтверждают допустимость использования. Для российского бизнеса сначала рассмотрите сервис с подходящими условиями.
Когда не подходит
- Запустить сервис для аккаунта из России вопреки условиям
- Раздавать API-ключ фронтенду или мобильному приложению
- Отправлять кампанию без проверки согласий и отписок
Альтернативы
Unisender API стоит рассмотреть для интеграции с рассылками Unisender, проверив свой тариф. Brevo API работает с другой маркетинговой платформой и имеет собственные региональные условия. SMTP решает отправку через выбранного провайдера, но не заменяет управление аудиториями и аналитику Mailchimp.
