Интеграция BigDuck.ai с AmoCRM

Одним из ключевых преимуществ нашей платформы BigDuck.ai является возможность научить бота общаться с любой внешней системой, имеющей API. Схема работы достаточно проста, для интеграции с внешней системой, необходимо:

• Реализовать HTTP-сервис, который будет обрабатывать входящие от бота запросы. Данный сервис будет является посредником между ботом и внешней системой.
• Реализовать промпт, который подразумевает вызов необходимых методов (например, метод создания карточки)
• Заполнить контракт между ботом и реализованным сервисом в настройках бота.

Основной “подкапотной” технологией данного решения являются “OpenAI Function Calling”. Для наглядности, приведем верхнеуровневую схему взаимодействия:

Исходя из схемы очевидна последовательность операций данного решения, а инициатором является принятие решения о вызове функции со стороны OpenAI.

В данном руководстве мы рассмотрим пример использования функционала “External API” на примере подключения к AmoCRM.

Прежде всего, необходимо авторизоваться в панели управления ботами:

Далее, переходим в раздел Chatbots и выбираем Edit для необходимого бота:

Нас интересует вкладка External API, перейдем прямо в нее:

Заполняем форму “API gateway”, тут все просто:

• URL: адрес сервиса-посредника
• API Token: токен авторизации для вашего сервиса, его можно передавать как в теле запроса, так и в заголовке, также есть возможность указать имя (ключ) для токена

Переходим к самому интересному, форма API specification:

Описания значений каждого из полей можно заметить прямо на форме, продублируем:

• API Name: короткий комментарий для нас
• Path: endpoint нашего метода
• The purpose of the API call: Get или Post запрос
• Select the type of result: тип возвращаемого ответа
• Description of the action: важнейшее поле описания, на которое бот будет опираться при принятии решения о вызове метода

Далее, как только все необходимые поля будут заполнены, форма расширяется для заполнения более подробной информации о методе:

Пример заполненного метода для интеграции с AmoCRM:

После заполнения спецификации, необходимо модернизировать промпт бота, добавив в него условия вызова определенных методов, которые мы заполнили в рассматриваемом разделе. Также, после обновления промпта и спецификации API, обязательно нужно перейти в раздел Deploy и активировать тренировку бота

Таким образом, используя возможности нашей платформы BigDuck.ai, горизонт use-case’ов интегрированных AI ботов колоссален и ограничен лишь возможностями API внешних систем.

Бонус: несколько примеров хороших промптов от нашего промпт-инженера.

• Простой промпт на английском:

When the client has provided a phone number - call the lead creation method and pass the data received from the client: client name, client email, client phone number, date of meeting with the client. If the client has not provided an email or date of meeting, pass Null, and if the client has not provided a name - pass Unknown.

• С очередностью действий (алгоритмические указания):

Если клиент задает вопрос про финансы: Оплата в кредит/рассрочку/возврат средств, то { 

1. Сначала отправь сообщение в TG чат финансового отдела с информацией: 

• - имя клиента
• - номер WhatsApp
• - текст обращения клиента

2. Ответь клиенту: [client_name], я передала ваш запрос нашим специалистам из финансового отдела. Они свяжутся с вами в ближайшее время, чтобы предложить наилучшие решения специально для вас.

}