Битрикс24

Приложение Битрикс24 подключает входящий webhook рабочего портала к Promto. Агент получает доступ к лидам, сделкам, контактам, компаниям и задачам в пределах прав этого webhook.

Назначение

Подключение подходит для разбора воронки продаж, контроля новых лидов, проверки клиентской базы и задач команды. Данные остаются в Битрикс24: Promto обращается к REST API через серверный прокси.

Подключение

1. В Битрикс24 откройте раздел для разработчиков и создайте входящий webhook.
2. Выдайте ему только необходимые права. Для встроенных сценариев обычно нужны разделы CRM и Задачи.
3. Скопируйте URL целиком, например https://company.bitrix24.ru/rest/1/secret/.
4. В Promto откройте Битрикс24 → Настройки, вставьте URL и нажмите Проверить и подключить.

Также поддерживается формат REST 3.0 вида /rest/api/{user}/{secret}/. Promto проверяет структуру URL и делает безопасный запрос профиля или документации API до сохранения подключения.

Подключать, переподключать и отключать портал может только владелец рабочего стола. Секретная часть webhook остаётся на сервере.

Интерфейс и данные

Главная страница содержит сценарии Воронка продаж и Новые лиды. Они не запускают изменение данных: карточка добавляет в чат готовый запрос для агента.

На экране настроек видны состояние подключения, адрес портала, доступные примеры методов, последняя ошибка, переключатель доступа агента и отключение. Карточки лидов или сделок внутри приложения не отображаются — их читает и анализирует агент.

Возможности агента

Инструмент — promto_bitrix24. В params.path передаётся имя REST-метода, а не URL:

• crm.deal.list — сделки;
• crm.lead.list — лиды;
• crm.contact.list — контакты;
• crm.company.list — компании;
• tasks.task.list — задачи.

Фильтр, select, сортировка и start передаются в params.body. Перед первым запросом агент вызывает capabilities, чтобы получить актуальную памятку подключения.

Сценарии

Воронка продаж

Через promto_bitrix24 сначала вызови capabilities, затем crm.deal.list. Сгруппируй сделки по стадиям, покажи ответственных, суммы и просроченные активности. Только чтение.

Новые лиды

Через promto_bitrix24 прочитай новые необработанные лиды, выдели дубли и записи без ответственного. Ничего в Битрикс24 не меняй.

Массовая подготовка обновлений

Попросите агента сначала сформировать таблицу ID → текущее значение → новое значение. После проверки отдельно подтвердите каждую группу записывающих вызовов.

Ограничения и подтверждения

• Битрикс24 передаёт и чтение, и запись через HTTP POST, поэтому Promto определяет безопасность по имени REST-метода.
• Методы, оканчивающиеся на .list, .get, .fields, .types и .statuses, считаются чтением. Неизвестный метод закрывается по безопасному правилу и требует confirm=true.
• Методы .add, .update, .delete и другие действия с побочным эффектом выполняются только после явного согласия пользователя.
• Возможности ограничены правами webhook. Если право Задачи не выдано, CRM может работать, а tasks.task.list — нет.
• Ответ прокси ограничен 512 КБ, поэтому большие списки нужно читать страницами.

Если что-то не работает

• Webhook не принимается. Вставьте полный URL, включая числовой ID пользователя и секретный сегмент.
• Доступ запрещён. Откройте настройки webhook в Битрикс24 и добавьте право на нужный раздел.
• Метод требует подтверждение, хотя кажется чтением. Используйте официальный метод с суффиксом .list или .get; новые и нестандартные методы намеренно обрабатываются как потенциальная запись.
• Не все элементы попали в ответ. Передавайте start следующей страницы и уменьшайте набор полей через select.
• Webhook отозван. Создайте новый входящий webhook и переподключите приложение.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto