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

Окно «Настройка интеграций»

Все интеграции IDENT с внешними сервисами настраиваются в одном месте: «Настройки» (1) → «Интеграции» (2) → «Внешние сервисы» (3) → «Настройка интеграций» (4).

Для осуществления настроек необходимо право доступа «Настройка интеграций». У сотрудника с ролью «Директор» оно есть по умолчанию.

Откроется окно «Настройка интеграций». Чтобы задать параметры интеграции для нужного вам сервиса, нажмите на «+»:

для сервисов, связанных с маркетинговыми активностями, — на большой «+» в левом верхнем углу (1),
для системных интеграций — на «+» в строке сервиса (2), у Google Календаря — значок редактирования .

❗ В первой строке вы увидите значения по умолчанию для каждого параметра интеграции. Если для добавляемых сервисов вы эти значения не меняете, они будут подставлены из строки «По умолчанию» и выделены курсивом (1). Если же вы зададите свои параметры вручную — шрифт будет обычным (2). В дальнейшем вы можете ввести другие значения по умолчанию, и везде, где они не заданы вручную, они будут автоматически заменены.

➡ Проверка состояния интеграций
➡ Проверка кэша интеграций

Системные интеграции

Настройка интеграции с Google Календарем

Доступ к Google Календарю позволяет врачу клиники видеть свое расписание где угодно и на любом удобном устройстве (компьютере, ноутбуке, планшете, телефоне).

Это единственная из системных интеграций без кнопки «+», а сразу с кнопкой для редактирования (1), потому что доступ к Google Календарю организует техподдержка IDENT (у остальных сервисов кнопка редактирования появляется уже после того как вы их добавите).

Обратите внимание на поле «Параметры авторизации» во всплывающем окне. Если доступ не открыт, в этом поле отображается подсказка: «Для настройки обратитесь в техническую поддержку» (2).

Поле «Название» (3) здесь обычно не заполняется, оно оставлено по аналогии с другими сервисами, на которых у клиники может быть несколько личных кабинетов.

В поле «Роль для автозапуска» (4) должен быть выбран, как минимум, один вариант («Администратор» или «Директор»), иначе не получится закончить настройку. По умолчанию галочкой отмечен «Администратор», так как именно компьютер администратора, как правило, включен все время работы клиники. Если в клинике нет выделенного администратора, выберите «Директор».

«Таймаут» 45 секунд (5) (время ожидания ответа перед появлением информации об ошибке), заданный по умолчанию, можно изменить — уменьшать его нет смысла, но можно увеличить, если соединение с интернетом не очень хорошее.

Когда с нашей стороны будет включена синхронизация Google Календаря (1), параметры синхронизации (интервал и «На сколько дней вперед обновлять»), заданные по умолчанию (2), можно изменить. Для сохранения настроек нажмите на «ОК» (3).

➡ Настройка Google Календаря на телефоне — инструкция по настройке.
➡ Google Календарь — о том, как работает интеграция с календарем.

Настройка интеграции с сервисом геокодирования

Мы работаем с сервисом геокодирования DaData, так как цены Яндекс и Google за получение координат на данный момент очень высоки. DaData — платный сервис, работающий только по России.

Чтобы настроить работу по определению координат адресов пациентов, нажмите на «+» (1) и в появившемся окне выберите из выпадающего списка сервис геокодирования (2).

Поле «Название» здесь обычно не заполняется, оно оставлено по аналогии с другими сервисами, на которых у клиники может быть несколько личных кабинетов.

В поле «Роль для автозапуска» (2) должен быть выбран, как минимум, один вариант («Администратор» или «Директор»), иначе не получится закончить настройку. По умолчанию галочкой отмечен «Администратор», так как именно компьютер администратора, как правило, включен все время работы клиники. Если в клинике нет выделенного администратора, выберите «Директор».

В поле «Параметры авторизации» необходимо указать (1) URL (изначально это делаем мы), а также ключ доступа к API и секретный ключ доступа к API, которые вы получите при регистрации (2) на сайте DaData.

«Таймаут» 45 секунд (3) (время ожидания ответа перед появлением информации об ошибке), заданный по умолчанию, можно увеличить, если соединение с интернетом не очень хорошее (уменьшать его нет смысла).

При включении синхронизации координат адресов (4) перед вами откроется поле с уже добавленными нами по умолчанию интервалом синхронизации и интервалами проверки распознанных адресов (5). Вы можете изменить эти параметры.

О том, как работает синхронизация с сервисом геокодирования, читайте здесь.

