Статья 1.7.5
Разработчику — как проверить первое подключение
Маршрут предназначен разработчику, который впервые подключает собственное приложение к рабочему пространству TalkIT. Учебная цель — безопасно прочитать одну заранее известную запись поставки, сравнить ответ с интерфейсом и определить следующий способ интеграции. Создавать сделки, изменять данные и выполнять внешние действия на этом этапе не требуется.
Выбрать способ интеграции
Сформулируйте действие приложения: «Один раз в день получать сведения из реестра поставок». Для такой задачи достаточно операции чтения ресурса через API или SDK. Вебхуки полезны, когда приложение должно реагировать на изменение сразу после события, а внешняя функция нужна, если агент запрашивает сведения во время разговора. Пока нет необходимости в реактивном поведении, начните с простого чтения.
Выберите тестовое пространство с известной записью «Поставка рабочих мест для „Севера“». Заранее согласуйте, какие поля требуется прочитать, например код поставки, количество и плановую дату. Проверьте наличие права на эту запись и зафиксируйте ожидаемые значения, с которыми будете сравнивать ответ интеграции.
Подключиться от нужного имени
Подготовьте совместимую с выбранным выпуском версию SDK и способ подключения, описанный в статье 8.1.2. Соединение должно быть привязано к правильному рабочему пространству. При использовании персонального токена храните секрет в защищённой конфигурации и не вставляйте его в код, примеры документации или журнал запросов.
Перед чтением явно выберите контекст выполнения, предусмотренный SDK: от имени владельца подключения либо подтверждённого сотрудника. Проверьте, чьи полномочия используются при запросе и разрешено ли этому исполнителю видеть исходную запись. Наличие действующего подключения не означает автоматического доступа ко всем объектам. При отказе сверяйте рабочее пространство и права исполнителя; не переключайтесь на владельца только ради обхода ограничения сотрудника.
Проверить результат и выбрать следующий пример
Выполните одну операцию чтения и сопоставьте возвращённый идентификатор, код поставки и количество с карточкой в TalkIT. Например, в учебной записи указано десять комплектов: ответ должен относиться к той же записи, а не просто содержать такое же число. Отдельно проверьте, что приложение корректно показывает отсутствие записи или отказ в доступе, не маскируя его пустым успешным результатом.
Сохраните краткий протокол: используемую версию SDK, пространство, выбранный контекст, прочитанный ресурс и итог проверки — без токенов и персональных данных. Далее выберите пример из 8.10. Для обновления складской сводки по событию нужен 8.10.1, для ответа агента о наличии товара — 8.10.2, для обработки формы сотрудника — 8.10.3. Перед выполнением изменяющих операций отдельно изучите правила повторов и восстановления результата.
Подробнее в статьях 8.1.1 «Выбор способа интеграции», 8.1.2 «Установка SDK и первый проект», 8.2.2 «Выполнение от имени владельца и сотрудника», 8.3.2 «Работа с основными ресурсами», 8.8.1 «Повторные запросы и идемпотентность» и подразделе 8.10 «Практические примеры интеграций и автоматизации».
Перед публикацией: сверить названия разделов и кнопок, наличие и состав готовых виджетов, доступность тестового канала, способ приглашения сотрудника, актуальную версию SDK и контракт чтения данных для конкретного выпуска TalkIT. Все данные о компании «Север» и количестве комплектов — учебный пример.