Bitrix24 (Битрикс24)

Установка приложения

Перейдите в ваш аккаунт Bitrix24 и откройте раздел "Приложения" → "Маркетплейс".

В каталоге приложений найдите WebAsk и установите приложение, подтвердив необходимые разрешения.

Также вы можете установить приложение напрямую через страницу приложения в Bitrix24. Для этого перейдите по ссылке, нажмите кнопку "Установить", авторизуйтесь в аккаунте и выберите нужный портал.

Привязка интеграции

После установки приложения перейдите в нужную форму опроса в WebAsk. Откройте раздел "Интеграции" → "Bitrix24" и нажмите кнопку "Я установил".

Далее нажмите кнопку "Открыть окно авторизации" и перейдите по предложенной ссылке.

При переходе выполните авторизацию в Bitrix24 и выберите портал, который необходимо подключить.

После успешной авторизации нажмите кнопку "Проверить" — интеграция будет завершена.

Настройка сущностей и сопоставление полей

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

Для каждой сущности настройка выполняется отдельно. Чтобы включить передачу данных в нужную сущность, перейдите в неё и активируйте переключатель в правом верхнем углу.

После включения станут доступны параметры сущности и настройка сопоставления полей. Ниже интерфейс показан на примере сущности "Лид", однако по такой же логике настраиваются и остальные сущности: "Сделка", "Контакт" и "Компания".

Во всех сопоставлениях можно использовать два варианта передачи данных:

• выбрать конкретное поле из формы;
• указать статическое значение, которое будет передаваться в Bitrix24 при каждом ответе.

Это удобно, если часть данных должна подставляться автоматически, без участия пользователя.

Лид

При включении сущности "Лид" можно настроить следующие параметры:

• Статус — статус лида, в который будет попадать новая запись.
• Поле заголовка — поле формы, значение которого будет использоваться в названии лида.
• Поле названия компании — поле формы, из которого будет передаваться название компании.
• Добавить ID в заголовок — добавляет ID отправки опроса в заголовок сущности.
• Сопоставление полей — ручная настройка передачи данных из формы в поля Bitrix24.

Поля сопоставления для лида

• Вид обращения
• Имя
• Отчество
• Фамилия
• Дата рождения
• Описание источника
• Стадия
• Должность
• Адрес контакта
• Вторая строка адреса
• Город
• Почтовый индекс
• Район
• Область
• Страна
• Код страны
• Идентификатор адреса местоположения
• IS_MANUAL_OPPORTUNITY
• Комментарии
• Привязка лида к компании
• Привязка лида к контакту
• CONTACT_IDS
• LAST_ACTIVITY_TIME
• LAST_ACTIVITY_BY
• Телефон контакта
• Адрес электронной почты
• URL ресурсов лида
• Мессенджеры
• LINK

Для каждого из этих полей можно выбрать соответствующий виджет формы или задать статическое значение.

Сделка

При включении сущности "Сделка" доступны следующие параметры:

• Стадия — стадия сделки, в которую будет отправляться новая запись.
• Поле заголовка — поле формы, значение которого будет использоваться в названии сделки.
• Связать с лидом — автоматически связывает сделку с лидом при создании.
• Добавить ID в заголовок — добавляет ID отправки опроса в заголовок сущности.
• Сопоставление полей — настройка передачи значений из формы в поля сделки.

Поля сопоставления для сделки

• Тип сделки
• Идентификатор направления
• Идентификатор стадии
• Флаг шаблона регулярной сделки
• Признак повторного лида
• Повторное обращение
• Вероятность
• Режим расчёта суммы
• Ставка налога
• Идентификатор привязанной компании
• Идентификатор привязанного контакта
• Дата начала
• Дата завершения
• Завершена
• Комментарии
• Дополнительно об источнике
• Дополнительная информация
• LAST_ACTIVITY_TIME
• LAST_ACTIVITY_BY

Для каждого поля можно выбрать либо конкретное поле формы, либо задать статическое значение.

Контакт

Сущность "Контакт" позволяет передавать данные формы напрямую в карточку контакта Bitrix24.

Поля сопоставления для контакта

• Вид обращения
• Имя
• Отчество
• Фамилия
• Дата рождения
• Описание источника
• Должность
• Адрес контакта
• Вторая строка адреса
• Город
• Почтовый индекс
• Район
• Область
• Страна
• Код страны
• Идентификатор адреса местоположения
• Комментарии
• Рекламная система
• Последняя активность
• Автор последней активности в таймлайне
• Телефон контакта
• Адрес электронной почты
• URL ресурсов контакта
• Мессенджеры
• LINK

Для каждого поля можно выбрать значение из конкретного виджета формы или указать статическое значение.

Компания

Сущность "Компания" используется для создания или заполнения карточки компании в Bitrix24.

Для неё доступны следующие параметры:

• Поле заголовка — поле формы, значение которого будет использоваться в названии сущности.
• Поле названия компании — поле формы, из которого будет подставляться название компании.
• Добавить ID в заголовок — добавляет ID отправки опроса в заголовок сущности.
• Сопоставление полей — настройка передачи значений из формы в поля компании.

Поля сопоставления для компании

• Адрес контакта
• Вторая строка адреса
• Город
• Почтовый индекс
• Район
• Область
• Страна
• Код страны
• Идентификатор адреса местоположения
• Юридический адрес
• Юридический адрес контакта
• Вторая строка юридического адреса
• Город юридического адреса
• Почтовый индекс юридического адреса
• Район юридического адреса
• Область юридического адреса
• Страна юридического адреса
• Код страны юридического адреса
• Юридический адрес: идентификатор адреса местоположения
• Банковские реквизиты
• Сфера деятельности
• Кол-во сотрудников
• Валюта
• Годовой оборот
• Комментарии
• Моя компания
• Контакт
• Рекламная система
• Последняя активность
• Автор последней активности в таймлайне
• Телефон контакта
• Адрес электронной почты
• URL ресурсов контакта
• Мессенджеры
• LINK

Для каждого из этих полей можно выбрать поле формы или задать статическое значение.

Что важно учитывать

• Каждая сущность включается и настраивается отдельно.
• Если вы хотите передавать данные сразу в несколько сущностей, например в лид и сделку, нужно отдельно включить и настроить каждую из них.
• После настройки рекомендуем отправить тестовый ответ, чтобы убедиться, что данные корректно передаются в нужные поля Bitrix24.

Важно: в текущей реализации данные по интеграции передаются только в основную воронку Bitrix24 (ID 0). Если необходимо направлять сделки в другую воронку, рекомендуем настроить логику маршрутизации внутри самого Bitrix24.