HoReCa
Coffee Bruni
Coffee Bruni встроила поддержку Orbita прямо в своё приложение: сотрудник создаёт обращение там, где работает, ответ приходит туда же. Отдельный портал и вторая учётная запись не нужны. По итогам интеграции в платформу вошли самопроверка настроек интеграции и раздельные коды ошибок API — теперь это доступно всем заказчикам.
Coffee Bruni подключила собственную платформу к Orbita Platform: поддержка теперь живёт внутри рабочего приложения сотрудника
Первая интеграция через Embedded Support API — обращения из приложения Coffee Bruni попадают в Service Desk, а ответы возвращаются обратно в приложение
[Город], [дата] — Компания Coffee Bruni, развивающая не только сеть кофеен, но и собственную платформу управления кофейней и обучения персонала, завершила интеграцию своего приложения с Orbita Platform — российской системой Service Desk, базы знаний и управления проектами от ООО «Орбитум Тех».
Интеграция выполнена через Embedded Support API — механизм, при котором поддержка встраивается прямо в интерфейс стороннего приложения. Сотрудник кофейни описывает проблему там же, где работает: в приложении Coffee Bruni. Обращение автоматически создаётся в Service Desk Orbita, а ответ специалиста возвращается в приложение. Переходить на отдельный портал, заводить ещё одну учётную запись и запоминать ещё один пароль не нужно.
Как это устроено
Embedded Support API построен на двух уровнях доступа. Секретный ключ приложения остаётся на сервере Coffee Bruni и никогда не попадает в клиент. Сервер обменивает его на короткоживущий токен конкретного пользователя — именно этот токен работает в приложении. Такая схема означает, что скомпрометированный клиент не даёт доступа к чужим обращениям.
Учётные записи сотрудников создаются автоматически при первом обращении: отдельная регистрация в Orbita не требуется. Ответы агентов возвращаются в приложение вебхуками с криптографической подписью, поэтому принимающая сторона может проверить, что событие действительно пришло от Orbita.
Интеграция, которая улучшила саму платформу
Показательной оказалась не только скорость подключения, но и то, как прошла отладка. На старте приложение Coffee Bruni получало от Orbita общий отказ «приложение настроено неверно» — без указания причины. Разбор показал, что за одним кодом ошибки скрывались три разные ситуации: отсутствующая форма обращения, форма в чужом проекте и проект неподходящего типа.
По итогам этой интеграции в Orbita Platform вошли доработки, доступные теперь всем заказчикам:
- самопроверка приложения — карточка интеграции в админке сама показывает, что настроено неверно, не дожидаясь обращения от партнёра;
- раздельные коды ошибок API — вместо общего отказа система называет конкретную причину и слаг проблемной формы;
- выбор проекта и формы из списка вместо ручного ввода идентификатора — именно опечатка в нём и приводила к отказу;
- редактирование и полное удаление интеграций в интерфейсе администратора.
«[Цитата представителя Coffee Bruni: чего ждали от интеграции и что получили. 2–3 предложения, живым языком, без превосходных степеней]», — отметил(а) [имя], [должность] Coffee Bruni.
«[Цитата представителя Орбитум Тех: почему важна первая внешняя интеграция и что она дала продукту. Уместно честно сказать, что доработки родились из реальной боли партнёра]», — прокомментировал(а) [имя], [должность] ООО «Орбитум Тех».