У сервисов геокодирования в настройках есть специфическое поле «Адрес и координаты». Оно необходимо для сохранения координат клиники, что позволяет избегать ошибок в определении местоположения пациентов, у которых в карточке адрес указан не полностью. Ошибки могут быть связаны с тем, что города с одинаковыми названиями (Советск, Кировск, Фокино) могут встречаться в разных регионах России. Кроме того, почти в каждом городе есть улица Ленина или проспект Мира.

Нам нужны два значения — широта и долгота (1). Поле «Адрес клиники» (2) является вспомогательным, необходимым только для распознавания координат; указанные в нем данные не сохраняются после завершения настроек.

Введите адрес вашей клиники (2) и нажмите «Распознать» (3). В строку «Адрес клиники» вернется опознанный адрес. Если он корректный — координаты правильные. Если нет (например, «теряется» номер дома) — перейдите по ссылке в любой картографический сервис (4) и возьмите координаты оттуда.

Для сохранения настроек нажмите «ОК» (5).

После произведения настроек интеграции с сервисами геокодирования можно в этом же окне проверить работоспособность настроек авторизации. Для этого нажмите на кнопку «Проверить» (1). Результат проверки вы увидите в поле ниже (2). В случае ошибки при нажатии на кнопку «Подробнее» (3) вы можете скачать полный отчет по результатам взаимодействия с сервисом (что IDENT посылал ему, что он ответил) и выяснить причину, если что-то не работает. О дальнейшей проверке состояния интеграций читайте здесь.

Настройка интеграции с СМС-центром

На данный момент единственный сервис отправки сообщений, который отвечает нашим требованиям, — это СМС-центр. Он обеспечивает качество доставки до 98–99%, высокую стабильность работы серверов, предлагает доступные тарифы и полное юридическое сопровождение. Самостоятельно регистрироваться у всех возможных операторов связи невероятно трудозатратно.

Чтобы настроить параметры отправки сообщений, нажмите на «+» в строке «Сервис рассылок».

В поле «Роль для автозапуска» должен быть выбран, как минимум, один вариант, иначе не получится закончить настройку. По умолчанию галочкой отмечен «Администратор», так как именно компьютер администратора, как правило, включен все время работы клиники. Если в клинике нет выделенного администратора, выберите «Директор» или другую роль.

В поле «Параметры авторизации» указан URL. Если сервис изменит URL, вы можете самостоятельно указать новую информацию. Введите логин и пароль от личного кабинета СМС-центра, которые вы получили при регистрации.

«Таймаут» — время ожидания ответа перед появлением информации об ошибке. По умолчанию задано 45 секунд. Можно увеличить, если соединение с интернетом не очень хорошее. Уменьшать — нет смысла.

Отправка СМС

Чтобы включить отправку СМС, поставьте галочку.

В этом окне вы можете самостоятельно изменять «Шаблоны СМС». Если прием один, то его шаблон можно задавать в поле «Для одного приема». Если же вы хотите отправить информацию сразу по нескольким приемам, то можно сделать это в виде общего сообщения, содержание которого задается в шаблоне «Для нескольких приемов». Это позволит сэкономить деньги, да и пациенту будет удобнее сразу увидеть информацию обо всех своих будущих приемах. Справа от каждого шаблона вы увидите, как будет выглядеть СМС (Предпросмотр).

Если приемов несколько, то информацию о каждом из них нужно сформировать в одинаковом формате, который задается в поле «Тег {Прием}». Этот же формат можно использовать и при отправке сообщения об одном приеме.

Если клиника с филиалами, то внутри тега {Приемы} будут также отображаться телефон и адрес филиала, в котором назначен прием. Эта информация берется из справочника «Клиника и кресла».

Чтобы изменить шаблон СМС-оповещения, нажмите правой кнопкой мыши и выберите необходимые теги.

В поле «Проверка доставки СМС» можно изменить параметры проверки, заданные по умолчанию. Проверка доставки СМС экономит ваше время. Информация в форме «Рассылки» будет обновляться автоматически, также автоматически будет обновляться статус СМС в расписании.

Отправка e-mail

❗ Для отправки электронных писем добавьте ваш адрес электронной почты в личный кабинет СМС-центра и подтвердите его. Чтобы после этого не перезаходить в «Настройки интеграций», в IDENT нажмите «Обновить список адресатов».

В поле «Отправка e-mail» подгрузится отправитель — ваш подтвержденный адрес электронной почты из личного кабинета СМС-центра. В поле «Шаблон подписи e-mail» можно добавить стандартную подпись клиники.

