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

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

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

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

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

Для продолжения нажмите на интересующие вас настройки:

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

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

О проверке состояния интеграций читайте здесь, о проверке кэша интеграций — здесь.

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

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

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

Это единственная из системных интеграций без кнопки «+», а сразу с кнопкой для редактирования (1) (изображение карандаша), потому что доступ к Google-календарю организует Техническая поддержка IDENT (у остальных сервисов кнопка редактирования появляется уже после того как вы их добавите). Обратите внимание на поле «Параметры авторизации» во всплывающем окне, в нем будет отображаться подсказка: «Для настройки обратитесь в техническую поддержку» (2).   

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

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

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

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

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

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

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

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

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

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

Отличие настроек DaData и Sputnik состоит в том, что у последнего не нужно вводить никакой ключ доступа — бесплатный Sputnik публично доступен и не требует авторизации. Поэтому достаточно ввести только URL (3). Это поле заполняем мы, но если сервис в какой-то момент изменит URL, вы можете самостоятельно указать новую информацию.

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

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

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

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

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

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

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

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

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

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

Чтобы настроить параметры отправки СМС, нажмите на «+» (1). 

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

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

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

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

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

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

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

Чтобы изменить любой из шаблонов СМС, нажмите на нем правой кнопкой мыши (1) и выберите необходимые теги (2).

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

Если вы решите не включать автоматическую проверку доставки (например, ради экономии трафика интернета), это никак не повлияет на отправку СМС. Проверять, доставились ли сообщения, можно и вручную: CRM → «Рассылки» → кнопка «Обновить». 

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

Для сохранения параметров отправки СМС нажмите на «ОК» (4).

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

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

На данный момент мы работаем только с телефонией UIS, потому что пока только у UIS есть все механизмы интеграции (API), необходимые для корректной работы модуля «Маркетинг» в IDENT.

Важно: Так как UIS возвращает время звонков по московскому времени (а мы конвертируем его в локальный часовой пояс, заданный в программе IDENT), перед тем как настраивать интеграцию с UIS, необходимо в личном кабинете обязательно указать московский часовой пояс. Иначе, если вы находитесь в другом часовом поясе,  у вас в IDENT будет отображаться некорректное время звонка.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройки интеграции с НаПоправку, ПроДокторов, DocDoc

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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