Интеграция с Битрикс24: приложение, SSO и календарь
UnSpot интегрируется с Битрикс24 в трёх местах: приложение UnSpot в портале Битрикс24, вход в UnSpot по учётным данным Битрикс24 (SSO) и синхронизация календарей через входящий вебхук. В этой статье собраны все три сценария.
Установка приложения UnSpot в Битрикс24
- Установите приложение UnSpot из магазина приложений Битрикс24 и подтвердите своё согласие.
- Откройте приложение и укажите название вашего окружения.
После первого входа UnSpot запомнит связь с вашим окружением Битрикс24 и больше не будет его запрашивать.
Настройка SSO (Single Sign-On)
Бесшовная авторизация позволяет сотрудникам входить в UnSpot по учётным данным Битрикс24, без отдельного пароля.
Видео записано в предыдущей версии интерфейса — расположение разделов могло измениться, порядок действий прежний.
- Перейдите в Администрирование → Интеграции → Способы входа / SSO.
- В дополнительных способах входа нажмите «Подключить» в карточке Bitrix24.
- Введите ссылку на ваш портал Битрикс24 и нажмите «Сохранить».
При следующем входе в систему на странице авторизации появится кнопка входа через Битрикс24.
Настройка прав передачи данных в магазине Битрикс
Чтобы сотрудники заводились в UnSpot автоматически при первой авторизации, в магазине приложений Битрикс нужно разрешить передачу данных пользователя в UnSpot.
Подключение календаря Битрикс24 по вебхуку
Синхронизация календарей с Битрикс24 подключается входящим вебхуком портала. Подключение доступно ролям Владелец и Администратор интеграций. Карточка Bitrix24 в блоке календарей есть только в российском контуре.
- В Битрикс24 создайте входящий вебхук с правами на календарь и скопируйте его URL.
- В UnSpot откройте Администрирование → Интеграции → Синхронизации и пролистайте до блока «Синхронизация календарей».
- В карточке Bitrix24 нажмите «Подключить».
- Вставьте URL вебхука в поле «Введите URL входящего webhook из Bitrix» и нажмите «Подключить».
URL должен иметь вид https://<ваш-портал>.bitrix24.ru/rest/<идентификатор пользователя>/<токен>/ — именно такой формат подсказывает и сама форма.
| Что проверяет UnSpot | Подробности |
|---|---|
| Схема адреса | Если вы вставите адрес без https://, схема подставится автоматически |
| Путь | Обязателен вид /rest/<id>/<токен>. Завершающий слэш и лишние сегменты после токена допускаются |
| Что берётся из ссылки | Только домен портала, идентификатор пользователя и токен. Порт, параметры и якорь отбрасываются |
| Длина поля | До 255 символов |
| Проверка на стороне Битрикс24 | UnSpot обращается к вебхуку и проверяет, что он отвечает и что у пользователя вебхука заполнен email |
После успешного подключения появится сообщение «Вебхук Bitrix24 успешно подключен», а в карточке отобразится домен портала и кнопка «Отключить».
Важно про организатора встреч. События, которые UnSpot создаёт в Битрикс24, публикуются от имени пользователя, чей вебхук указан при подключении, а не от владельца календаря. Создавайте вебхук от учётной записи, которую допустимо показывать как организатора.
Ошибки при подключении
| Сообщение | Что произошло и что делать |
|---|---|
| Введите корректный URL. Пример: https://my-company.bitrix24.ru/rest/1/xxxxxxxxxx/ | Ссылка не похожа на адрес входящего вебхука: нет части /rest/, идентификатора пользователя или токена. Скопируйте URL из карточки вебхука в Битрикс24 целиком |
| Не удалось подключиться к Bitrix24. Проверьте URL и права доступа. | Портал не ответил, вебхук отозван, у него не хватает прав на календарь или у пользователя вебхука не заполнен email |
| Не удалось подключить Bitrix24. Подключение уже существует. | Этот портал уже подключён к другому рабочему пространству UnSpot. Отключите старое подключение или создайте вебхук на другом портале |
| Подключение Bitrix24 через OAuth2 недоступно. Используйте интеграцию через вебхук. | Прежняя схема подключения календарей Битрикс24 по OAuth2 отключена — используйте вебхук, как описано выше |