В этом же окне вы можете проверить работоспособность настроек авторизации — кнопка «Проверить». О дальнейшей проверке состояния интеграций читайте здесь.

Для сохранения параметров отправки сообщений нажмите «ОК».

Подробнее о том, как работает интеграция с сервисом отправки сообщений, читайте здесь.

Маркетинговые интеграции

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

Телефония

Интеграция с телефонией относится к маркетинговым интеграциям, для настройки которых необходимо нажать на «+» (1) («Добавить») в левом верхнем углу окна «Настройка интеграций» и выбрать из выпадающего меню (2) нужный сервис (3).

Поле «Название» (1) заполняется, если на одном и том же сервисе у клиники несколько личных кабинетов. Либо вы просто хотите как-то по-другому видеть этот сервис в списке.

В поле «Роли для автозапуска» (2) должен быть выбран, как минимум, один вариант, иначе не получится закончить настройку. По умолчанию галочкой отмечен «Администратор», так как именно компьютер администратора, как правило, включен все время работы клиники.

«Параметры авторизации» должны быть заполнены полностью. При выборе нужного сервиса — CoMagic или UIS (3), URL подставится в соответствующее поле (4). «Ключ доступа к API» (5) вы можете получить в своем личном кабинете. Параметры в полях «Максимальный период отчета в днях» и «Лимит на запрос» заданы по умолчанию, их можно не менять.

«Таймаут» 45 секунд (6) (время ожидания ответа перед появлением информации об ошибке), заданный по умолчанию, можно увеличить, если соединение с интернетом не очень хорошее (уменьшать его нет смысла).

У телефонии включается «Получение звонков» (7). Интервал синхронизации (8) (180 минут — то есть каждые 3 часа запускается задача по загрузке информации о вызовах в базу данных IDENT), заданный по умолчанию, можно изменить. «Дата начала синхронизации» — текущий день (9).

О том, как работает интеграция с сервисами телефонии, читайте здесь. О том, как настроить инициализацию и фильтрацию вызовов, читайте здесь.

Заявки

Чтобы получать заявки в IDENT, поставьте галочку в поле «Получение заявок» (1). По умолчанию задан интервал синхронизации (2) — 2 минуты, его можно изменить. «Дата начала синхронизации» — текущий день (3).

Если у вас есть несколько филиалов с раздельными базами IDENT и с одним личным кабинетом UIS, вы можете разделить поток заявок по филиалам. Для этого в личном кабинете UIS создайте для каждого филиала группу сотрудников, включите «Распределение заявок по группам сотрудников» и добавьте группы в список. Назовите группы сотрудников по названиям филиалов. Это могут быть названия улиц или станций метро, на которых находятся клиники. Эти названия отображаются в форме для сбора заявок на сайте. Так пациент поймет, куда он записывается.

О том, как настраиваются группы сотрудников в личном кабинете UIS, читайте здесь.

После настройки групп сотрудников откройте в IDENT «Настройки интеграций» («Настройки» → «Интеграции» → «Внешние сервисы» → «Настройка интеграций») → нажмите «Изменить» в строке «UIS/CoMagic v2.0» → разверните строку «Получение заявок» (1) → в поле «Добавить в исключения» (2) выберите из выпадающего списка группы сотрудников, заявки которым вы не хотите получать в этой базе IDENT → нажмите «+» («Добавить»). Филиалы появятся в поле «Список исключений» (3).

У вас может появиться новый филиал, который использует тот же аккаунт UIS. Администраторы будут получать заявки всех филиалов, пока вы не добавите другие клиники в исключения в каждой базе IDENT.

В этом же окне вы можете проверить работоспособность настроек авторизации — кнопка «Проверить» (1). А при нажатии на кнопку «Подробнее» (2) вы можете скачать полный отчет по результатам взаимодействия с сервисом (что IDENT посылал ему, что он ответил) и выяснить причину, если что-то не работает. О дальнейшей проверке состояния интеграций читайте здесь.

Для сохранения настроек нажмите «ОК» (3).

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

Flexbe — популярный конструктор лендингов, который позволяет собирать заявки потенциальных клиентов и, что особенно важно, сохраняет все заявки у себя (о требованиях к сервисам получения заявок читайте здесь). Поэтому среди всех конструкторов лендингов мы на сегодняшний день работаем только с Flexbe.

Для настройки интеграции с Flexbe нажмите на «+» (1) («Добавить») в левом верхнем углу и выберите из выпадающего меню этот сервис (2).

Поле «Название» (1) заполняется, если на одном и том же сервисе у клиники несколько личных кабинетов.

Далее необходимо заполнить «Параметры авторизации» (3) — URL и ключ доступа к API.

«Таймаут» 45 секунд (4) (время ожидания ответа перед появлением информации об ошибке), заданный по умолчанию, можно увеличить, если соединение с интернетом не очень хорошее (уменьшать его нет смысла).

«Получение заявок» включается проставлением соответствующей галочки (5). Интервал синхронизации (6) (2 минуты), заданный по умолчанию, можно изменить, но уменьшать интервал до 1 минуты можно только при очень хорошем интернет-соединении. Подробнее о том, как работает интеграция с сервисами онлайн-записи читайте здесь.

Так как Flexbe — это конструктор, то в форме заявки на Flexbe можно настроить любые поля (7), но для того чтобы эти поля загрузились, нужно их сопоставить с полями в IDENT. Наиболее популярными полями в формах Flexbe являются «Имя», «Телефон», «Электронная почта», «Комментарий», сопоставление для них настроено по умолчанию. Вы можете сократить количество полей в заявке (для работы интеграции достаточно только телефона), поменять их порядок или добавить свои поля. Главное — правильно настроить сопоставление, которое производится или по «Типу поля» или по «Имени поля». И то, и другое вы задаете сами на Flexbe. Важно: Если вы ошибетесь в этом сопоставлении, то часть полей заявки просто не будет сохранена в IDENT, поэтому настраивайте внимательно и тестируйте получение заявок после настройки!

В этом же окне вы можете проверить работоспособность настроек авторизации (1) (кнопка «Проверить»). А при нажатии на кнопку «Подробнее» (2) вы можете скачать полный отчет по результатам взаимодействия с сервисом (что IDENT посылал ему, что он ответил) и выяснить причину, если что-то не работает. О дальнейшей проверке состояния интеграций читайте здесь.

Для сохранения настроек нажмите «ОК» (3).

Настройки интеграции с НаПоправку, ПроДокторов, СберЗдоровье, 32top

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

У IDENT возможна интеграция с четырьмя медицинскими сайтами-агрегаторами — НаПоправку, ПроДокторов, СберЗдоровье, 32top. На все четыре вы можете выгружать расписание из IDENT, а с сервисов НаПоправку и 32top — еще и собирать заявки.

Для настройки интеграции с НаПоправку, ПроДокторов, СберЗдоровье или 32top нажмите на «+» (1) («Добавить») в левом верхнем углу окна «Настройка интеграций» и выберите из выпадающего меню нужный сервис (2).

В «Параметрах авторизации» (3) URL изначально вводим мы (но если сервис в какой-то момент изменит URL, вы можете самостоятельно указать новую информацию). Параметры, необходимые для авторизации, вам предоставят сотрудники соответствующего сервиса

У всех четырех сервисов включается «Выгрузка расписания» (5).

Параметры выгрузки расписания (6) можно редактировать. Интервал синхронизации (10 минут), заданный по умолчанию, можно изменить. Также по умолчанию указано, что выгрузка расписания должна осуществляться за 30 дней, но если вы знаете свое расписание только на 2 недели вперед, вы можно уменьшить этот параметр и поставить, например, 14 или 15 (кроме НаПоправку — на данный момент у них всегда 32 дня). А вот менять параметр «На сколько часов вперед не выгружать расписание» стоит только если вы очень быстро обрабатываете заявки. Для нас 2 часа — это оптимальное время, учитывающее и интервал синхронизации, и задержку в работе сайта-агрегатора, и скорость работы администратора клиники, и время, которое человеку нужно потратить на дорогу до вас. Подробнее о том, как работает интеграция с сервисами онлайн-записи читайте здесь.

Галочка «Использовать правила» (7) касается настройки «Правил выгрузки расписания» (см. далее). Такая настройка необходима, так как не у всех агрегаторов возможна разбивка врачей в расписании на стороне сервиса.

«Правила выгрузки расписания» являются общими для всех сервисов, на которые выгружается расписание, если у них стоит галочка «Использовать правила» (см. картинку выше). Отдельно настроить правила для конкретного сервиса нельзя.

Чтобы настроить «Правила выгрузки расписания», нужно нажать на кнопку (1) в верхней части окна «Настройка интеграций». «Длину талона» (по умолчанию она 15 минут) можно изменить (2). Если кого-то из врачей с помощью специального переключателя (3) исключить из выгрузки, для новых сотрудников активировать выгрузку расписания нужно будет вручную.

