Bitrix 24. Подключение коннектора

Дата:

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

Шаг 1. Перейдите во вкладку “Источники данных” и нажмите на кнопку “Плюс”.

Добавление источника данных

Шаг 2. В появившемся окне, найдите “Bitrix24” и нажмите кнопку “Добавить”.

Находим среди списка сисьем Bitrix

Шаг 3. Перед настройкой коннектора добавьте в ваш Bitrix24 приложение Good.Bi.

Наше приложение в MarketPlace

Шаг 4. Перейдите в настройки коннектора. Для подключения коннектора, вам необходимо указать url портала без "https://" (пример: xxx.bitrix24.ru). После нажмите кнопку “Авторизоваться в Bitrix24”.

Авторизуем наше приложение


Настройка импорта данных c помощью вэбхуков

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

Шаг 1. Перейдите в вашу CRM Bitrix24 в раздел "Приложения" -> Разработчикам

Раздел Приложения

Шаг 2. Выберете пункт "Другое"

Раздел Разработчикам

Шаг 3. Для отправки событий из вашей CRM выберете пункт "Исходящий вебхук"

Исходящий вебхук

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

Базовый адрес для настройки webhook:

https://webhook.good.bi/<ВАШ_ДОМЕН>/bitrix24_<ТИП_СОБЫТИЯ>/

Настройте все типы событий отдельными вэбхуками. В поле "URL вашего обработчика " нужно будет подставить адрес для соответствующего типа события, не забыв подменить <ВАШ_ДОМЕН> на домен Вашей CRM без "https://".

На данный момент наш сервис поддерживает следующие типы событий:

  1. Добавление сделки https://webhook.good.bi/<ВАШ_ДОМЕН>/bitrix24_ONCRMDEALADD/
  2. Обновление сделки https://webhook.good.bi/<ВАШ_ДОМЕН>/bitrix24_ONCRMDEALUPDATE/
  3. Удаление сделки https://webhook.good.bi/<ВАШ_ДОМЕН>/bitrix24_ONCRMDEALDELETE/
  4. Удаление лида https://webhook.good.bi/<ВАШ_ДОМЕН>/bitrix24_ONCRMLEADDELETE/

Пример настройки исходящего вебхука.

Пример настройки исходящего вебхука``

Описание таблиц в базе данных

Каждый источник данных создает набор таблиц в вашей базе данных

Во вкладках ниже вы сможете найти шаблон имени таблицы и описание создаваемых колонок в таблице

