Подключение Битрикс24
Подключение занимает 5-10 минут: администратор портала создаёт локальное приложение, выдаёт ему права, вводит код и ключ приложения на странице подключения Филина и подтверждает доступ в Битрикс24. Дальше Филин подхватывает данные сам.
Тип интеграции: OAuth 2.0 (локальное приложение).
Страница подключения открывается из мастера настройки: на шаге «Подключите Битрикс24» нажмите «Открыть подключение Битрикс24» - она откроется в новой вкладке. Инструкция ниже повторяет её по шагам.
Шаг 1. Создать локальное приложение в Битрикс24
- Войдите в портал Битрикс24 под учётной записью администратора.
- Откройте Приложения (левое меню) → Разработчикам → Другое → Локальное приложение.
- Заполните форму:
- Тип: Серверное
- Путь вашего обработчика:
https://feelin.tech/auth/bitrix24/callback - Путь для первоначальной установки:
https://feelin.tech/auth/bitrix24/install - Использует только API: поставьте галочку
- В разделе Права включите доступы из таблицы ниже и нажмите Сохранить.
| Право | Скоуп |
|---|---|
| CRM | crm |
| Пользователи | user |
| Задачи | task |
| Задачи | tasks |
| Задачи (расширенные права) | tasks_extended |
| Телефония | telephony |
| Диск | disk |
| Открытые линии | imopenlines |
| Чат и уведомления | im |
| Почтовые сервисы | mailservice |
| Настройки пользовательских полей | userfieldconfig |
| Контакт-центр | contact_center |
Шаг 2. Получить Client ID и Client Secret
После сохранения Битрикс24 покажет данные приложения:
- Код приложения (client_id) - выглядит как
local.xxxxx.xxxxx; - Ключ приложения (client_secret).
Важно. Ключ приложения показывается один раз. Скопируйте его сразу. Если потеряли - нажмите «Переустановить» в настройках приложения.
Шаг 3. Ввести данные в Филине и авторизоваться
На странице «Подключение Битрикс24» в блоке «Данные приложения» заполните:
- Адрес портала - только начало адреса: для
company.bitrix24.ruвпишитеcompany. Окончание.bitrix24.ruуже подставлено в поле. - Код приложения (client_id).
- Ключ приложения (client_secret).
Нажмите «Сохранить и подключить» - вы перейдёте в Битрикс24. Подтвердите доступ под администратором портала и вернётесь на страницу подключения со статусом «Подключено». Если авторизация не прошла, страница покажет ошибку: проверьте данные приложения и повторите.
Если подключаетесь из мастера настройки, вернитесь на его вкладку и нажмите «Подключено - проверить».
Что загружается из Битрикс24
| Данные | Что получает Филин |
|---|---|
| Сделки и лиды | Со всех воронок: суммы, статусы, кастомные поля |
| Контакты и компании | Привязанные к сделкам и лидам клиенты и организации |
| Справочники | Воронки и стадии, сотрудники, кастомные поля |
| Задачи | Выполненные и предстоящие |
| Звонки | Записи разговоров + автоматическая транскрибация |
| Голосовые | Голосовые сообщения + автоматическая транскрибация |
| Встречи | Записи онлайн-встреч + автоматическая транскрибация |
| Переписки | Все каналы (WhatsApp, Telegram, Avito, чаты открытых линий) |
| Письма | Email-переписка (тема, текст, направление) |
| Файлы | Вложения из сообщений и активностей (PDF, DOCX, изображения - разбираются) |
| История переговоров | Активности и текстовые комментарии в таймлайне сделок и лидов |
| Дубли | Найденные повторяющиеся контакты и компании |
Что уже загружено, видно на странице «Данные Битрикс24» (Настройки → CRM-система) - подробнее в разделе «Данные CRM».
Автосинхронизация
После подключения данные синхронизируются сразу и обновляются автоматически каждую ночь.
Безопасность
- OAuth-токены шифруются в базе данных (AES-256).
- После сохранения ключ приложения и токены не отображаются в интерфейсе: при повторном открытии поле ключа пустое, оставьте его пустым, чтобы не менять ключ.
- Данные кабинета видите только вы и коллеги, которых вы добавили в «Команду».
Битрикс24 устроен так, что часть данных (история чатов, файлы с диска) доступна только через OAuth - поэтому подключение идёт именно через локальное приложение, а не через webhook.