Вызов вашего метода
REST или SOAP: адрес, операция, поля, при необходимости Basic auth. Для сотрудника это обычный инструмент — задачу вы объясняете словами, а не пишете интеграцию под неё.
Что связывается с вашей системой
Ваша система сообщает о новой заявкеон берётся за работу
Он сам достаёт оттуда карточку клиентабез выгрузок вручную
Готовый результат уходит к вам обратнов вашу же систему
Публичный API платформы с ключаминет
Заявка из вашего портала
Портал сам сообщает о новой заявке — сотрудник берёт её в работу и отвечает туда же.
Портал зовёт сотрудника
POST на выданный адрес с токеном. Маршрут без настроенного секрета не сработает — приёмник закрыт по умолчанию, а не открыт.
Сотрудник добирает данные
Вызывает метод вашей системы и достаёт то, чего в событии не было: карточку клиента, историю, остаток на складе.
Результат уходит обратно
Подписанным вебхуком, с пометкой против повторов: если доставка повторится, вторая запись у вас не появится.
Заявка 4417 · обмен по шагам
Портал → адрес события, токен сверен200
Сотрудник → ваш метод getOrderREST
Сотрудник → ваш метод getStockSOAP
Сотрудник → ваш вебхук, подпись HMACповтор не задваивает
Скидка сверх регламентаждёт вас
Четыре способа связать вашу систему с сотрудником
Каждый настраивается карточкой в списке подключений, отдельно для каждого сотрудника.
Входящее событие
Ваша система сообщает, что что-то произошло, и сотрудник берётся за работу. Опрашивать её каждые пять минут не придётся.
Исходящее событие
Готовый результат уходит вам подписанным вебхуком. Какие поля в нём придут, задаёте вы — сотрудник заполняет их по вашей же форме.
Сервер и репозиторий
Когда работа живёт не в браузере: команда на сервере по SSH, файлы и merge request в GitLab. Влить MR он не может — это остаётся человеку.
Что уже работает, а что пока нет
Работает
- Вызов метода по REST и SOAP, включая SOAPAction
- Приём событий на адрес с токеном, закрытый по умолчанию
- Исходящий вебхук с подписью; повторная доставка не создаёт вторую запись
- Выгрузка строк в push-датасет Power BI или свой приёмник
- Доступ выдаётся сотруднику, а не компании целиком
Пока нет
- Публичного API платформы: машинных ключей у тенанта нет, программно поставить задачу снаружи нельзя
- Готового описания вашего API — его придётся один раз задать
- Слияния merge request: агент предлагает, вливает человек
- Выгрузки старой истории из систем, которые её не отдают
Свой сервис подключается так же, как Bitrix24: сотрудник видит его обычным инструментом. Значит, задачу вы объясняете словами, а интеграцию под неё писать не нужно.
Расскажите про свою систему
Ассистент на главной разберёт задачу и скажет, что для этого понадобится.