Документация для ИИ-помощников

Эту справку можно читать в браузере или передать ИИ-помощнику. HTML-страницы и Markdown-файлы публикуются из одного набора статей.

Как дать помощнику документацию

Если помощник умеет открывать ссылки, передайте ему индекс документации и свой вопрос. Например:

Прочитай https://docs.molekula-platform.ru/llms.txt, найди инструкцию по приглашению сотрудника в Молекулу и объясни шаги для администратора и сотрудника.

Если он не умеет открывать сайты, на нужной статье нажмите «Скопировать для ИИ» и вставьте текст в диалог вместе с вопросом. Действие «Открыть Markdown» позволяет просмотреть текст без оформления.

Доступные форматы

У остальных статей также есть Markdown-версия: добавьте .md к адресу статьи. Для главной страницы используется /index.md.

Что помощнику нужно учитывать

• Компания в переключателе — рабочее пространство (тенант). Компания в разделе «Компании» — карточка организации внутри CRM. Различайте эти значения по контексту.
• Сначала создаётся аккаунт. Тенант создаётся отдельным действием «Создать компанию».
• Приглашённому сотруднику не нужно создавать собственный тенант.
• Email аккаунта должен совпадать с email приглашения, в том числе при входе через Яндекс.
• Создатель компании становится администратором. Текущая форма приглашения предлагает только роль «Администратор».
• Приглашение действует 168 часов по умолчанию и принимается один раз.
• Перед ответом следует открыть нужную статью и ссылаться на неё. Если описания функции в справке нет, не следует придумывать её поведение.

Эти файлы дают доступ к общим инструкциям. Они не содержат данные вашего тенанта и не предоставляют помощнику доступ к CRM. Наличие llms.txt не означает, что каждый помощник обнаружит сайт автоматически: при необходимости передайте ссылку явно.

Ежедневная работа для ИИ

Начните с навигации и прав доступа. Инструкции по задачам, календарю и уведомлениям содержат шаги, ограничения и проверку результата. Скриншоты дополняют текст; выполнение действий не требует распознавания изображения.

Клиенты и воронка для ИИ

Различайте компанию клиента, контакт и лид. Один контакт может иметь несколько активных лидов в одной воронке; не объединяйте их и не выбирайте один произвольно. Для перемещения карточки используйте инструкцию воронки, для настройки процесса — редактор. На компьютерной доске название доступного этапа можно изменить прямо в заголовке; это не перемещает лиды и не меняет автоматизацию этапа. Перед проигрышем проверьте обязательную причину. Не приравнивайте выигрыш к факту оплаты.

В списке лидов и воронке фильтр «Теги компании» проверяет теги связанной организации. Несколько выбранных тегов означают «Все выбранные», пока пользователь не выберет «Хотя бы один». Не путайте этот фильтр с квалификацией лида или тегами другой компании; лид без компании при активном фильтре не подходит. Для поиска пропавшего лида проверьте плашки фильтров и режим совпадения, затем при необходимости сбросьте их.

Встреча из карточки контакта или лида требует подключённого календаря с поддержкой видеоконференций. Перед сохранением проверьте сущность, основной email, тему, дату, точное время, длительность, часовой пояс, провайдера и дополнительных участников. CRM проверяет занятость: при конфликте пользователь должен выбрать изменение времени или явное продолжение. Успех означает создание внешнего календарного события и записи в timeline; ошибка проверки занятости не означает созданную встречу.

Компания хранит базовый профиль, отдельный бизнес-профиль, несколько юрлиц/ИП и заметки. Заметка создаётся после компании, а не в форме её создания. Ссылки на формы обращения сохраняются вместе с профилем и открывают внешний сайт; это не методы связи и не настройка импорта. В редакторе ссылки сначала сохраните строку, затем весь профиль. Не предлагайте подтверждение реквизитов с доказательствами: этот сценарий удалён.

Тип контакта различает человека, отдел, общий канал компании и неуказанный тип. Смена типа сохраняет владельца методов связи. Обращение через общий канал нескольких компаний требует явного выбора компании; основная компания общего контакта при этом не меняется. Если появилась ошибка конкурентного изменения, обновите и сравните карточку перед повтором.

Коммуникации для ИИ

Подключение почты различает личный аккаунт и общий ящик; разбор входящих описывает принятие, привязку и ответ. Отправка сообщения, Wazzup, диалоги, телефония и шаблоны содержат полный порядок действий. Не приравнивайте вход через Яндекс к подключению почты, ревью шаблона — к публикации, а отправку — к прочтению. Доступность функции проверяется по текущему состоянию подключения.

