Товары и наличие
Предоставьте характеристики, цены и наличие, чтобы отвечать на вопросы о вашем каталоге.
Внешний коннектор через API
Подключите данные вашей системы к AI‑агенту в WhatsApp.
Разрешите агенту просматривать заказы, товары, записи и настройки в ходе беседы. Ваш API предоставляет данные; Whatsplaid использует релевантную информацию, чтобы помочь клиенту.
Источник знаний
Ассистент в WhatsApp
От вопроса к ответу
01
Клиент задаёт вопросАгент определяет, когда требуются системные данные.
02
Агент собирает идентификаторЭлектронная почта, мобильный номер или код — в соответствии с вашими настройками.
03
Ваш API возвращает данныеПодключённая система определяет, к какой информации можно получить доступ.
04
Разговор продолжается с контекстомАгент использует соответствующие данные для формирования ответа.
Источник знаний с данными, которые нужны вашей операции.
Коннектор может принимать JSON‑объекты или списки с разными структурами. Вы решаете, что предоставлять через API и в каких случаях агент должен обращаться к этим данным, не ограничивая интеграцию одним типом информации.
Заказы и доставки
Вернуть статус заказа, товары и информацию о доставке, разрешённую для клиента.
Регистрационные данные
Предоставьте релевантную информацию из регистрации, чтобы контекстуализировать обслуживание.
Настройки аккаунта
Помогите агенту понять контекст клиента с помощью данных конфигурации, потребления или лимитов, возвращаемых вашим ПО.
Настройте подключение и укажите, когда оно подключается к разговору.
Техническая настройка находится в разделе Developers. После тестирования и активации коннектора выберите API в качестве источника знаний в настройках AI-агента.
01Подключите ваш API
В разделе Разработчики откройте Внешние коннекторы и выберите Базу знаний через API. Укажите базовый HTTPS‑URL и токен Bearer при необходимости.
02Установите идентификатор и протестируйте
Настройте endpoint, идентификатор запроса и имя параметра, ожидаемого API. Перед продолжением протестируйте на существующей записи.
03Настройте срабатывание
На этапе активации опишите, когда коннектор должен срабатывать в разговоре. Например: запрашивать данные аккаунта, когда клиент сообщает о технической проблеме, и попросить зарегистрированный адрес электронной почты, если он ещё недоступен.
04Выберите источник в агенте
Включите и сохраните коннектор. В AI-агенте откройте Базу знаний, выберите Внешний коннектор через API, включите его использование и сохраните изменения.
05Подтвердить обслуживание
Тестируйте разговоры с идентификатором и без, проверьте ответы и отслеживайте вызовы в «Недавней активности». Настройте инструкции под назначение вашей API.
Ваш API контролирует данные. Агент ведет разговор.
Запрос выполняется, когда контекст и настроенные инструкции требуют информацию из внешнего источника. Общие вопросы и приветствия по-прежнему обрабатываются службой агента.
Авторизация в вашей системеУказанный идентификатор не подтверждает личность клиента. Ваш API должна применять правила доступа и возвращать только авторизованные данные.
Консультация во время обслуживанияAPI возвращает информацию, доступную в вашей системе в данный момент. Обновление и доступность этих данных зависят от подключенного источника.
Источник, выбранный агентомПри выборе API этот агент использует внешний коннектор в качестве базы знаний. Файлы и Google Sheets больше не будут запрашиваться им.
Что нужно знать перед подключением вашей API.
Нужно ли мне готовить API?
Да. Ваша система должна предоставлять публичный HTTPS-эндпоинт, который получает настроенный идентификатор и возвращает JSON-объект или список с данными. Команда, отвечающая за систему, готовит интеграцию и правила доступа.
Могу ли я вернуть разные типы информации?
Да. Ответ может объединять разные авторизованные данные в одну JSON-структуру. Каждый агент использует коннектор; вы можете расширять данные, возвращаемые API вашей системы.
Агент консультируется при каждом сообщении?
Нет. Он учитывает контекст разговора и указания, заданные в Разделе «Когда коннектор должен срабатывать в разговоре». Если ему нужен идентификатор и он ещё недоступен, он запросит эту информацию у клиента.
Подключаемый модуль изменяет данные в моей системе?
Эта функция выполняет GET-запросы для получения информации. Это не механизм для создания, обновления или удаления записей в подключенной системе.
В чем разница по сравнению с публичным API Whatsplaid?
Без внешнего коннектора Whatsplaid обращается к вашему API для поддержки обслуживания. При использовании публичного API ваша система вызывает Whatsplaid для управления функциями платформы. Ознакомьтесь с публичным API и вебхуками.
Подключите данные вашей системы к разговору.
Выберите источник знаний, соответствующий вашей работе: внешнее API, электронные таблицы или документы. Google Sheets · Импорт документов