Что это
Unisender API, или API Юнисендер, - способ управлять email-рассылками из своей программы. Вместо ручного переноса базы можно передавать контакты с сайта, распределять их по спискам и получать статистику кампаний. Это интерфейс сервиса рассылок, а не нейросеть.
Он полезен, когда письмо должно быть частью бизнес-процесса: клиент оставил заявку, согласился на рассылку, попал в нужный список. Методы создания сообщений и запуска кампаний позволяют автоматизировать дальнейшую отправку. Правила отбора получателей и подтверждение запуска задаёт ваша интеграция.
Здесь рассматривается классический API Unisender с параметром api_key. Не путайте его с Unisender Go для транзакционных писем: у него отдельная документация и правила подключения. Если нужен AI-черновик, подключите модель отдельно, проверьте текст и только затем передавайте его в рассылку.
Ключевые параметры
- Категория: Автоматизация
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Нужно оценивать отдельно
Сильные стороны
- Списки, контакты и дополнительные поля можно синхронизировать программно, без регулярного импорта таблиц вручную.
- Создание сообщения и запуск кампании можно разделить: интеграция сначала готовит данные и получает подтверждение, затем отправляет.
- Статистика кампаний доступна через API, поэтому отчёт можно собирать в своей системе.
- Есть русская документация и русскоязычные сообщения об ошибках при использовании адреса /ru/api/.
- Подключение можно проверить методом getLists: он читает списки и не запускает рассылку.
Ограничения
- Это не генератор текстов: AI-редактирование и анализ писем требуют отдельно подключённой модели или другого продукта.
- Лимиты контактов и отправок зависят от тарифа. У API есть общий предел частоты запросов и более строгие ограничения отдельных методов.
- API-ключ даёт доступ к данным аккаунта. Передача его в URL оставляет риск утечки через журналы; для классического API используйте POST и скрывайте секреты в логах.
- Наличие API не обеспечивает доставку во входящие: нужно настроить отправителя, следить за качеством базы и учитывать отписки.
- Отправку и повторы после ошибок нужно контролировать самостоятельно. HTTP 200 ещё не означает успешную операцию: проверьте тело ответа на error и предупреждения.
Как использовать
1. Подготовьте аккаунт Unisender и создайте в нём пустой список ezGPT-API-test. Не добавляйте реальные контакты: первый тест не должен отправлять письма.
2. В аккаунте откройте Настройки → Интеграция и API. Если доступ выключен, включите его, затем раскройте API-ключ. Сохраните его как секрет UNISENDER_API_KEY в приватном HTTP-клиенте или серверной интеграции.
3. В HTTP-клиенте, например Postman, создайте POST-запрос на https://api.unisender.com/ru/api/getLists. Выберите Body → x-www-form-urlencoded. Добавьте format со значением json и api_key со значением {{UNISENDER_API_KEY}}. Не используйте Authorization: Bearer и не отправляйте эти поля как JSON.
4. Выполните запрос. В JSON должен появиться result - массив объектов с id и title. Найдите название ezGPT-API-test и сохраните его id в настройках интеграции. Пустой result допустим, если списков нет, но в нашем тесте созданный список должен быть найден.
5. Проверьте отсутствие error и прочитайте warnings, если они есть. invalid_api_key означает проблему с ключом; access_denied - с доступом. При ограничении частоты уменьшите число запросов. Повторите getLists один раз и убедитесь в кабинете, что список остался пустым и новая кампания не появилась.
6. Первый результат готов: интеграция читает нужный список и знает его идентификатор. Затем отдельно настройте передачу подписавшихся контактов и проверку отписок. Запуск отправки вынесите в отдельный шаг с подтверждением; повтор не должен создавать вторую кампанию.
Примеры сценариев
- Первый тест: getLists возвращает, например, {"result":[{"id":12345,"title":"ezGPT-API-test"}]}. 12345 - вымышленный идентификатор; используйте значение из своего ответа.
- Форма сайта: интеграция проверяет согласие на рассылку, передаёт контакт и сохраняет результат операции. AI для переноса данных не нужен.
- Отчёт: getCampaignCommonStats возвращает показатели кампании. Интеграция показывает числа менеджеру; открытие письма не равно покупке.
- AI-черновик: внешняя модель готовит текст без передачи полной базы получателей. Человек проверяет текст и аудиторию, после чего интеграция запускает рассылку.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Да
- Русский язык: Не известно
У Unisender есть русский интерфейс и рублёвые тарифы. На дату проверки Фри ограничен 100 контактами и 1500 письмами в месяц. Платные варианты зависят от размера базы или объёма писем; нужные API-методы и доступ проверяйте в своём аккаунте. Отдельный пробный период здесь не подтверждён. Доступ из конкретной сети и оплата конкретной картой не тестировались.
Какой тариф выбрать
- Для знакомства начните с Фри и пустого тестового списка: можно проверить подключение, не запуская массовую отправку.
- Для регулярной рассылки сравните тарифы по числу активных контактов и объёму писем, а не только по месячной цене.
- Для нерегулярных кампаний проверьте вариант оплаты за письма и его условия. Разработку интеграции и вызовы внешней модели учитывайте отдельно.
Когда не подходит
- Рассылки по купленной или случайно собранной базе без согласия получателей.
- Хранение API-ключа в коде страницы, публичной таблице или промпте модели.
- Использование примеров Unisender Go без адаптации к классическому API.
Альтернативы
Mailchimp Marketing API и Brevo API - альтернативы для управления маркетинговыми контактами и кампаниями; доступность и оплату проверяйте отдельно. SMTP подходит для отправки писем из приложения, но не заменяет API списков, сегментов и отчётов по кампаниям. Перенос базы и согласий между сервисами требует отдельной проверки.
