При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Виджет в контакт-центре CONTACT_CENTER», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
Виджет в контакт-центре CONTACT_CENTER
Тут может не хватать некоторых данных — дополним в ближайшее время
- Что получает обработчик (скопировано из примера Сергея, detail-tab)
- Частые кейсы и сценарии — надо добавить, если есть что
- Продолжите изучение (скопировано из примера Сергея, detail-tab)
> Scope: contact_center
Вы можете добавлять свой пункт («квадратик») в списке Контакт-центра.
!Виджет в виде пункта в списке Контакт-центра
Код конкретного места встройки виджета указывается в параметре PLACEMENT метода placement.bind.
Встройка не будет отображаться в интерфейсе, пока установка приложения не завершена. Проверьте установку приложения
Куда встраивается виджет
| Код встройки | Место |
|---|---|
CONTACT_CENTER | Пункт («квадратик») в списке Контакт-центра |
Что получает обработчик
Данные передаются в виде POST-запроса {.b24-info}
'DOMAIN': 'xxx.bitrix24.com'
'PROTOCOL': 1
'LANG': 'en'
'APP_SID': '99c80eff6378726287350416ee5fef0'
'AUTH_ID': '6061e72600631fcd00005a4b00000001f0f1076700000000f69dd5fc643d9ce2fdbc1'
'AUTH_EXPIRES': 3600
'REFRESH_ID': '50e00aa340631fcd00005a4b00000001f0f1071111116580a5b83c2de639ef28c12'
'member_id': 'da45a03b265ed12127f8a258d793cc5d'
'status': 'L'
'PLACEMENT': 'CRM_DEAL_DETAIL_TAB'
'PLACEMENT_OPTIONS': '{"ID":"3443"}'
Параметртип | Описание |
|---|---|
DOMAINstring | Адрес Битрикс24, на котором был вызван обрабтчик виджета |
PROTOCOLstring | Защищенный или не защищенный протокол HTTP: — |
LANGstring | Язык интерфейса пользователя Битрикс24, который вызвал виджет. Вы можете локализовать язык интерфейса в своём виджете, ориентируясь на это значение |
APP_SIDstring | Строковый идентификатор приложения, зарегистрировавшего обработчик виджета |
AUTH_IDstring | Авторизационный токен OAuth 2, выписанный для пользователя, вызвавшего виджет. Можно использовать для вызовов REST API от лица этого пользователя |
AUTH_EXPIRESinteger | Время в секундах, после которого авторизационный токен станет неактуальным |
REFRESH_IDstring | Refresh-токен OAuth 2, выписанный для пользователя, вызвавшего виджет. Можно использовать для обновления авторизационного токена от лица этого пользователя |
member_idstring | Уникальный строковый идентификатор Битрикс24, на котором был вызван обрабтчик виджета. |
statusstring | Тип приложения, зарегистрировавшего обработчик данного виджета. Принимает значения: — |
PLACEMENT*string | Код места встройки виджета. Вы можете использовать один и тот же URL обработчка для всех своих виджетов. Значение, которое Битрикс24 будет сообщать в параметре PLACEMENT, поможет определить, из какого именно места встройки виджета был вызван ваш обработчик в каждом конкретном случае |
PLACEMENT_OPTIONSstring | Дополнительные данные в виде JSON-строки, определяющие контекст выполнения виджета. В данном случае, это массив, содержащий числовой идентификатор элемента CRM, в карточке которого был вызван обработчик виджета. Параметр PLACEMENT_OPTIONS вместе с параметром PLACEMENT позволяет точно определить, для какого именно объекта CRM был вызван обработчик виджета |
- [](./placement-bind)
- [](./ui-interaction/index)
- [](./ui-interaction/crm-card)
- [](../../settings/interactivity/index)
- [](./open-application)
- [](./open-path)
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к битрикс, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Виджет в контакт-центре CONTACT_CENTER».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru
