Подключение Битрикс24
Тип интеграции: OAuth 2.0 (локальное приложение).
Шаг 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 |
| Встраивание приложений | placement |
| Платёжные системы | pay_system |
| Контакт-центр | contact_center |
- Нажмите Сохранить.
Шаг 2. Получить Client ID и Client Secret
После сохранения Битрикс24 покажет данные приложения:
- Код приложения (client_id) - начинается с
local.; - Ключ приложения (client_secret).
Скопируйте код приложения, ключ приложения и адрес портала (company.bitrix24.ru или другой) в Telegram @artemuhanov.
Важно. Ключ приложения показывается один раз. Скопируйте его сразу. Если потеряли - нажмите «Переустановить» в настройках приложения.
Что загружается из Битрикс24
| Данные | Что получает Филин |
|---|---|
| Сделки и лиды | Со всех воронок: суммы, статусы, кастомные поля |
| Контакты и компании | Привязанные к сделкам клиенты и организации |
| Сотрудники | Список сотрудников отдела продаж |
| Воронки и стадии | Структура воронок и стадий |
| Задачи | Выполненные и предстоящие |
| Звонки | Записи разговоров + автоматическая транскрибация |
| Переписки | Все каналы (WhatsApp, Telegram, Avito, чаты открытых линий) |
| Письма | Email-переписка (тема, текст, направление) |
| Файлы | Вложения из сообщений и активностей (PDF, DOCX, изображения - разбираются) |
| Комментарии | Текстовые комментарии в таймлайне сделок |
Автосинхронизация
После подключения данные обновляются автоматически каждую ночь.
Безопасность
- OAuth-токены шифруются в базе данных (AES-256).
- После сохранения токены не отображаются в интерфейсе.
- Каждый пользователь видит только свои данные.
Битрикс24 устроен так, что часть данных (история чатов, файлы с диска) доступна только через OAuth - поэтому подключение идёт именно через локальное приложение, а не через webhook.