BPMSoft

Приложение BPMSoft подключает опубликованный OData 4 интерфейс CRM. Агент может изучить схему и работать с контактами, контрагентами, лидами, продажами, активностями, счетами и заказами, которые доступны конкретному пользователю BPMSoft.

Назначение

BPMSoft подходит для аналитических выборок и управляемого обновления CRM без передачи логина и пароля в рабочую песочницу агента. Так как состав объектов зависит от конфигурации, источником истины служит $metadata подключённого сервера.

Подключение

1. Создайте в BPMSoft отдельного пользователя интеграции.
2. Выдайте ему доступ к OData и только к нужным объектам и операциям.
3. Убедитесь, что сервер доступен извне по HTTPS.
4. В приложении BPMSoft укажите корневой адрес, логин и пароль.
5. Нажмите Проверить и подключить.

Promto создаёт сессию BPMSoft и проверяет GET /0/odata/$metadata. Подключение сохраняется только после успешной авторизации и получения метаданных. Управлять подключением может владелец рабочего стола; пароль после сохранения не возвращается в браузер.

Интерфейс и данные

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

Список сущностей не зашит в интерфейс Promto. Он определяется по опубликованной схеме BPMSoft, поэтому пользовательские объекты и поля доступны агенту на тех же условиях, что и стандартные.

Возможности агента

Инструмент — promto_bpmsoft. Работа начинается с capabilities, затем агент использует request с путями относительно /0/odata:

• /$metadata — схема сервиса;
• /Contact — контакты;
• /Account — контрагенты;
• /Lead — лиды;
• /Opportunity — продажи;
• /Activity — активности;
• /Invoice и /Order — счета и заказы, если опубликованы.

Для чтения используются OData-параметры $filter, $select, $orderby, $expand, $top и $skip. Имена объектов и полей агент должен брать из $metadata, а не предполагать.

Сценарии

Инвентаризация интерфейса

Через promto_bpmsoft сначала вызови capabilities, затем прочитай /$metadata. Перечисли опубликованные сущности для продаж и клиентов и покажи их ключевые поля. Ничего не меняй.

Активные продажи

По $metadata найди фактическую сущность продаж и поля статуса, суммы и ответственного. Затем сделай узкую OData-выборку только активных записей.

Ограничения и подтверждения

• Состав OData зависит от версии и доработок BPMSoft; пример /Opportunity может отсутствовать или иметь другие поля.
• POST, PATCH, PUT и DELETE меняют живую CRM и требуют confirm=true после явного согласия.
• Для записывающих запросов Promto отправляет OData-совместимый JSON content type.
• Права ограничены ролью пользователя интеграции.
• Ответ больше 512 КБ возвращается усечённым; используйте $select, $filter и страницы.
• Сервер должен иметь публично доступный HTTPS-адрес. Приватные и локальные адреса прокси не принимает.

Если что-то не работает

• Не удаётся подключиться. Проверьте внешний HTTPS-адрес и доступность /0/odata/$metadata с машины вне корпоративной сети.
• 401. Перепроверьте логин и пароль пользователя BPMSoft.
• 403. Пользователю не хватает доступа к OData или конкретному объекту.
• Сущность не найдена. Снова прочитайте $metadata; не переносите имена из другой конфигурации.
• Сессия истекает. Прокси заново авторизуется перед запросами. Если пароль был изменён, переподключите приложение.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto