ERP API
Обновлено:
Где: Настройки > Интеграции > ERP API
Для чего это нужно:
Отображение ваших систем в виде кнопок рядом с каждым чатом. Когда оператор открывает диалог, SyBox запрашивает данные об этом клиенте в вашей системе и выводит ответ прямо возле чата, чтобы сотруднику не приходилось переключаться между вкладками. Это могут быть заказы, баланс, тикеты или любые другие данные. SyBox передаёт номер телефона клиента или его email (если диалог ведётся по почте).
Есть два типа ERP API:
- «Боковая вкладка — показывать данные рядом с чатом»: кнопка на боковой панели входящих. При нажатии отображает данные по открытому клиенту из вашей системы.
- «Товары — поиск по каталогу и отправка в чат»: оператор вводит запрос клиента. Ваша система возвращает подходящие товары в виде карточек с названием, ценой, фото и остатком. В один клик ссылка на товар подставляется в поле ввода сообщения.
- Перейдите в Настройки > Интеграции > ERP API.
- Нажмите «Добавить ERP API».
- Выберите «Тип» (один из двух вариантов выше).
- Заполните «Отображаемое имя» — полное название интеграции.
- Заполните «Название кнопки» — короткую подпись, которую пользователи видят на кнопке.
- В блоке «Значок кнопки» выберите подходящую иконку.
- В поле «Адрес ERP API» вставьте URL вашей системы. Он должен начинаться с http:// или https://.
- В поле «Токен ERP» вставьте токен вашей системы, если он используется. SyBox отправляет его с каждым запросом для проверки подлинности.
- Необязательно: в блоке «Пользовательские заголовки» нажмите «Добавить заголовок», чтобы передавать дополнительные параметры (например, код филиала). У каждого заголовка есть свой переключатель, так что его можно временно отключить без удаления. Для удаления заголовка нажмите на значок корзины. Служебные заголовки, используемые самим SyBox, игнорируются.
- Нажмите Сохранить.
Новая кнопка появится во входящих сразу же, обновлять страницу не требуется.
- Найдите нужную карточку в списке ERP API.
- Нажмите Изменить, чтобы обновить параметры. Чтобы оставить прежний токен, оставьте поле «Токен ERP» пустым («Оставьте поле пустым, чтобы быть в курсе событий»).
- Нажмите Включить / Отключить, чтобы скрыть или показать кнопку во входящих. Отключенная интеграция помечается как «Отключено».
- Нажмите Удалить и подтвердите действие («Удалить эту интеграцию?»).
Что отображается на карточке: название, текст кнопки, адрес и статус «Активный» или «Отключено». Если токен не задан, отображается «Нет токена». Если задан — показываются только последние символы.
Правила и системные сообщения:
- Поля «Отображаемое имя», «Название кнопки» и «Адрес ERP API» обязательны. Если хотя бы одно не заполнено, появится сообщение «Неполные данные».
- Адрес должен обязательно начинаться с http:// или https://.
Настройка на вашей стороне: в открытой документации SyBox для разработчиков (на сайте SyBox в разделе Developers) подробно описано, какие данные передаёт SyBox и как должна отвечать ваша система. Там же описаны форматы вывода данных, кликабельные строки для открытия подробностей записи и поиск товаров.
Я добавил ERP API, но кнопка рядом с чатом не появилась.
Проверьте, активна ли карточка (статус «Активный»). Оба типа выводятся в виде кнопки на боковой панели входящих.
Панель открывается, но данных нет или возникает ошибка.
SyBox выводит именно то, что возвращает ваш сервер. Убедитесь, что ваш адрес доступен из интернета, токен указан верно, а система может найти клиента по номеру телефона (или по email для почтовых переписок).
Можно ли подключить несколько систем?
Да. Добавляйте столько ERP API, сколько нужно. Для каждой интеграции появится своя кнопка.
Кто видит данные на этой панели?
Любые сотрудники команды, у которых есть доступ к этому диалогу во входящих.