Перейти к содержанию

От какого пользователя работает приложение

Приложение AI Документы обращается к вашему порталу Битрикс24 не от имени того сотрудника, который открыл вкладку, а от имени администратора интеграции — сотрудника, который установил приложение на портал. У приложения есть долгоживущий токен доступа этого сотрудника, и через него выполняются:

  • отслеживание изменений сделок, смарт-процессов и динамических сущностей (вебхуки onCrmDeal*, onCrmDynamicItem* и др.) и синхронизация их данных с базой приложения;
  • конвейер обработки документов: скачивание файлов из CRM, распознавание, извлечение данных и запись результатов обратно в поля CRM;
  • генерация итоговых документов по DOCX-шаблонам и прикрепление их к сделке;
  • регистрация и запуск роботов и активити бизнес-процессов (извлечение данных документа, сигнал завершения);
  • токен внешнего API приложения: в разделе «Настройки API» выдаётся и перегенерируется именно от имени администратора интеграции.

Что из этого следует для прав доступа

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

Настройки приложения (типы документов, шаблоны, типы сделок) и раздел «Настройки API» доступны только администраторам портала. Токен внешнего API действует от имени администратора портала: настройки и опасные операции через API доступны только ему и только на тарифе с API-доступом.

Роботы и активити бизнес-процессов

Робот «Извлечь данные документа» и активити приложения регистрируются от битрикс-пользователя администратора интеграции (AUTH_USER_ID). Ответ робота/активити в БП (включая сигнал завершения bizproc.event.send) отправляется приложением через токен администратора интеграции. О сценариях связки с бизнес-процессами (сигнал завершения, инициатор запуска, двойной запуск) спрашивайте в поддержке — страницы с разбором этих сценариев в подготовке.

Администратор уволен или лишён прав CRM

Если администратор интеграции деактивирован на портале или потерял права на CRM, обработка документов и роботы могут перестать работать: приложение временно приостанавливает обмен с порталом, а во вкладках сотрудники могут увидеть сообщение о временной недоступности. Лечится автоматически: первый действующий администратор портала, который после этого откроет приложение, станет новым администратором интеграции — ничего переустанавливать не нужно. Если проблема сохраняется, напишите в поддержку.

Смена администратора при переустановке

При повторной установке приложения администратором интеграции становится тот, кто выполнил установку последним. API-токен при этом сохраняется за новым администратором — при необходимости перегенерируйте его в разделе «Настройки API».

Диагностика «документы не распознаются / роботы не срабатывают»

  1. Активен ли на портале сотрудник, устанавливавший приложение, и есть ли у него права на CRM.
  2. Не удалялись ли у него права после организационных изменений (перенос между отделами снимает роль администратора в Битрикс24 — пере-выдайте её и заново откройте приложение действующим администратором).
  3. Открывал ли кто-то из действующих администраторов портала приложение после проблемы — авто-замена администратора интеграции происходит именно в момент входа.

Обращайтесь к нашим специалистам

По любым вопросам настройки и расширения имеющегося функционала приложений обращайтесь в нашу службу поддержки.

Мы всегда поможем вам решить вашу задачу.