Интеграции¶

В разделе "Интеграции" в вертикальном меню можно настроить обмен данными между eVa и сторонними системами. Пропишите сценарии, в каких случаях ИИ-ассистент будет обращаться к сторонней системе, и подкрепляйте ответы ИИ полноценными данными. Например, таким образом можно записывать клиентов на приём: ИИ-ассистент получит свободные слоты из сторонней СРМ, а затем запишет клиента на приём в эту же СРМ, сделав запись в свободном слоте.

В eVa можно настроить несколько типов интеграции: YClients, AmoCRM, 1C Salon или любую другую систему с открытой API-документацией.

Для добавления интеграции нажмите .

Для редактирования настроек или отключения интеграции нажмите на меню действий справа от неё:

REST API¶

Этот тип интеграции подключает любую стороннюю систему при помощи API-запросов.

Для каждого запроса нужно будет добавить новую интеграцию.

Для подключения необходимо заполнить следующие поля:

Включено - запуск работы интеграции.
Тип - REST API.
Имя метода - название конкретного метода, например, Запрос расписания.
Метод - разновидность запроса: get, post, put, delete.
URL - содержимое запроса.
Заголовки HTTP.
Описание - промпт для ИИ. Подробно опишите, в каких случаях ИИ должен обратиться к этому методу, и как интерпретировать результат.
Параметры запроса. Для добавления нового параметра нажмите и заполните окно добавления параметра.

Обязательный параметр - отметьте, если параметр будет являться неотъемлемой частью запроса.
Название параметра - сам параметр, как он передаётся в запросе.
Тип параметра: массив, булевый, целое число, число, строка, объект.
Описание - за что отвечает этот параметр, какие данные он передаёт или добавляет.

YClients¶

Интеграция с сервисом YClients оплачивается отдельно!

При подключенной интеграции eVa в автоматическом режиме запрашивает для разговоров всё содержимое YClients вместе с историей посещений, а также сопоставляет номера телефонов и email с данными существующих клиентов.

Для подключения YClients потребуется произвести настройки на стороне YClients и на стороне eVa.

Настройки на стороне eVa¶

После нажатия в разделе "Интеграции" необходимо заполнить следующие поля.

Включено - запуск работы интеграции.
Тип - YClients.
Имя метода - YClients.
Уведомлять клиентов о предстоящей записи. Активируйте флажок, если нужно задать промпт уведомлений при записи на приём/встречу, а также для автоматической отправки уведомлений перед началом приёма/встречи. После установки флажка появятся дополнительные окна для заполнения:

ID компаний - нужно заполнить, если в YClients у вас несколько филиалов. Чтобы получить ID, перейдите в YClients, нажмите на название филиала в левом верхнем углу страницы, выберите филиал и скопируйте число в адресной строке:

Вставьте это число в блоке "ID компаний" по кнопке "Добавить":

Приватное приложение - активируйте, если вы хотите подключить собственное приложение в YClients. В этом случае его настройки нужно прописать вручную:

Настройки на стороне YClients¶

1. Перейдите в YClients. В боковом меню нажмите "Интеграции" и в поисковой строке введите "eva":

Или перейдите по ссылке https://yclients.com/e/mp_24435_eva/

2. Откроется страница приложения eVa. Нажмите "Подключить" в правой части страницы.

3. На открывшейся странице выберите филиалы, с которыми будет работать eVa:

4. На следующей странице согласитесь с предупреждением о предоставляемом доступе:

5. Вы окажетесь на странице регистрации/входа в eVa. Нажмите внизу страницы на кнопку входа и введите ваш логин и пароль от eVa.

Если подключение успешно, на странице приложения eVa в YClients справа будет кнопка отключения приложения.

Оплата подключения YClients¶

После того, как предыдущие шаги выполнены, в разделе "Интеграции" справа от интеграции появится кнопка оплаты:

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

По нажатию на вы перейдёте на страницу оплаты:

Если вы хотите произвести оплату по счёту на юрлицо или ИП, пожалуйста, обратитесь в поддержку eVa.

AmoCRM¶

При подключенной интеграции eVa в автоматическом режиме запрашивает для разговоров всё содержимое вашего аккаунта AmoCRM, а также сопоставляет номера телефонов и email с данными существующих клиентов. В случае несовпадения ИИ создаёт в AmoCRM новую сделку.
В чатах Амо можно будет вызвать ИИ в чат через ввод /AI.

Для подключения интеграции необходимо произвести настройки как на стороне АмоСРМ, так и на стороне eVa.

Настройки на стороне AmoCRM¶

Зайдите в вашу AmoCRM в раздел "amo Маркет" в боковом меню. В правом верхнем углу раздела нажмите меню в виде троеточия и выберите "Создать интеграцию":

В открывшемся окне выберите внешнюю интеграцию:

Далее заполните следующие поля.

Ссылка для перенаправления - https://dashboard.eva.bz
Предоставить доступ - отметьте все варианты списка.
Название интеграции - eVa
Описание интеграции - Интеграция для ИИ-ассистента.

Поля с названием и описанием интеграции можно заполнить любыми другими произвольными данными - важно, чтобы они не остались пустыми, чтобы интеграция сохранилась.

Остальные поля заполнять не нужно.

После нажатия перейдите на вкладку "Установленные" в Амо маркете и выберите вашу интеграцию:

В открывшемся окне на вкладке "Ключи и доступы" в блоке "Долгосрочный токен" нажмите "Сгенерировать токен".

Выберите дату истечения токена - лучше максимально отдалённую. Нажмите "Подтвердить".

Токен сгенерирован, теперь его можно скопировать.

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

Настройки на стороне eVa¶

В разделе Интеграции нажмите и заполните следующие поля.

Включено - запуск работы интеграции.
Тип - AmoCRM.
Имя метода - AmoCRM.
Домен - ваш домен в AmoCRM, ссылка, по которой вы входите в СРМ.
Долгосрочный токен, сгенерированный на предыдущем этапе в АмоСРМ.

После заполнения всех данных обратитесь в службу поддержки eVa с запросом на подключение AmoCRM. В запросе укажите ваш номер клиента Амо. Чтобы его получить, нажмите в AmoCRM на профиль вверху слева:

1C Salon¶

При подключенной интеграции eVa в автоматическом режиме запрашивает для разговоров всё содержимое вашего аккаунта 1C Salon, а также сопоставляет номера телефонов и email с данными существующих клиентов.

Прежде всего необходимо приобрести у 1С подписку для поддержки API. Её можно заказать в их службе поддержки. Вместе с подпиской вам выдадут необходимые данные для заполнения в eVa.

Для подключения интеграции перейдите в eVa в раздел Интеграции, нажмите и заполните следующие поля.

Включено - запуск работы интеграции.
Тип - 1C Salon.
Имя метода - 1C Salon.
API ключ - получен при приобретении подписки 1С.
API ключ терминала самообслуживания - получен при приобретении подписки 1С.
Уведомлять клиентов о предстоящей записи. Активируйте флажок, если нужно задать промпт уведомлений при записи на приём/встречу, а также для автоматической отправки уведомлений перед началом приёма/встречи. После установки флажка появятся дополнительные окна для заполнения:

Филиалы - требуются, если в вашей 1С прописано несколько филиалов. После нажатия кнопки "Добавить" требуется заполнить следующие поля для каждого филиала:

ID филиала - получен в 1С.
Описание - название филиала.
Временная зона - разница с UTC (+3 для московского времени).