Локальные интеграции: сценарии использования
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Сценарий описывает практическую задачу и порядок методов для ее выполнения. В локальных интеграциях сценарии показывают, как передать данные в CRM, создать задачу с файлом, встроить интерфейс приложения и настроить чат-бота.
Быстрый переход: все сценарии
Пользовательская документация: как создать вебхуки и приложения для Битрикс24
Связь с другими объектами
Сценарии связаны с объектами CRM, задачами, файлами Диска, интерфейсом Битрикс24 и чатами.
- CRM. Данные из внешней формы можно сохранить в контакте методом crm.contact.add. Для переноса существующих данных используйте методы crm.item.import и crm.item.batchImport
- Задачи и файлы Диска. Файл сначала загружают методом disk.folder.uploadfile, затем его идентификатор передают при создании задачи методом tasks.task.add
- Интерфейс Битрикс24. Виджет открывает страницу приложения внутри карточки CRM. Для регистрации обработчика используют метод placement.bind. Метод работает только в контексте приложения
- Чаты и чат-боты. Чат-бота регистрируют методом imbot.v2.Bot.register. Для получения событий можно настроить периодический опрос или указать URL обработчика. Методы imbot.v2 доступны через входящий вебхук и локальное приложение
Подробнее об инструментах читайте в статьях Входящие и исходящие вебхуки и Локальные приложения.
Как начать работу
- Определите задачу интеграции
- Выберите сценарий и инструмент в таблице
- Проверьте
scopeметодов и права пользователя, от имени которого интеграция выполняет запросы - Подготовьте данные и идентификаторы. Если Битрикс24 должен открыть страницу приложения или отправить ей событие, подготовьте обработчик — страницу с URL, доступным из внешней сети
- Выполните методы в указанном порядке и проверьте результат
Как выбрать сценарий
|
Если нужно |
Инструмент |
Откройте |
|
Передать контакты из веб-формы сайта в CRM |
Входящий вебхук или локальное приложение |
|
|
Добавить интерфейс приложения в карточку CRM |
Локальное приложение |
|
|
Перенести существующие данные в CRM |
Входящий вебхук или локальное приложение |
|
|
Создать задачу и прикрепить к ней файл |
Входящий вебхук или локальное приложение |
|
|
Создать чат-бота для Битрикс24 |
Входящий вебхук или локальное приложение |