Altcraft: ИИ-агент для рассылок и профилей CDP

Altcraft — платформа клиентских данных с рассылками по email и SMS, у которой открыт список API-методов. Агент нужен клиентскому сервису, где профили и подписки живут в базе, а сегменты для писем собирают руками.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос: вы ставите задачу, а возвращается собранный сегмент или размеченные заявки.

Три признака: работает в ваших сервисах, доводит дело до результата, работает без вас — по расписанию, без нажатия кнопки.

От чат-бота он отличается этим: бот вернёт текст, который надо перенести, агент вернётся с тем, что уже лежит в базе.

Коннектор — описание подключения: где взять доступ, как проверить связь, какие данные агент увидит. В Altcraft доступ — токен из панели, коннектор фиксирует, какие методы им разрешены.

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

По документации Altcraft запросы идут методом POST на адрес api/v1.1 с именем метода в пути, формат — JSON или XML по заголовкам, кодировка UTF-8. В облаке адрес панели ru.altkraft.com, при установке на своё оборудование — свой. Методы закрывают профили, историю, связи, подписки, базы и ресурсы: есть массовый импорт, объединение и разделение профилей, выгрузка в файл, импорт в RabbitMQ. В ответе всегда есть error и error_text.

### Входящая корреспонденция: регистрация и резолюция

Агент забирает новые обращения, ищет профиль по адресу или телефону и дописывает тему и источник. Если профиля нет, он не создаёт дубль молча, а показывает кандидатов на объединение. В базу уходит запись с датой, каналом и резолюцией.

### Заявки из почты, форм и мессенджеров

Агент приводит заявки из разных каналов к одному виду и раскладывает по полям базы, проверяя обязательные. Если человек отписан, заявка всё равно регистрируется, но помечается. На выходе — список с пометками и перечнем неразобранного.

### Сводки по обращениям: день и месяц

Агент считает обращения по каналам и темам за день и месяц, тянет историю профилей и собирает сводку. Отдельно показывает, где данных не хватает: пустые поля, профили без подписки. Итог — таблица и короткий вывод.

Содержание рассылки, сегмент и решение по спорному профилю — за человеком. Агент не запускает кампанию и не подтверждает объединение.

Токен создаётся в панели, раздел «Настройки» — «Токены»; нужны права мастер-пользователя. Там же задаются имя, права и группа объектов, в рамках которой токену видны данные. Дальше токен передаётся агенту в заголовке Authorization как Bearer. Достаточно токена, базы и списка полей.

Не хранит пароль от панели и не работает без токена. Не обходит права токена: чего группа не даёт, того агент не увидит. Не отправляет рассылки без подтверждения.

Что такое агент, если коротко? — Программа, которая получает задачу и возвращает результат в вашей системе: собранный сегмент, размеченные заявки, сводку за месяц. Она не отвечает текстом в окне, а работает с данными по расписанию.

Что такое коннектор? — Описание доступа: какой адрес, какой токен, какие методы разрешены. Он не хранит пароль и не меняет платформу, а лишь фиксирует, что именно агент может прочитать и записать.

Чем это лучше ручной выгрузки? — Выгрузку делают раз в месяц и забывают, а агент сверяет данные по расписанию и помечает расхождения. Ручная работа остаётся там, где нужно решение, а не перенос строк.