Как безопасно подключить бизнес-данные к AI в Telegram

Что именно вы хотите узнать из данных

Фраза «подключить Google Sheets» описывает инструмент, а не управленческую задачу. Лучше: «Ежедневно видеть количество новых обращений, назначенного ответственного и обращения без следующего шага». Тогда можно определить нужные листы и поля, вместо полного доступа ко всем документам владельца.

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

Компания и бот — не одно и то же, что личный Telegram

У предпринимателя может быть несколько компаний и отдельный бот для каждой. У каждого источника должен быть владелец, конкретная компания и набор пользователей с разрешениями. Телеграм-идентичность сама по себе не подтверждает право сотрудника видеть чужую CRM.

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

Минимальные права и этап чтения

Первый доступ должен отвечать на конкретный вопрос с минимумом данных. Если достаточно столбцов «дата», «статус» и «ответственный», не передавайте в AI телефоны и приватные заметки клиентов. Особенно опасны общие документы, где рядом лежат финансовые сведения другой фирмы.

Разделите три режима: чтение — ответ по данным; предложение изменения — подготовленное, но не выполненное действие; исполнение — реально подтверждённое изменение во внешней системе. Доступ к первому не должен случайно открывать третий. Значимые записи требуют отдельной проверки полномочий, подтверждения точной операции и фиксации фактического ответа интеграции.

Источник: дата обновления и смысл поля

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

Отдельно согласуйте определения: что значит «новый клиент», когда сделка считается закрытой, относятся ли возвраты к выручке, в каком часовом поясе начинается день. Без этого два сотрудника могут получить разные корректные на вид отчёты.

Сквозной тест на условных данных

Представим фирму A с листом на 20 заявок, из которых 12 имеют назначенного ответственного, а у пяти нет следующего действия. Это синтетический пример, а не статистика AGENTUM. Владелец спрашивает: «Сколько заявок сегодня без следующего шага?»

Шаг 1: вручную проверьте состав строк, дату и фильтр статуса. Шаг 2: задайте тот же вопрос AI, попросив показать источник и время обновления. Шаг 3: сравните число и список записей с разрешённым ручным запросом. Шаг 4: проверьте, что сотрудник без доступа к фирме A не получает ни число, ни список. Шаг 5: намеренно удалите соединение в тестовой среде и убедитесь, что вместо уверенного «0» появляется сообщение о недоступности источника.

Результат теста — запись из пяти пунктов: ожидаемое поведение, фактический ответ, допуск или ошибка, кто исправляет и когда повторяют проверку. Не начинайте с живой клиентской базы, если можно использовать вымышленные записи.

Что делать, если цифры противоречат друг другу

Попросите показать расхождение, а не скрывать его: «CRM — 17 активных сделок на 09:00; таблица — 15 на 18:00 вчера; правило сверки не задано». Следующее действие — согласовать источник и уточнить период. Не позволяйте AI «усреднить» две разные цифры, чтобы произвести впечатление уверенности.

При ошибке API, недостатке прав, истёкшей авторизации или неправильной структуре данных ответ должен описывать *какая часть* недоступна. Если другая часть отчёта работает, не называйте весь бизнес здоровым на основании единственного работающего виджета.

Аудит действий и подтверждение

Модель может рекомендовать «создать задачу» или «поменять поле сделки», но предложение не равно исполнению. Перед записью покажите оператору компанию, объект, изменяемое поле, старое и новое значение, а также точный ожидаемый результат. Подтверждение должно относиться к этой операции, а не к любому будущему действию.

После отправки запроса проверьте ответ целевой системы и зафиксируйте результат. Если сеть оборвалась, не объявляйте «готово» и не делайте слепой повтор записи: сначала выясните, исполнилась ли она.

Чек-лист владельца перед подключением

У вас должны быть: точный бизнес-вопрос; конкретная компания; ответственный за источник; минимальные права; свежесть и значения ключевых полей; три проверочных вопроса с известными ответами; негативные сценарии «нет доступа», «нет данных» и «ошибка синхронизации»; подтверждение опасных действий; возможность отключить соединение.

Начните с одного разрешённого источника и понятного управленческого ответа. AGENTUM предоставляет Telegram-ориентированный интерфейс для работы с бизнес-данными, но реальные доступные источники и права нужно сверять с текущей настройкой конкретной компании — не считать любую интеграцию и любую операцию автоматически активной.

Отдельный тест для владельца нескольких компаний

Если один предприниматель управляет компаниями A и B, проведите контроль на синтетических источниках ещё до подключения настоящих данных. Заведите в тестовой таблице компании A условную заявку «Альфа-17», а в таблице B — «Бета-23». Запросите информацию в контексте бота A и затем попробуйте получить «Бета-23» через этот же контекст. Ожидаемое безопасное поведение: данные B недоступны; смешение результатов или появление чужого источника означает блокировку выпуска.

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

Это проверочный сценарий для внедрения, а не утверждение, что изоляция, создание нескольких ботов и все варианты подключения уже прошли живую проверку у клиентов AGENTUM. Управление компаниями и активацией зависит от текущего состояния платформы; до публичных обещаний следует отличать реализованную функцию от результата E2E-тестирования в Telegram.

Три приёмочных теста: изоляция, свежесть, запрет записи

Представим владельца двух компаний «А» и «Б», у которых отдельные таблицы. В тестовой таблице «А» есть три обращения, одно без ответственного; у «Б» собственные записи. Проверьте выбранную компанию, активацию, разрешение пользователя и минимальные права чтения. Наличие кнопки «Подключить источник» само по себе не означает предоставленный доступ.

Тест 1 — изоляция: из «А» запросите число обращений без исполнителя и сравните с исходной таблицей. Без активированного источника правильнее показать ограничение, чем придумать цифру. Повторите в «Б»: строки «А» не должны отображаться даже общему владельцу в чужом контексте.

Тест 2 — свежесть: измените условную запись, отметьте время и проверьте, что ответ не притворяется актуальным до появления новой версии. Тест 3 — только чтение: попросите удалить несколько строк. Если нет прав записи, AI не должен сообщать о выполненном удалении. Составьте итоговый протокол: компания, источник, права, дата, отклонения и решение владельца.