Название таблицы:
bitrix24_(project_id)_contacts
Название колонки Описание
date Дата создания контакта
contact_id ИД контакта
created_by_id ИД пользователя
name Имя
last_name Фамилия
second_name Отчество
address Адрес
address_2 Адрес 2
address_city Город
address_country Страна
assigned_by_id Ид пользователя, создавшего контакт
birthdate Дата рождения
comments Комментарий
date_create Дата создания
date_modify Дата редактирования
phone Телефон
email Email
phones Массив телефонов
emails Массив email
source_id Ид источника
source_description Описание источника
Название таблицы:
bitrix24_(project_id)_leads
Название колонки Описание
lead_id Ид лида
date Дата
title Заголовок лида
company_id Ид Компании
contact_id Ид контакта
assigned_by_id Ид пользователя, создавшего лид
source_id Ид источника
source_description Описание источника
date_create Дата создания
date_modify Дата модифиикации
date_closed Дата закрытия
status_id Ид Статуса
status_semantic_id Классификация статуса (S-success,F-failure,P-process)
utm_campaign utm_campaign
utm_content utm_content
utm_medium utm_medium
utm_source utm_source
utm_term utm_term
phones Массив телефонов
emails Массив почт
is_return_customer Признак повторного лида
Название таблицы:
bitrix24_(project_id)_deals
Название колонки Описание
deal_id Ид сделки
date Дата модификации
date_create Дата создания
date_modify Дата модификации сделки
assigned_by_id Пользователь, который привязан к сделке
begindate Дата начала
category_id Идентификатор категории сделки
closed Закрыта?
closedate Дата закрытия
comments Комментарий
company_id Ид компании
contact_id Ид контакта
created_by_id Создана пользователем
currency_id Идентификатор валюты сделки
is_return_customer Является вернувшимся покупателем
lead_id Ид лида
opportunity Сумма
probability Вероятность
quote_id Идентификатор квоты
stage_id Идентификатор стадии
stage_semantic_id Классификация статуса (S-success,F-failure,P-process)
title Название
type_id Тип сделки
utm_campaign utm_campaign
utm_content utm_content
utm_medium utm_medium
utm_source utm_source
utm_term utm_term
modify_by_id Ид автора последнего изменения
source_id Ид источника
source_description Описание источника
Название таблицы:
bitrix24_(project_id)_users
Название колонки Описание
user_id Ид пользователя
active Активен?
email Email
name Имя
last_name Фамилия
second_name Отчество
personal_gender Пол
personal_profession Профессия
personal_www Домашняя страничка
personal_birthday Дата рождения
personal_photo Фотография
personal_icq ICQ
personal_phone Личный телефон
personal_fax Факс
personal_mobile Личный мобильный
personal_pager Пейджер
personal_street Улица проживания
personal_city Город проживания
personal_state Область / край
personal_zip Почтовый индекс
personal_country Страна
work_company Компания
work_position Должность
work_phone Рабочий телефон
uf_department Подразделения
uf_interests Интересы
uf_skills Навыки
uf_web_sites Другие сайты
uf_xing Xing
uf_linkedin LinkedIn
uf_facebook Facebook
uf_twitter Twitter
uf_skype Skype
uf_district Район
uf_phone_inner Внутренний телефон
user_type Тип пользвателя
Название таблицы:
bitrix24_(project_id)_department
Название колонки Описание
department_id ID подразделения
name Название подразделения
sort Порядок сортировки
parent Вышестоящее подразделение
uf_head Руководитель
Название таблицы:
bitrix24_(project_id)_company
Название колонки Описание
company_id Ид компании
address Адрес контакта
address_2 Вторая страница адреса
address_city Город
address_country Страна
address_region Район
assigned_by_id Связано с пользователем по ID
comments Комментарии
company_type Тип компании
created_by_id Кем создана
currency_id Валюта
date_create Дата создания
date_modify Дата изменения
industry Сфера деятельности
is_my_company Моя компания
lead_id Идентификатор лида, связанного с контактом
opened Доступен для всех
phone Телефон контакта
reg_address Юридический адрес контакта
revenue Годовой оборот
title Название
utm_campaign utm_campaign
utm_content utm_content
utm_medium utm_medium
utm_source utm_source
utm_term utm_term
web URL ресурсов контакта
Название таблицы:
bitrix24_(project_id)_activity
Название колонки Описание
activity_id Id Активности
associated_entity_id Идентификатор связанной с активностью сущности
author_id Создатель активности
completed Завершено
description Описание
description_type Тип описания (contenttype)
direction Направление активности: входящее/исходящее (activitydirection)
editor_id Кто изменил
end_time Время завершения
last_updated Время завершения
location Местоположение
notify_type Тип уведомлений (activitynotifytype)
notify_value Значение уведомления
owner_id Собственник
owner_type_id Тип собственника (ownertype)
responsible_id Ответственный
result_currency_id Идентификатор результата
result_mark Метка результата
result_source_id Идентификатор источника результата
result_status Статус результата
result_stream Статистика отчётов
result_sum Сумма результата
result_value Значение результата
settings Настройки
start_time Время начала выполнения
status Статус
subject Субьект
type_id Тип (activitytype)
origin_id Идентификатор элемента в источнике данных
files Добавленные файлы
Название таблицы:
bitrix24_(project_id)_deals_history
Название колонки Описание
deal_id Ид сделки
date_modify Дата модификации
assigned_by_id Пользователь, который привязан к сделке
closed Сделка закрыта?
contact_id Ид контакта привязанного к сделке
lead_id Ид Лида привязанного к сделке
stage_id Ид статуса сделки
stage_name Имя (историческое из интерфейса)
stage_semantic_id Классификация статуса (S-success,F-failure,P-process)
title Заголовок сделки
modify_by_id Ид автора последнего изменения
opportunity Сумма
Название таблицы:
bitrix24_(project_id)_deals_stages_history
Название колонки Описание
id Наш внутренний ид. Не используйте этот столбец
date Дата и время попадания на стадию
deal_id Идентификатор сделки
type_id Тип записи. Может принимать значения: 1 - создание сущности, 2 - перевод на промежуточную стадию, 3 - перевод на финальную стадию
stage_id Идентификатор статуса сделки
stage_semantic_id Классификация статуса (S-success,F-failure,P-process)
category_id Идентификатор направления (воронки)
responsible_id Пользователь, который привязан к сделке
Название таблицы:
bitrix24_(project_id)_leads_stages_history
Название колонки Описание
id Наш внутренний ид. Не используйте этот столбец
date Дата и время попадания на стадию
lead_id Идентификатор лида
type_id Тип записи. Может принимать значения: 1 - создание сущности, 2 - перевод на промежуточную стадию, 3 - перевод на финальную стадию
status_id Идентификатор статуса лида
status_semantic_id Классификация статуса (S-success,F-failure,P-process)
Название таблицы:
bitrix24_(project_id)_deal_category
Название колонки Описание
category_id Ид категории
created_date Дата создания
name Имя категории
is_locked Заблокирована?
sort Порядок сортировки
Название таблицы:
bitrix24_(project_id)_deal_stages
Название колонки Описание
status_id Ид стадии
name Имя стадии
sort Порядок сортировки
category_id Ид категории
Название таблицы:
bitrix24_(project_id)_deals_contacts
Название колонки Описание
deal_id Ид сделки
contact_id Ид контакта
role_id ИД роли
sort Порядок сортировки
is_primary Является основным?
Название таблицы:
bitrix24_(project_id)_activity_type
Название колонки Описание
activity_type_id Ид типа активности
name Наименование типа активности
Название таблицы:
bitrix24_(project_id)_calls_history
Название колонки Описание
bx24_id Идентификатор звонка (для внутренних целей)
call_id Идентификатор звонка
call_type Тип вызова (см. описание типов звонка)
call_vote По умолчанию - 0. Оценка звонка используется только для внутренней телефонии
comment Комментарий к звонку
portal_user_id Идентификатор ответившего оператора (если это тип звонка: 2 - Входящий) или идентификатор позвонившего оператора (если это тип звонка: 1 - Исходящий)
portal_number Номер, на который поступил звонок (если это тип звонка: 2 - Входящий) или номер, с которого был совершен звонок (1 - Исходящий
phone_number Номер, с которого звонит абонент (если это тип звонка: 2 - Входящий) или номер, которому звонит оператор (1 - Исходящий)
call_duration Продолжительность звонка в секундах
call_start_date Время инициализации звонка
cost Стоимость звонка
cost_currency Валюта звонка (RUR, USD, EUR)
call_failed_code Код вызова
call_failed_reason Текстовое описание кода вызова (латиница)
crm_activity_id Идентификатор активности CRM, созданного на основании звонка
crm_entity_id Идентификатор объекта CRM, к которому прикреплена активность
crm_entity_type Тип объекта CRM, к которому прикреплена активность, например: LEAD
rest_api_id Идентификатор приложения интеграции внешней телефонии
rest_app_name Название приложения интеграции внешней телефонии
redial_attempt Номер попытки дозвониться (для обратных звонков)
session_id Идентификатор сессии звонка на стороне Voximplant
transcript_id Идентификатор расшифровки звонка
transcript_pending Y или N.Признак того, что расшифровка будет получена позднее
record_file_id Идентификатор файла с записью звонка
Название таблицы:
bitrix24_(project_id)_activity_direction
Название колонки Описание
activity_direction_id Ид направления
name Наименование направления
Название таблицы:
bitrix24_(project_id)_activity_status
Название колонки Описание
activity_status_id Ид статуса
name Наименование статуса
Название таблицы:
bitrix24_(project_id)_ownertype
Название колонки Описание
ownertype_id Ид типа сущности
name Наименование типа сущности
Название таблицы:
bitrix24_(project_id)_user_fields
Название колонки Описание
user_field_id Ид пользовательского поля
entity_id Идентификатор родительской сущности
field_name Название поля
form_label Заголовок поля
user_type_id Строковой код типа
xml_id Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы.
sort Сортировка
multiple Множественность
mandatory Обязательность
show_filter Показ в фильтре
show_in_list Показ в списке
edit_in_list Изменение в списке
is_searchable Возможность поиска
settings Настройки
list Набор значений
Название таблицы:
bitrix24_(project_id)_user_fields_values
Название колонки Описание
user_field_id Ид пользовательского поля
field_name Название поля
value_id Ид значения
sort Сортировка значений
value Значение
Название таблицы:
bitrix24_(project_id)_deals_fields
Название колонки Описание
deal_id Ид сделки
field_name Название поля
value Значение
Название таблицы:
bitrix24_(project_id)_leads_fields
Название колонки Описание
lead_id Ид лида
field_name Название поля
value Значение
Название таблицы:
bitrix24_(project_id)_statuses
Название колонки Описание
system_id Ид статуса
entity_id Ид сущности
status_id Ид статуса
name Название
name_init Первое название
sort Порядок сортировки
category_id Ид категории
system Является ли статус системным?
semantics Классификация статуса (S-success,F-failure,P-process)
extra Дополнительная информация