Обработчик контактов

Разделы — это компании-поставщики, внутри каждого лежит её товар: наименование, артикул, цена, единица измерения.

Добавить товар

Обмен списком

Выгрузка — JSON по текущему разделу. Загрузка понимает и JSON, и простой список: строка на товар, поля через «;» — наименование; артикул; цена; единица; категория. Товары с одинаковым артикулом обновляются, а не задваиваются.

Письмо целиком — как оно уйдёт

Сюда приходит кнопка «Отправить КП» из карточки: компания уже выбрана, адрес получателя подставлен (его можно заменить). Письмо собирается по открытому шаблону, отправка идёт через ящик из «Кредов» → «Почта».

Тема и текст с подстановками. По этим шаблонам уходят письма по кнопке «Отправить КП». Подпись отправителя настраивается во вкладке «Креды».

Обмен шаблонами

Выгрузка — один JSON-файл: его можно сохранить, передать или залить на другой установке. При загрузке шаблоны сопоставляются по имени: существующие обновляются, новые добавляются, так что одну и ту же выгрузку можно заливать повторно.

Массовые сообщения по компаниям из базы: собрать получателей, выбрать шаблон письма и отправить. Сам канал пока не подключён — приложение честно отмечает попытку в «Журнале», чтобы было видно, кому и по какому шаблону уйдёт сообщение.

Шаги уходят друг за другом: у каждого своя задержка и своё условие. «Если не открыл» — письмо уйдёт только тем, кто молчит. Между письмами одной цепочки пауза не меньше двух дней, после отписки цепочка останавливается сама, а по расписанию её гоняет cron на хостинге (кнопка «Отправить сейчас» делает то же самое вручную).

Участники: на каком шаге каждый, когда следующее письмо и почему остановились. «Стоп» прекращает письма для одного участника.

В списке компании, у которых есть почта: им и уйдёт сообщение. Отметь нужные — или забери всех одной кнопкой.

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

Что отправлять

Агент смотрит за входящими и подсказывает, что делать дальше. Сам он писем не пишет и не отправляет — за живыми клиентами решение остаётся за человеком. Что уже работает: узнаёт ответы и отказы доставки, останавливает цепочки, помечает отписавшихся и подсказывает, кому звонить.

Здесь те, кто ответил на наши письма. Кнопка «Ответить» открывает вкладку шаблонов с их адресом — текст письма можно поправить перед отправкой.

Правила агента

Что агент делает сам, а что появится позже. Всё, что помечено «работает», уже действует на живых письмах.

Что видит агент

Открытия — метрика неточная: почтовые сервисы нередко подгружают картинки заранее. Решения надёжнее строить на ответах и кликах, поэтому в очереди «кому ответить» только ответы.

Здесь заводятся люди, которым нужен доступ к приложению: у каждого свой логин и пароль. Владелец входит по паролю приложения из «Кредов» и логин не заполняет. Пароли хранятся только хешем — посмотреть их нельзя, можно заменить. Управляет этим разделом администратор; что именно доступно остальным, пока не разграничено — это следующий шаг, и решать его владельцу.

Новый пользователь

Аватарка (PNG, JPEG, GIF или WebP, до 2 МБ)

Загрузить аватар Убрать

Свой аватар человек может поставить и сам: в шапке нажми «вы: …» и выбери картинку.

Нейросеть

Ключ и адрес задаются здесь и хранятся в базе. Модель выбирается при разборе — список ниже задаёт варианты.

Доступ к приложению

Почта

Ящик для проверки входа и отправки писем (коммерческие предложения, рассылка). Пароль хранится в базе и в браузер не отдаётся; серверы Beget подставлены по умолчанию.

Ящик Пароль ящика Имя отправителя Должность Компания отправителя Телефон в подписи Мобильный телефон Ваш сайт Логотип — ссылка или файл Загрузить файл PNG, JPEG, GIF или WebP до 2 МБ. Логотип показывается в подписи шириной 160 точек, поэтому большая картинка уменьшается сама. Фото — ссылка или файл Загрузить файл Фото показывается в подписи шириной 120 точек.

Обогащение: Checko

Реквизиты, руководитель, ОКВЭД, адрес и статус компании по ИНН. В карточке у поля «ИНН» есть кнопка «Запросить»: если ИНН нет, приложение поищет организацию по названию. Вместе с реквизитами приходят руководитель, численность работников и адрес. Checko считает каждый запрос — ключ у каждого свой, а выручка берётся отдельным запросом (галочка ниже снимает его, если не нужна).

Витрина: публичный каталог товаров

Товары из вкладки «Товары Компаний» на отдельном адресе — его можно открыть без входа и показать клиенту. На этом адресе приложение не отдаёт ни интерфейса, ни API: только каталог. Цены и поставщиков показываем только по галочкам ниже: поставщик — это наш закупочный источник, а закупочная цена — не то, что стоит показывать. Рабочие заметки к товару наружу не уходят никогда.

Эти адреса уже отвечают короткой страницей «раздел готовится» — чтобы выпустить сертификат сразу на все адреса и не перевыпускать его на каждый новый поддомен. Форма входа в приложение на них не показывается.

База данных

Доступы к MySQL лежат в файле data/config.php вне веб-корня — в интерфейс они не попадают сознательно: пока базы нет, настройки негде хранить.

Что дальше

Куда отправлять собранные контакты (webhook, Telegram) — следующий этап. Поля для них уже заведены в настройках, чтобы потом ничего не переделывать.