Logtex CRM

Кастомное приложение для Frappe CRM: телефония, голосовые боты, сегментация по проектам и контроль качества данных.

Что делает

Телефония и боты

• Zadarma: входящие и исходящие звонки попадают в карточку клиента вместе с записью разговора.
• Retell AI: после звонка бот заполняет карточку — имя, компания, почта, телефон, интерес, итог.
• Расшифровка и краткое содержание разговора хранятся в самом звонке и в карточке.
• Исходящий обзвон: сбор номеров по фильтрам (страна, товар, тип, статус, проект) и запуск через Retell.
• Недозвон (занято, не ответили) фиксируется с причиной и не создаёт лишних карточек.

Защита данных

• По существующему контакту бот НЕ перезаписывает поля: всё, что он услышал, попадает в отдельный блок «Bot Data (for review)» со статусом проверки.
• История предложений бота хранится по каждому звонку отдельно и не затирается.

Качество базы

• Поиск дублей по названию, сайту, телефону и почте — сравнение без учёта формата записи (+48 22 731 54 55 = +48227315455, https://site.pl/ = www.site.pl).
• Объединение карточек-дублей с переносом контактов, сделок, звонков и запросов.
• Импорт никогда не падает из-за повторов: строка загружается и помечается как возможный дубль.

Заявки

• Quote Request создаётся, когда в разговоре прозвучал конкретный запрос на товар, и по настройке сразу превращается в сделку.

Структура

logtex_crm/
├── api/          # интеграции и бизнес-логика (Retell, Zadarma, дубли, почта)
├── setup/        # установка: поля, пайплайны, раскладки, разовые правки
├── logtex_crm/   # свои DocType (Quote Request, Call Campaign, настройки)
└── tests/        # проверки: звонки, дубли, импорт, права, производительность

Установка

bench get-app logtex_crm https://github.com/isikjon/logtex.git
bench --site <site> install-app logtex_crm
bench --site <site> migrate

Настройка

Ключи интеграций задаются в интерфейсе: Logtex CRM Settings (/app/logtex-crm-settings). В репозитории секретов нет.

Пароли почтовых ящиков для массового заведения — в mail_accounts.local.json (см. mail_accounts.example.json), файл в .gitignore.

Проверки

bench --site <site> execute logtex_crm.tests.e2e.run        # бизнес-логика
bench --site <site> execute logtex_crm.tests.sec.run        # права и безопасность
bench --site <site> execute logtex_crm.tests.audit.run      # аудит системы
bench --site <site> execute logtex_crm.tests.perf.run       # производительность