Инструкция по Модулю
для Мегаплана
"Подсказки DaData"

Глубокая интеграция сервиса подсказок
DaData.ru и Мегаплана
#ДелаемМегапланЛучшеВместе
МОДУЛЬ ПОДСКАЗКИ DADATA — предназначен для интеграции CRM Мегаплан с сервисом DaData. Помогает в Мегаплан добавлять и редактировать данные клиентов, умеет создавать плательщика.
На основании географических координат, внесённых в клиента или сделку с помощью виджета — в Мегаплане отображает на карте местоположение, с краткой информацией об этом объекте и возможностью быстрого перехода как в клиента, так и в сделку.
ПОШАГОВАЯ ИНСТРУКЦИЯ
Шаг 1. Регистрация, Авторизация

Для установки модуля, необходимо зарегистрироваться в сервисе https://beta.polytell.ru , пройти авторизацию своего аккаунта Мегаплана и произвести предварительные общие настройки для модулей Polytell, согласно инструкции.
Также, нужно зарегистрироваться в сервисе подсказок DaData.
Подключение модуля
Шаг 2. Подключение модуля

Следующим шагом, подключаем модуль Подсказки DaData.
Можно подключить бесплатную версию или оплатить полнофункциональную версию модуля.
Отличия бесплатной и платной версий

Как оплатить модуль ►
Оплату можно сделать на сайте, методом списания стоимости модуля со своего персонального счёта, нажав кнопку "Купить". Если средств на персональном счету будет не достаточно для оплаты модуля, то появится окно с предложением пополнить персональный счёт с помощью платёжных систем через банковскую карту или вариант безналичной оплаты (реквизиты компании нужно будет потом отправить своему менеджеру, чтобы он подготовил счёт).
Замечание. После подключения модуля, отобразится его оплаченный период. Когда он закончится, с персонального
счёта будет автоматически списываться стоимость модуля за 1 месяц, при условии достаточности на нём средств.
Если использование данного модуля больше не предполагается — можно его отключить в Polytell Market.
Если планируется подключить модуль больше чем на 1 месяц, то можно отправить запрос своему менеджеру с просьбой выставить счёт на нужный период.
Настройка интеграции
Шаг 3. Настройка интеграции

Чтобы получить АPI-ключ для интеграции Мегаплана с сервисом DaData, нужно:
Затем в beta.polytell.ru открываем страницу настроек модуля Подсказки DaData и вставляем этот ключ в поле
"DaData API-ключ".

Если нужно, включаем функции:
  • Верхний регистр — полученные данные из сервиса DaData будут записаны в Мегаплан большими буквами.
  • Исключить Отчество — полученные данные человека из сервиса DaData будут записаны в Мегаплан без отчества.
Нажимаем кнопку "Сохранить"

Автоматическое создание Плательщика — при создании клиента через альтернативную форму модуля Подсказки DaData будет автоматически создаваться Плательщик (доступно в платной версии модуля).


Добавление кнопки создания Клиента
с подсказками из DaData в Мегаплан
Шаг 4. Добавление альтернативной кнопки создания Клиента с подсказками из DaData в Мегаплан

В настройках модуля Подсказки DaData находим инструкцию по созданию общего виджета и, согласно ей, добавляем виджет модуля для альтернативного создания клиента.

  • В Мегаплане, заходим в Настройки — Приложения и открываем для редактирования Приложение Polytell, предварительно созданное для авторизации с Мегапланом.
  • Нажимаем кнопку Создать виджет.
Виджет для Мегаплана "Мультипликатор сделок"
  • Копируем код общего виджета со страницы настроек модуля Подсказки DaData и вставляем его в блок Содержимое нового виджета в Мегаплане.
  • Выбираем в новом виджете Плейсхолдер Общий виджет / Виджет телефонии (common_telephony_widget)
  • Пишем Название нового виджета в соответствующем поле.
  • Нажимаем кнопку Сохранить в окне нового виджета.
Виджет для Мегаплана "Мультипликатор сделок"
На странице настройках модуля Подсказки DaData, находим инструкцию "Кнопка создания клиента" и выполняем настройку:

1. Из инструкции по созданию кнопки клиента переходим в свой Мегаплан по ссылке "Пункты меню" (в настройку/редактирование дополнительных пунктов меню Мегаплана, также можно зайти из раздела Настройки — Настройка — Пункты меню).

