Наверх
Подписаться

Настройка интеграции с Битрикс24

Содержание

 

Об интеграции

Интеграция Calltouch и Битрикс24 позволяет по звонкам и/или заявкам в Calltouch создавать лиды, сделки и контакты в Битрикс24. Синхронизация данных происходит с помощью промежуточного сервиса albato.ru в режиме реального времени. Для настройки интеграции понадобиться добавить специальное приложение в Битрикс24, включить API Calltouch и настроить промежуточный сервис albato.ru. Рассмотрим более детальнее данный процесс интеграции.

 

1. Подготовка к интеграции

 

1.1. Создание приложения в Битрикс24

Чтобы Calltouch смог передавать в Ваш Битрикс24 данные по новым лидам, ему необходимо предоставить для этого доступ, создав специальное приложение в Битрикс24. Для этого необходимо на главной странице Битрикс24 в разделе "Приложения" основного меню кликнуть на кнопку "Добавить приложение":

 

Далее Вам будет предложено создать приложения либо для личного использования, либо для публикации в каталоге. Необходимо выбрать вариант "для личного использования":

 

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

  • Название приложения: Calltouch
  • Приложение использует только API: опция включена
  • Права доступа: CRM, Пользователи и Живая лента (другие возможно доступные права необязательны)
  • Укажите ссылку: http://albato.ru/settings/bitrix24/gateway

 

Теперь в созданном приложении появятся уникальные авторизационные данные:

  • Код приложения
  • Ключ приложения

 

Эти данные будут необходимы для доступа внешней системы к Вашей Битрикс24 - в данном случае сервиса albato.ru, который будет передавать данные из Calltouch в Ваш Битрикс24 при помощи данного приложения. Не закрывайте вкладку с данным окном и приступайте к настройке следующего этапа интеграции, т.к. код и ключ данного приложения понадобятся далее.

 

1.2. Регистрация в промежуточном сервисе albato.ru

Сервис albato.ru позволяет связывать между собой разные системы, в том числе Calltouch и Битрикс24, и синхронизировать данные между ними. Для регистрации в данном сервисе перейдите по ссылке:

https://albato.ru/user/signup

Укажите свой e-mail, придумайте пароль и введите инвайт - любой из пригласительных кодов ниже:

  • 1837574972352783
  • 6098564936720573
  • 1945302765948352
  • 5683366924440013
  • 4620698735272057

Не закрывайте вкладку с данным окном и приступайте к настройке следующего этапа интеграции.

 

1.3. Настройка API Calltouch

Данные из Calltouch в Битрикс24 будут передаваться через промежуточный сервиса albato.ru при помощи API Calltouch. Для использования последнего понадобятся авторизационные доступы:

  • Идентификатор Вашего сайта в Calltouch
  • Токен для доступа по API для Вашего сайта к Calltouch

Получить их можно в разделе "Настройки => API" личного кабинета Calltouch, включив соответствующую опцию "Включить/отключить Calltouch API":

Обратите внимание! Чтобы настройки применились, не забудьте сохранить их после включения опции "Включить/отключить Calltouch API".

Не закрывайте вкладку с данным окном и приступайте к настройке следующего этапа интеграции, т.к. токен и ID сайта понадобятся далее.

 

1.4. Настройка учетной записи Битрикс24 в сервисе albato.ru 

Для передачи данных из albato.ru, полученных от Calltouch, в Битрикс24, необходимо настроить соответствующую учетную запись Битрикс24 в сервисе albato.ru. Чтобы этого сделать, необходимо перейти в раздел "Настройки => Битрикс24" сервиса albato.ru:

 

 

В открывшимся окне добавить новое подключение с помощью одноименной кнопки:

 

Далее следует указать авторизационные данные, по которым сервис albato.ru получит доступ в Ваш Битрикс24 для передачи данных из Calltouch:

Поле Значение
Название Произвольное название, в данном примере это адрес нашего тестового домена в Битрикс24 calltouch.bitrix24.ru.
Код и ключ приложения Авторизационные данные, полученные на первом этапе настройке интеграции (см.выше).
Домен Битрикс24 Ваш домен в сервисе Битрикс24, в данном примере это адрес тестового домена в Битрикс24 calltouch.bitrix24.ru.
Формат телефонного номера По умолчанию 71234567890. Из выпадающего списка необходимо указать в каком формате передавать номера клиентов из Calltouch в Ваш Битрикс24, а так же в каком формате они уже хранятся в нем, для поиска дубликатов при передачи номеров.
Доступ к CRM Опция включена, обязательна для работы интеграции.
Доступ к списку пользователей Опция включена, обязательна для работы интеграции.

Обратите внимание! Ключ доступа будет сгенерирован автоматически после сохранения настроек. Информация о нем носит технический харакетр и далее при настройки интеграции он Вам не понадобится.

 

1.5. Настройка учетной записи Calltouch в сервисе albato.ru

Для передачи данных из Calltouch в albato.ru и дальнейшей передачи их в Ваш Битрикс24, необходимо настроить соответствующую учетную запись Calltouch в сервисе albato.ru. Чтобы этого сделать, необходимо перейти в раздел "Настройки => Calltouch" сервиса albato.ru:

 

В открывшимся окне добавляем подключение по API с помощью одноименной кнопки:

 

Далее следует указать авторизационные данные, по которым сервис albato.ru получит доступ в Ваш личный кабинет Calltouch для передачи данных по звонкам и заявкам в Ваш Битрикс24:

 

  • Название: название Вашего аккаунта в Calltouch, в данном примере calltouch.ru.
  • ID сайта и токен API: идентификатор Вашего сайта в Calltouch и токен для доступа по API к Calltouch из предыдущего этапа (см.выше).

 

2. Настройка интеграции

 

2.1. Передача данных по звонку или заявки из Calltouch в Битрикс24

После того, как учетные записи Битрикс24 и Calltouch созданы и настроены в сервисе albato.ru, можно приступить непосредственно к самой настройке передачи данных. По звонку и/или заявки из Calltouch в Битрикс могут автоматически создаваться:

  • Новые лиды
  • Новые контакты
  • Новые сделки

Чтобы настроить передачу каких-либо данных выше из Calltouch в Битрикс24 необходимо перейти в раздел "Мои интеграции" сервиса albato.ru и кликнуть по кнопке "Добавить интеграцию":

 

Далее Вам будет предложено выбрать из какой системы и в какую систему передавать данные. Необходимо выбрать соответственно из Calltouch в Битрикс24:

 

Затем предстоит выбрать по какому событию в Calltouch какое событие создавать в Битрикс24. Для передачи звонков и/или заявок из Calltouch в Битрикс24 необходимо выбрать соответствующие опции:

Исходное событие в Calltouch Входящий звонок или заявка в зависимости от того, какие данные Вы хотели бы передавать из Calltouch
Целевое действие в Битрикс24 Новый лид или новый контакт или новая сделка в зависимости от того, какое действие по звонку или заявки Вы хотели бы получать в Вашем Битрикс24.

В данном примере рассмотрим наиболее распространенную комбинацию настроек - передача звонков из Calltouch и создание лидов в Битрикс24. Далее же все другие возможные комбинации, например, передача заявок из Calltouch и создание по ним лидов в Битрикс24, настраиваются абсолютно так же по аналогии.

 

После выбора типа передаваемых из Calltouch и получаемых в Битрикс24 данных, необходимо указать какие заранее созданные на предыдущих этапах аккаунты для этого использовать:

 

В следующем окне потребуется установить значения передаваемых данных из Calltouch в новый лид Битрикс24. Данные из Calltouch передаются в поля лида, контакта или сделки Битрикс24. Настроить передаваемые значения в поля Битрикс24 можно при помощи заранее заготовленных шаблонов из выпадающего меню у правого края каждого поля:

Все поля настраиваются по Вашему усмотрению, однако для удобства, Вы можете воспользоваться предложенными нами значениями ниже:

Поле Предлагаемое значение
Заголовок Укажите вручную названия новых лидов, добавив к нему номер звонящего, дату и время звонка.
Телефон Укажите шаблон номера звонящего.
Ответственный Выберите из выпадающего списка ответственного за новые лиды в Битрикс24 (аккаунт Битрикс24).
Комментарии Укажите шаблон номера звонящего.
Город Укажите шаблон города звонящего. Город посетителя определяется в Calltouch по его IP-адресу.
Источник

Тип лида в Битрикс24:

  • CALL для звонка
  • WEB для заявки
Дополнительно об источнике Укажите шаблон источника звонка и типа трафика.
Доступно для всех

Кто из Ваших пользователей Битрикс24 увидит новый лид:

  • Y - все
  • N - только выбранный ответственный выше
  • Не выбрано -  - только выбранный ответственный выше
Зарегистрировать в живой ленте Если опция включена, новый лид будет появляться в ленте CRM Битрикс24.
Обработка дубликатов

Поиск дубликатов происходит по номеру телефона клиента. Выберите как следует поступать, если новый лид содержит телефон клиента, уже зарегистрированный в Вашем Битрикс24:

  • Не проверять на дубликаты, всегда создавать новую запись (по умолчанию)
  • Не создавать новую запись, если найден дубликат
  • Обновить существующую запись, если найден дубликат

Совет

Перечисленный выше набор полей позволяет выгружать только основную информацию по новому лиду из Calltouch в Битрикс24, такую как номер звонившего, источник звонка, дату и время звонка, а так же теги. Если Вы желаете выгружать в Битрикс24 абсолютно всю информацию о новом лиде, например utm-метки, возможно настроить дополнительные поля для передачи данных, о чем будет рассказано далее.

 

Завершив настройки передаваемых данных из Calltouch в Битрикс24, сохраните изменения, после чего Вы вернетесь в раздел "Мои интеграции", где отобразиться Ваша только что настроенная интеграция для создания новых лидов в Битрикс24 по звонку из Calltouch, останется лишь только активировать ее соответствующей кнопкой!

 

2.2. Проверка работы интеграции

Если интеграция настроена корректно, после ее запуска статус изменится на "работает":

 

А в Битрикс24 будут автоматически передаваться новые лиды, контакты или сделки по звонкам и/или заявкам из Calltouch:

 

Детально просмотреть информацию по лиду, в том числе источник звонка, можно просто кликнув по его названию:

 

2.3. Логирование передаваемых данных 

В случае возникновения каких-либо вопросов по переданным данным из Calltouch в Битрикс24, Вы всегда сможете просмотреть всю их историю с помощью одноименной кнопки: "История операций":

 

После чего откроется окно с логами всех переданных данных из Calltouch и созданных данных в Битрикс24:

Совет

В случае возникновения каких-либо ошибок в работе интеграции, сообщите, пожалуйста, об этом в службу технической поддержки Calltouch, отправив заявку на почту info@calltouch.net и прикрепив скриншот логов из данного окна.

 

2.4. Комбинированная передача данных из Calltouch в Битрикс24 

Чтобы по звонку и/или заявки из Calltouch в Битрикс24 создавать одновременно и новый лид, и новый контакт и новую сделку, можно добавить в одну интеграцию albato.ru, например, рассмотренную "по звонку из Calltouch" выше, одновременно несколько целевых действия в Битрикс24.

Для этого необходимо перейти в раздел "Мои интеграции" сервиса albato.ru и кликнуть на иконке "Редактировать интеграцию":

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

 

Перед Вами откроется схема работы данной интеграции, где с помощью кнопки + можно добавить неограниченное количество исходящих действий (новый лид, новый контакт, новая сделка) в Битрикс24 по одному звонку и/или заявки в Calltouch:

 

После нажатия на кнопку + необходимо выбрать целевое действие, передаваемое в Битрикс24, например, новый контакт:

 

В результате по одному звонку и/или заявке из Calltouch в Битрикс24 будут автоматически совершены сразу два действия: создание нового лида и создание нового контакта. Аналогичным образом, можно добавить одновременное создание и сделки.

После добавления новых действий, в каждом из них нужно настроить поля, в которые будут передаваться данные из Calltouch в Битрикс24, по аналогии с настройкой полей для нового лида, что были сделаны на этапе ранее, нажав на кнопку "Настройки" рядом с новым добавленным действием:

 

Таким образом можно настроить все возможные комбинации передаваемых данных:

  • По звонку: новый лид, новый контакт, новая сделка
  • По заявке: новый лид, новый контакт, новая сделка

Обратите внимание! Разумеется, необязательно настраивать их все, необходимо настроить только те интеграции, которые необходимы Вам.

 

2.5. Настройка дополнительных полей

Ранее на этапе 2.1. в примере настройки передачи данных по звонку или заявки из Calltouch в Битрикс24, мы настроили только стандартные поля, в которые передавались лишь основные данные по звонку, такие как: номер звонившего, источник звонка, дату и время звонка, а так же теги. Однако, если Вы желаете выгружать в Битрикс24 абсолютно всю информацию о новом лиде, например utm-метки, возможно настроить дополнительные поля для передачи данных.

Чтобы передавать какие-либо дополнительные данные из Calltouch в Битрикс24, в последнем должны быть заранее настроены соответствующие CRM поля для этого, а в промежуточном сервисе albato.ru должны быть настроены шаблоны передаваемых данных в эти CRM поля. Таким образом, настройку дополнительных полей можно разбить на 2 этапа:

  • Настройка дополнительных полей в Битрикс24
  • Настройка дополнительный полей в albato.ru

Рассмотрим каждый этап более детальнее.

 

2.5.1. Настройка дополнительных полей в Битрикс24

Для примера, настроим дополнительные поля для передачи utm-меток. Вначале необходимо создать соответствующие поля в разделе "CRM => Настройки => Настройки форм и отчетов => Пользовательские поля" личного кабинете Битрикс24:

 

В данном примере мы добавим новые поля для лида, кликнув на соответствующую надпись "Добавить поле":

Обратите внимание! Добавление полей для лидов, контактов или сделок происходит по отдельности, но настраивается по аналогии.

 

В открывшимся окне создания нового поля, укажите только его название и, не меняя остальных настроек, сохраните изменения. В данном примере название поля "utm_source":

 

Создайте, аналогичным способом с помощью кнопки "Добавить поле" еще четыре поля для лидов:

  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

 

В результате у Вас должно получится 5 полей со стандартными utm-метками для лидов:

 

2.5.2. Настройка дополнительный полей в albato.ru

После того, как Вы подготовили необходимые поля в Битрикс24, можно приступать к их настройке в промежуточном сервисе albato.ru. Для настройки полей в albato.ru, перейдите в раздел "Настройки => Битрикс24":

 

Далее кликнете по кнопке в виде карандаша "Редактировать запись":

 

Затем перейдите в необходимый Вам раздел, в зависимости от того, какие поля Вы до этого настраивали в Битрикс24:

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

В открывшимся разделе кликните по кнопке "Обновить пользовательские поля". В данном примере мы настраивали поля для лида, поэтому в этом разделе и произведем обновление пользовательских полей для лида:

 

После обновления, в albato.ru автоматически подгрузятся созданные Вами на этапе 2.5.1. пользовательские поля из Битрикс24:

 

Теперь осталось только настроить шаблоны передаваемых в них данных из Calltouch. Перейдите в раздел "Мои интеграции", выберете необходимую интеграцию "по звонку" и/или "по заявке" и нажмите на иконку в виде карандаша "Редактировать интеграцию":

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

 

Следующим шагом перейдите в раздел "Настройки" соответствующего целевого действия. В данном примере мы рассматриваем "Новый лид":

 

А затем настройте шаблоны новых полей для utm-меток, аналогично тому, как Вы это делали ранее на этапе 2.1. и сохраните изменения, после чего настройка передачи дополнительных полей будет завершена!

Обратите внимание! После выполнения настроек не забудьте активировать интеграцию обратно.

 

Если все настройки дополнительных полей выполнены успешно, данные по ним будут передаваться в детальную статистику по лиду, контакту или сделки в зависимости от настроек. В данном примере просмотреть ее можно, например, кликнув на ссылку "Показать поля", находясь внутри какого-либо лида:

 

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 9 из 9
Еще есть вопросы? Отправить запрос

0 Комментарии

Войдите в службу, чтобы оставить комментарий.