Новые правила сохраняются автоматически, вы можете просто закрыть всплывающее окно.

У НаПоправку и 32top также включается «Получение заявок» (1). Интервал синхронизации (2) (2 минуты), заданный по умолчанию, можно изменить, но уменьшать интервал до 1 минуты можно только при очень хорошем интернет-соединении.

В этом же окне вы можете проверить работоспособность настроек авторизации (3) (кнопка «Проверить»). А при нажатии на кнопку «Подробнее» (4) вы можете скачать полный отчет по результатам взаимодействия с сервисом (что IDENT посылал ему, что он ответил) и выяснить причину, если что-то не работает. О дальнейшей проверке состояния интеграций читайте здесь.

Нажмите «ОК» для сохранения настроек (5).

Настройка интеграции с собственным сервисом клиники

У вас также есть возможность задать параметры интеграции для собственного сервиса клиники (о требованиях к собственному сервису интеграции читайте здесь).

Нажмите на «+» (1) в левом верхнем углу и выберите из выпадающего списка «Собственный сервис клиники» (2).

Если собственных сервисов у вас несколько (например, сайт, свой сервис телефонии), нужно отдельно произвести настройки для каждого и каждому присвоить название (1).

В «Параметрах авторизации» (3) необходимо выбрать «Тип подключения». Если выбрали прямой доступ к базе данных — MySql или MSSql (подробности об этом варианте интеграции читайте здесь), если нет — HTTP (подробности об этом варианте интеграции читайте здесь). Для каждого типа подключения заполняются свои параметры авторизации.

В зависимости от специфики сервиса вы решаете, какой функционал необходимо включить (5): если это сервис телефонии — «Получение звонков», если вы будете осуществлять сбор заявок с сайта — «Получение заявок», если вы собираетесь выгружать расписание из программы на свой сайт — «Выгрузку расписания».

Если вы настраиваете интеграцию с собственным сервисом телефонии, интервал получения звонков (1) (3 часа), заданный по умолчанию, можно изменить (о том, как работает интеграция с телефонией, читайте здесь).

При выборе прямого доступа к базе данных в каждом блоке настроек есть возможность настроить названия таблиц (2) (подробности здесь).

Если вы настраиваете интеграцию с собственным сервисом получения заявок, интервал (1) (2 минуты), заданный по умолчанию, можно изменить, но уменьшать его до 1 минуты можно только при очень хорошем интернет-соединении (о том, как работает интеграция с сервисами онлайн-записи, читайте здесь).

Если вы настраиваете интеграцию с собственным сервисом по выгрузке расписания, вы также можете изменить параметры, заданные по умолчанию (2), — интервал выгрузки (10 минут), «За сколько дней вперед выгружать» (30 дней) и «На сколько часов вперед за сегодня не выгружать» (2 часа) (о том, как работает выгрузка расписания, читайте здесь). Количество дней, за которые нужно выгрузить расписание, устанавливается в зависимости от того, на сколько дней вперед вы знаете свое расписание. А вот менять параметр «На сколько часов вперед не выгружать расписание» стоит только если вы очень быстро обрабатываете заявки. Для нас 2 часа — это оптимальное время, учитывающее и интервал синхронизации, и задержку в работе сайта-агрегатора, и скорость работы администратора клиники, и время, которое человеку нужно потратить на дорогу до вас.

При HTTP-подключении в «Выгрузке расписания» появляется дополнительный параметр — «Сжатие данных» (1). Сжатие передаваемых данных уменьшает нагрузку на сеть, но это возможно только в том случае, если вы сделаете поддержку сжатия на своем сервере. Для получения заявок этот формат выбирается автоматически, а для выгрузки расписания это невозможно, поэтому нужно выбирать вручную.

Галочка «Использовать правила» (2) касается настройки «Правил выгрузки расписания», которые являются общими для всех сервисов, на которые выгружается расписание.

Вернемся к окну настройки параметров интеграции. В нем вы также можете проверить работоспособность настроек авторизации (1) (кнопка «Проверить»). В случае ошибки при нажатии на кнопку «Подробнее» (2) вы можете скачать полный отчет по результатам взаимодействия с сервисом (что IDENT посылал ему, что он ответил) и выяснить причину, если что-то не работает. О дальнейшей проверке состояния интеграций читайте здесь.

Для сохранения настроек нажмите «ОК» (3).