2. В Мегаплане, добавляем новый пункт меню кнопкой "+ Пункт меню".
3. Вводим Название нового пункта меню, например: + Клиент.
4. Скачиваем иконку и добавляем её как Значок для нового пункта меню.
5. Вводим URL для этого пункта: http://polytell.dadata
6. Нажимаем на кнопку "Добавить пункт".
Настройка автоматического создания плательщика
(доступно в платной версии)
Шаг 5. Настройка автоматического создания плательщика
(доступно в платной версии)


Чтобы при создании клиента через форму модуля Polytell автоматически создавался плательщик, на странице настроек модуля Подсказки DaData:
1. Включаем опцию "Автоматическое создание плательщика".
2. Выбираем Параметры создания Плательщика в Мегаплане: Лицо — Юридическое или Физическое, Страна.
3. Нажимаем кнопку "Сохранить".
4. Нажав на соответствующую кнопку, добавляем поле для выбранного типа плательщика. Выбираем нужное Поле плательщика и указываем, из какого Источника DaData будут браться для него данные.

Если в одно поле плательщика нужно записать данные из нескольких источников сервиса DaData
(например, в поле Адрес записать данные в определённой последовательности), то:
  • после выбора первого Источника DaData — в правой части строки таблицы сопоставления полей нажимаем кнопку "Добавить источник"
  • если нужно, корректируем символ разделителя между предыдущим и текущим источником (по умолчанию, в данной колонке, символ - , но можно ввести любой другой, в том числе пробел)
  • указываем следующий источник из DaData
  • таким же образом, добавляем столько источников, сколько требуется для заполнения текущего поля плательщика.
5. В строке сопоставления полей плательщика нажимаем кнопку "Сохранить"
Подключение виджета в карточку сделки/клиента Мегаплана
(доступно в платной версии)
Шаг 6. Подключение виджета в карточку сделки/клиента Мегаплана
(доступно в платной версии)


В настройках модуля Подсказки DaData находим инструкцию по Подключению виджета и согласно ей, добавляем код виджета модуля Подсказки DaData в Карточку Сделки и/или Клиента Мегаплана.

  • В Мегаплане, заходим в Настройки — Приложения и открываем для редактирования Приложение Polytell, предварительно созданное для авторизации с Мегапланом.
  • Нажимаем кнопку Создать виджет.
Виджет для Мегаплана "Мультипликатор сделок"
  • Копируем код виджета со страницы настроек модуля Подсказки DaData и вставляем его в блок Содержимое нового виджета в Мегаплане.
  • В зависимости от того, для чего мы подключаем виджет (сделки или клиенты), выбираем Плейсхолдер Таб на карточке сделки (deal_card_tabs) или Таб на карточке клиента (client_card_tabs)
  • Пишем Название нового виджета в соответствующем поле.
  • Нажимаем кнопку Сохранить в окне нового виджета.
Виджет для Мегаплана "Мультипликатор сделок"
Переходим на страницу настроек Виджет модуля Подсказки DaData и сопоставляем поля для Виджета в Сделке и/или Клиенте.

Сопоставление полей сделки
:
1. Нажимаем "Добавить схему"
2. Выбираем схему сделок, в которой будет отображаться виджет
3. Нажимаем кнопку "Добавить поле"
4. Выбираем Исходные данные сервиса DaData и Поле из выбранной схемы сделки, в которое они будут записываться
5. После добавления и сопоставления нужных полей выбранной схемы сделок, нажимаем кнопку "Сохранить"

Сопоставление полей клиента:
  • Нажимаем кнопку "Добавить поле".
  • Выбираем Исходные данные сервиса DaData и Поле клиента, в которое они будут записываться.
  • После добавления и сопоставления нужных полей клиента, нажимаем кнопку "Сохранить".

Подключение виджета в карточке Клиента Мегаплана
для создания Плательщика (доступно в платной версии)
Шаг 7. Подключение дополнительного виджета в карточке Клиента Мегаплана для создания Плательщика
(доступно в платной версии)


Открываем страницу Дополнительные настройки модуля Подсказки DaData, находим Инструкцию по созданию дополнительного виджета и согласно ей, добавляем код виджета модуля Подсказки DaData в Карточку Клиента Мегаплана.

  • В Мегаплане, заходим в Настройки — Приложения и открываем для редактирования Приложение Polytell, предварительно созданное для авторизации с Мегапланом.
  • Нажимаем кнопку Создать виджет.
Виджет для Мегаплана "Мультипликатор сделок"
  • Копируем код виджета со страницы дополнительных настроек модуля Подсказки DaData и вставляем его в блок Содержимое нового виджета в Мегаплане.
  • Выбираем Плейсхолдер Блок на карточке клиента(client_card_block)
  • Пишем Название нового виджета в соответствующем поле.
  • Нажимаем кнопку Сохранить в окне нового виджета.
Виджет для Мегаплана "Мультипликатор сделок"
Переходим на страницу Дополнительные настройки модуля Подсказки DaData и выполняем настройку Виджета для создания плательщика в карточке Клиента:
  • В разделе "Поле по которому осуществляется поиск" выбираем дополнительное поле из справочника клиентов (тип поля: Текст), где будет записан ИНН плательщика, которого нужно создать с помощью виджета.
  • Если, с помощью этого виджета нужно записать значение Регион плательщика из DaData в дополнительное поле справочника клиентов (тип поля: Текст), выбираем это поле в соответствующем списке.

  • Если ещё нужно создавать контактное лицо вместе с плательщиком, то включаем соответствующий переключатель.
  • Дополнительный виджет будет создавать плательщика в Мегаплане с Типом "Юр. лицо", Страна "Россия". Нажимаем кнопку "Добавить поле" и сопоставляем значения полей сервиса DaData и данного типа плательщика в Мегаплане.
  • После добавления и сопоставления всех нужных полей плательщика, нажимаем кнопку "Сохранить".
Настройка и подключение Карты клиентов и сделок
в Мегаплане (доступно в платной версии)
Шаг 8. Настройка и подключение Приложения Карта клиентов и сделок в Мегаплане
(доступно в платной версии)


Открываем страницу настроек Карта модуля Подсказки DaData, настраиваем вид Карты в Мегаплане:
1. Выбираем масштаб отображения карты в Мегаплане. Масштаб указывается в формате Google Maps. Примерный уровень детализации, который можно ожидать на каждом уровне масштабирования:
1 - Мир; 5 - Континент; 10 - Город;
15 - Улицы; 20 - Здания
2. Вводим географические координаты города, который будет отображаться в центре карты, при открытии страницы приложения Карта в Мегаплане.

Координаты должны быть в формате Десятичные градусы. Информация про данный формат и о том, как узнать координаты места, есть по ссылке Десятичные градусы над блоком ввода географических координат.
3. В блоке "Поле координат клиента" — выбираем дополнительное поле из справочника клиентов (тип поля: Текст), где будут записываться географические координаты месторасположения клиента.
4. Для настройки отображения сделок на карте, нажимаем кнопку "Добавить поле".
5. Выбираем Схему сделки, которая будет отображаться на карте и Поле координат сделки (тип поля: Строка), в котором указываются географические координаты месторасположения клиента по сделке. Добавляем и сопоставляем столько полей, сколько схем сделок с координатами будут показаны на карте.
6. Для более детальной информации по сделке (Номер сделки с гиперссылкой на неё; Менеджер этой сделки; Клиент по сделке; Сумма сделки; Статус сделки) на карте, включаем функцию "Отображение краткой информации на карте".
Если данная функция выключена, то при клике на отмеченную точку координат сделки на карте, в всплывающем окне будет отображаться только Номер сделки с гиперссылкой на неё и Менеджер этой сделки.
7. Чтобы сохранить настройки отображения карты, нажимаем кнопку "Сохранить".
Подключаем Приложение Карта.

На странице настроек Карты находим инструкцию и создаём приложение в Мегаплане для данного модуля:
1. Открываем Настройки — Приложения в Мегаплане
2. Нажимаем кнопку "Создать приложение".
2. Вводим название нового приложения, например: Карта.
3. Нажимаем кнопку "Сохранить"
4. Со страницы настроек Карта копируем
"URL страницы приложения", расположенный рядом с инструкцией и вставляем его в поле с таким же названием в созданное приложение "Карта" в Мегаплане.
5. Сохраняем настройки созданного приложения в Мегаплане соответствующей кнопкой.

6. На странице настроек модуля Карта копируем "URL для меню", находящийся рядом с инструкцией и заменяем в нём $UUID$ на значение поля UUID из созданного в Мегаплане приложения "Карта", например:
https://company.megaplan.ru/application/page/$UUID$ — скопировали с настроек модуля
4831f73a-4b48-4dce-b6ac-7b5feac0e2dc — значение поля UUID в приложении Мегаплана
https://company.megaplan.ru/application/page/4831f73a-4b48-4dce-b6ac-7b5feac0e2dc — получившийся URL
7. На странице созданного приложения Карта в Мегаплане, в разделе "Пункт меню" кликаем на ссылку "Добавить пункт меню для приложения" и попадаем в добавление пункта меню Мегаплана (в настройку/редактирование дополнительных пунктов меню Мегаплана, также можно зайти из раздела Настройки — Настройка — Пункты меню).
8. Пишем название нового пункта меню в Мегаплане, например: Карта
9. В поле URL вставляем получившееся после редактирования значение "URL для меню".
10. С инструкции по созданию приложения на странице настроек модуля Карта, скачиваем значок для меню Карта по ссылке и прикрепляем его к пункту меню в Мегаплане.
11. Включаем "Оставаться в Мегаплане", чтобы карта открывалась внутри Мегаплана.
12. Указываем в разделе "Показывать для пользователей" сотрудников, добавленных в Polytell, которые могут открывать приложение "Карта" в Мегаплане.
12. Для добавления нового пункта меню в Мегаплан, нажимаем кнопку "Добавить пункт".

Проверка работы альтернативной формы
добавления Клиентов в Мегаплане

Шаг 9. Проверяем работу альтернативной формы добавления клиентов в Мегаплане

После выполненных настроек добавления альтернативной кнопки создания Клиента с подсказками из DaData в Мегаплан в меню Мегаплана появится дополнительный пункт добавления Клиента. При клике на него, появится форма добавления клиентов от Polytell, с подсказками от сервиса DaData.

Подсказки при создании компании через альтернативную форму.

При добавлении нового клиента — можно вводить ИНН, ФИО генерального директора или название компании, интеграция подскажет варианты. Данные справочников DaData регулярно обновляются из различных баз данных, в том числе, данных налоговой службы.
Подсказки при создании контактного лица через альтернативную форму.

При добавлении нового клиента — интеграция сама заполнит пол и подскажет правильно ФИО, а также его сразу можно будет привязать к новой или к уже существующей в Мегаплане компании.

После нажатия на кнопку "Создать" — в Мегаплане появится новый клиент с данными, указанными в форме. Если были выполнены настройки автоматического создания плательщика (в платной версии), то в клиенте будут данные плательщика.
Проверка работы виджета в карточке
сделки/клиента Мегаплана (в платной версии)

Шаг 10. Проверяем работу виджета в карточке сделки/клиента Мегаплана
(в платной версии)


После выполненных настроек добавления виджета в карточке сделки/клиента Мегаплана:

Если был добавлен и настроен виджет в карточку сделки, то в соответствующих схемах сделки появится виджет, в котором можно начать вводить адрес клиента, DaData отобразит подсказки, которые можно выбрать. После того, как в строке виджета выбран нужный адрес, нужно нажать кнопку "+" в виджете.
Тогда в сделке заполнятся указанные в настройках модуля поля — соответствующими значениями из сервиса DaData, которые были в нём для выбранного адреса.

Если был добавлен и настроен виджет в карточке клиента, то он будет работать аналогично — после нажатия кнопки виджета, в клиенте запишутся указанные в настройках модуля поля — соответствующими значениями для указанного адреса
из сервиса DaData.

Проверка работы виджета в карточке Клиента Мегаплана для создания Плательщика (в платной версии)

Шаг 11. Проверяем работу дополнительного виджета в карточке Клиента Мегаплана для создания Плательщика
(в платной версии)

После выполненных настроек добавления дополнительного виджета в карточке Клиента Мегаплана для создания Плательщика, в правой части карточки клиента Мегаплана, в самом низу, появится виджет
"Создать плательщика".
Если в указанном в настройках модуля поле клиента есть ИНН, можно нажать виджет — и тогда в карточке этого клиента будет создан плательщик, с этим ИНН и указанными в настройках модуля полями, с соответствующими значениями из сервиса DaData.

Проверка приложения Карта клиентов и сделок в Мегаплане (в платной версии)
Шаг 12. Проверяем приложение Карта клиентов и сделок в Мегаплане (в платной версии)

После выполненных настроек, в строке меню Мегаплана появится кнопка Карта.

При нажатии на иконку Карта в строке меню Мегаплана, откроется карта клиентов и сделок в Мегаплане.
При просмотре карты, можно пользоваться фильтрами клиентов и сделок.
Обратите внимание, что пользовательские фильтры клиентов и сделок будут видны в приложении Карта в том случае, если к ним есть доступ у сотрудника, от имени которого было создано приложение Polytell для авторизации в Мегаплане.
Оставьте заявку на
консультацию или покупку
#МегапланДелаемЛучшеВместе
Нажимая на кнопку, вы соглашаетесь на обработку персональных данных
и политикой конфиденциальности