Раздел «Почта» открывает «Входящие» (/crm/email); подключения находятся на вкладке «Подключение почты» (/crm/email/settings). В пустых входящих кнопка «Подключить общий ящик» сразу открывает мастер. В настройках первый общий ящик подключается кнопкой «Подключить ящик», последующие — «Добавить ящик». Личная почта подключается кнопкой «Подключить Яндекс» и используется для отправки.

Мастер общего ящика (/crm/email/connect): «Ящик» — email и необязательное название; «Серверы» — адреса IMAP и SMTP плюс один общий логин и пароль; «Проверка» — сверка и «Подключить ящик». Используются 993 / TLS и 465 / TLS, оба соединения проверяются перед сохранением. После успеха открываются «Входящие». Воронки в мастере нет: откройте «Настройки» в карточке ящика, выберите «Воронка для новых обращений» и нажмите «Сохранить и проверить». В этой форме IMAP и SMTP редактируются раздельно; пустые поля новых паролей сохраняют прежние значения.

Карточка общего ящика отдельно показывает получение и отправку; «Требует внимания» при работающем получении может указывать на проблему SMTP. Синхронизация выполняется в фоне: «В очереди» подтверждает только принятие запроса, завершение проверяют по времени последней синхронизации. При временном сбое CRM планирует повтор; ошибки входа, конфигурации и сертификата требуют исправления настроек. «Проверить подключение» выполняет только диагностику и не сбрасывает ошибку синхронизации. Ручной запуск и диагностика имеют отдельные ограничения частоты в одну минуту. Статусы обновляются автоматически; после восстановления соединения список перечитывается. «Отключить ящик» требует подтверждения, останавливает получение и отправку через CRM и сохраняет загруженную историю; ящик у провайдера не удаляется.

Появление исходящего письма в истории не доказывает попадание во «Входящие» получателя: проверьте доставку и спам. SPF, DKIM и DMARC проверяются для домена и сервиса отправки у почтового провайдера; настройки одного домена не распространяются на домены других клиентов. storage_error у вложения означает ошибку сохранения файла, а не ошибку DKIM.

Во входящих статус выбирают вкладками «Ожидают разбора», «Приняты», «Отклонены», «Спам», страницы — стрелками. Для привязки письма выбирают запись через поиск. Исходящие ответы сохраняются в цепочке, но метка направления не подтверждает доставку. При отсутствии активных включённых мессенджеров страница сообщений предлагает подключить канал.

Мастер нового подключения Wazzup предлагает WhatsApp, Telegram и MAX. Instagram в нём отсутствует; не предлагайте пользователю выбрать его или пройти отдельный шаг подключения Instagram из этого мастера.

В редакторе сообщения из карточки контакта или лида канал Email поддерживает выбор нескольких файлов и перетаскивание в блок «Вложения». Возможна отправка файлов без текста, но тема, получатель и отправитель обязательны. Дождитесь загрузки всех файлов и обновления предпросмотра; ошибки загрузки устраняются повтором или удалением, ошибки удаления — повторным удалением. При сообщении «Вложения изменились» нужно проверить обновлённый предпросмотр перед повторной отправкой.

Лимиты CRM: до 10 файлов и 25 МиБ суммарно для Gmail/SMTP и Яндекса, до 10 файлов и 2 МиБ для Outlook. Для Яндекса ограничения могут быть строже; приоритет имеют значения в редакторе выбранного отправителя. Наличие политики провайдера не означает, что его подключение доступно пользователю. При смене отправителя файлы сохраняются и проходят повторную проверку; другой канал их не получает, возврат в Email восстанавливает список в текущем редакторе. После перезагрузки страницы файлы нужно выбрать заново. Не переносите этот сценарий на ответ в цепочке, вложения шаблонов, мессенджеры или отправку из ИИ-лаборатории.

Контракты и платежи для ИИ

Создание контракта требует лида с компанией. Документ и подписанный экземпляр, жизненный цикл, ожидаемые платежи и подтверждение оплаты описаны отдельно. Не приравнивайте смену статуса «На подписании» к отправке email, загрузку скана — к отметке подписания, а создание платежа — к банковскому переводу. Учитывайте условия автоматического перехода лида при полной оплате и проверяйте фактическое состояние после ошибки загрузки квитанции.

Вакансии для ИИ

Создание, карточка, публикации и план интервью описывают подготовку подбора. Различайте компанию заказчика и тенант, статус вакансии и этап отклика, запись публикации и реальное размещение на площадке. Для HeadHunter объявление создаётся на площадке, затем выбирается из списка интеграции: URL и внешний ID не вводятся вручную. Для SuperJob, Авито Работа, Хабр Карьеры и Rabota.ru используется тот же сценарий привязки после предоставления доступа по запросу. Для площадок без интеграции создаётся локальная запись. Различайте просмотры и отклики HH, количество импортированных откликов и локальные настройки публикации; кнопка «Обновить» запрашивает статистику, а «Импортировать сейчас» запускает импорт. Редактируйте структуру плана только в черновике; проверяйте опубликованную версию по умолчанию.

