Встроенные функции
Расширьте возможности агента — позвольте ему обращаться к внешним сервисам.
Встроенные функции — это преднастроенные вызовы популярных сервисов, которые агент может выполнять во время диалога. Они не требуют настройки схем и endpoint’ов — всё уже готово к использованию.
Чтобы подключить встроенную функцию к агенту:
- Перейдите на страницу Агенты и откройте раздел Функции.

- Нажмите кнопку Добавить функцию.

- Выберите нужную функцию.

В настоящий момент доступна одна встроенная функция — Создание сделки в amoCRM. Она позволяет агенту автоматически создавать сделки в вашей CRM без ручной настройки внешних запросов.
Создание сделки в amoCRM
Настройка функции
На этапе настройки необходимо выполнить два шага:
Подробная инструкция по получению токена доступна по ссылке.
Если данные введены корректно, ниже появится зелёный индикатор успешного подключения.

Доступные параметры:
- Название
- Бюджет
- Воронка
Для каждого параметра можно указать, как именно агент будет получать его значение:
- Заранее заданное (постоянное значение).
- Или получаемое в ходе диалога — на основе информации от пользователя.
Например, название сделки может формироваться динамически, в зависимости от контекста беседы, а воронка — оставаться фиксированной.

Пример инструкции для агента при использовании функции
Чтобы встроенная функция работала корректно, агенту необходимо дать чёткую инструкцию: когда именно вызывать функцию и какие значения передавать в параметры. Ниже — пример такой инструкции для сценария аренды апартаментов:
Как получить токен в amoCRM
Чтобы подключить встроенную функцию создания сделки, необходимо указать поддомен и долгосрочный токен доступа к вашему аккаунту amoCRM.
Создание такого токена осуществляется через интерфейс amoCRM и занимает всего несколько минут. Подробности вы также можете найти в официальной документации amoCRM.
Шаги для получения токена:
- Войдите в свой аккаунт amoCRM и перейдите в раздел amoMarket. Там выберите пункт Создать интеграцию в верхнем правом углу.

- В появившемся окне выберите вариант Создание внешней интеграции.

- Укажите произвольные название и описание, отметьте Предоставить доступ: Все, затем нажмите Сохранить.

- После сохранения откройте вкладку Установленные, находящуюся на этой же странице amoMarket вверху слева, найдите созданную интеграцию в списке и нажмите на неё.

- Перейдите во вкладку Ключи и доступы и нажмите кнопку Создать токен.

- В открывшемся окне укажите дату истечения токена и нажмите Подтвердить.

- Скопируйте сгенерированный токен — он понадобится при настройке функции в агенте.