Доступность интеграций для ИИ

HeadHunter и Novofon доступны для подключения. SuperJob, Авито Работа, Хабр Карьера, Rabota.ru, Zadarma, MANGO OFFICE, Телфин, Гравител, UIS, CoMagic и Sipuni пока не находятся в свободном доступе и подключаются только по запросу. Сначала направьте пользователя к порядку запроса доступа; статьи описывают действия после предоставления доступа. Наличие документации, названия в форме или переключателя меню не подтверждает доступность интеграции. Не предлагайте обходить ограничение ручным названием площадки.

Переписка и решения по отклику зависят от площадки: чат поддерживают HH и Авито; SuperJob применяет уведомляемое решение к резюме в аккаунте работодателя, Rabota.ru и HH — к отклику, Авито — только сообщением без внешней смены статуса, Хабр — только локально без уведомления. Приглашение не создаёт интервью или календарное событие. Неподтверждённая отправка требует проверки, а не автоматического повтора. Счётчики Авито и Rabota.ru относятся к 30 дням по Москве, у Хабр Карьеры внешняя статистика не запрашивается.

Кандидаты и отклики для ИИ

Кандидат — человек в базе, отклик — его участие в конкретной вакансии, резюме — материалы отклика. Перед изменением ответственного или стадии проверьте выбранный отклик; отметка Active означает текущий выбор. Название вакансии в карточке отклика является ссылкой на вакансию; нажатие на карточку выбирает отклик. Список вакансий в базе кандидатов не содержит повторов и включает разные статусы откликов. Кандидат из HH может не иметь email. Кнопка завершения процесса может перевести отклик с оффера в найм. Просмотр стадии не меняет прогресс.

Интервью и офферы для ИИ

Вопросы редактируются в черновике плана. Назначение, состав и статусы, оценки и очередь компании относятся к конкретным интервью отклика. Не приравнивайте завершение интервью к получению всех оценок. Кнопка отправки оффера фиксирует статус без доставки письма; принятие оффера не завершает отклик автоматически.

Аналитика и источники для ИИ

Учитывайте ограничения панели, даты и формулы отчётов продаж, режим даты подбора. Конверсия продаж исключает открытые лиды из знаменателя. Метрика подключается администратором для тенанта; обзор атрибуции разделяет весь счётчик и выбранный источник. Готовность целей не доказывает доставку событий, а подписанная сумма не равна оплате.

AI Lab для ИИ

AI Lab — встроенная функция CRM с личными диалогами в тенанте. Контекст сделки задаётся выбором лида; смена делает прежние черновики устаревшими. Подтверждение предложения задачи или заметки создаёт запись, а подтверждение черновика письма фиксирует согласование без отправки. Различайте повтор выполнения, ответа и синхронизации; проверяйте фактический результат CRM.

Дубли и конфликты

Читайте очередь, проверку решения и объединение. Выбор варианта сохраняет связь сразу. Merge удаляет дубли; восстановления в интерфейсе нет. Лимит — три лида, включая главный. При объединении компаний выбираются также поля бизнес-профиля; ссылки на формы объединяются, юрлица/ИП и история заметок переносятся. Услуги берутся списком выбранной компании. Основной контакт необходимо проверить после операции. Не обещайте перенос вакансий компании.

Настройки и обучение

Администратор открывает «Настройки интерфейса» внизу бокового меню: страница /settings/interface управляет 28 пунктами для всей команды. По умолчанию включены 16, скрыты 12; ATS целиком скрыта. Изменения применяются после сохранения, у других открытых сессий — после перезагрузки. Скрытие не меняет права и обычно не закрывает прямые ссылки. Выключенные площадки подбора отдельно недоступны и по прямым адресам; переключатель меню не включает интеграцию. Исключения в карточках: компания оставляет только CRM-режим, когда выключены все ATS-разделы, а лид скрывает блок атрибуции, когда выключены «Источники и атрибуция». Не смешивайте эту страницу с меню языка и темы справа вверху на телефоне.

Используйте настройки меню, языка и темы, список команды, диагностику и учебные маршруты. Не обещайте редактирование пользователя по нажатию строки. Статусы аккаунтов не означают онлайн-присутствие, а число ожидающих не равно числу приглашений.

Для создания компании нужно только название; slug больше не запрашивается. В форме лида источник «Другое» требует пояснения до 255 символов. Если появилось окно «Технические работы», дождитесь восстановления и обновите страницу; перед повтором действия проверьте его результат.