FAQ
Last updated
Тумблер для открытия виджета Дебага заблокирован и становится доступен только после того, как Агент обучен. Чтобы открыть виджет Дебага, необходимо для начала обучить Агента, нажав кнопку TRAIN.
За данный сценарий отвечает Подслот fallback, который автоматически генерируется при создании кнопочного меню. После этого Подслота можно построить любой сценарий на ваш выбор, например, попросить Собеседника выбрать одну из кнопок и поставить слот Jump , переводящий Сценарий агента обратно в кнопочное меню.
Контекстная переменная — переменные, хранящиеся в Чате и доступные для чтения и изменения системой по заложенной в Сценарий агента или Платформа логике.
Подробнее: Контекстные переменные чата
Информация об использовании в диалоге информации о Собеседнике из канала: Использование в диалоге информации о собеседнике из канала
Чтобы реализовать задержку между выводом нескольких текстовых слотов, вы можете вставить между текстовыми слотами Внешний запрос к любому отвечающему серверу и в настройках этого Внешний запрос указать заголовок er-delay с нужным значением в секундах. Подробнее об использовании таких заголовков: Запросы во внешние системы | Слот External Request
Сам запрос будет чистой формальностью, чтобы использовать опцию задержки, его можно послать к любому сервису, который отвечает, например GET запрос на https://admin.chatme.ai или https://ya.ru, данные ответа можно не парсить. Главное, чтобы сервер ответил. Тогда вы получите задержку равную время ответа сервера + задержка в секундах из er-delay заголовка. В случае, если сервис не будет отвечать, платформа будет 5 минут ждать ответа на запрос.
Метаданные файла (тип, ссылка) записываются в client_message: Jivo на своей стороне сохраняет файл, а нам передает ссылку. О том, как работает получение файлов от Собеседника в других омниканальных платформах и мессенджерах, читайте в статьях по данным каналам: раздел Вывод Агента в омниканальные платформы, раздел Вывод Агента в мессенджеры.
Возможно, ограничений нет. О том, в каких случаях происходит сброс (удаление) таймера: Запуск сценария по таймеру | Слот Timer
Платформа практически одновременно отправляет эти слоты, но External Request может прийти быстрее. Чтобы это исправить, можно добавить заголовокer-delay. Подробнее: Запросы во внешние системы | Слот External Request
Меняется не обученная модель Агента, а Сценарий агента в БотБилдере, т.е. в канале работает предыдущая модель Агента, а чтобы заработал новый Сценарий агента, его необходимо обучить (Обучение Агента).
К атрибутам любого объекта нужно обращаться через квадратные скобки: {{ body["foo"]["bar"] }} .
{{ now().timestamp() }}
now() сделать смещение получаемого результата? Вроде now(5)= utc+5.Нет, можно получить только текущее время по UTC.
Если можно строку привести к какому-нибудь конкретному типу (число, boolean, массив, и т.п.), то сохраняется конкретный тип, а не строка. Математические операции возможно совершать только с данными типа “число”.
'+' в начале переменной (сохранение телефона, указанного в client_message)?Строка автоматически преобразовывается в число, и сохраняется как число.
'+' с числом, приведенным к строковому формату? Нужно сохранять номер в формате +79999999999. Конкатенация номера с любым другим символом работает корректно; в случае с '+' символ пропадает. Строка автоматически приводится к числу?Да, строка автоматически преобразуется в число. Реализовать это можно так: {{ "+" + (<номер телефона> | string) }}
json?Есть встроенный фильтр tojson (подробнее: https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-filters.tojson). Чтобы убрать переносы строки, используйте {{ some | replace('\n', '') }}
Инструкция по ссылке https://medium.com/opsops/how-to-get-index-of-the-element-in-the-list-in-jinja-c369c2372729
Для добавления элементов в массив нужно использовать оператор +.
Пример: есть корзина в которую складываются элементы
cart = [{
"id": "{{ id }}",
"amount": "{{ amount }}"
}]
Добавление элемента: {{ cart + [{"id": 1, "amount": amount}] }}
Это возможно сделать через {{ string_1 }}{{ string_2 }}. Через оператор '+' это сделать невозможно.
Данная информация доступна в настройках аккаунта на вкладке Billing.
Уникальный Собеседник как объект тарификации — это каждый уникальный Собеседник из канала, с которым Агент ведет коммуникацию в уникальном канале Агента. Если этот же фактический пользователь ведет диалог с этим же Агентом в другом его канале или с другим Агентом в этой же Компании, то он считается другим Уникальным Собеседником.
Каждые сутки в в 02:00 UTC происходит обновление счетчиков подписки: обновляется значение счетчика трафика (уникальных Собеседников) в расчетном периоде в соответствии с полученной статистикой по трафику. Если же в данный день начинается новый расчетный период, то счетчик трафика в расчетном периоде сбрасывается на ноль.
Количество рассчитывается автоматически: учитываются все Чаты, в которых в расчетном периоде было хоть одно движение по сценарию (пришло сообщение от Собеседника или ушло сообщение Агента, сработал таймер, пришел входящий запрос и т.д.).
Количество уникальных Собеседников в NLU Агентах и Агентах без NLU измеряется одинаково: учитываются все чаты, в которых в расчетном периоде было хоть одно движение по сценарию (пришло сообщение от Собеседника или ушло сообщение Агента, сработал таймер, пришел входящий запрос и т.д.)
Уникальный Собеседник как объект тарификации — это каждый уникальный Собеседник из канала, с которым Агент ведет коммуникацию в уникальном канале Агента. Если этот же фактический пользователь ведет диалог с этим же Агентом в другом его канале или с другим Агентом в этой же Компании, то он считается другим Уникальным Собеседником.
Об алертах подписки вы можете узнать по ссылке: Алерты подписки
На текущий момент покупка пакета пополнения трафика возможна только через отдел продаж: sales@chatme.ai
Для идентификации посетителя в канале можно использовать Канальные переменные. Узнать подробнее: Канальные контекстные переменные
При выводе напрямую в Telegram просматривать ответы Собеседников можно следующими способами:
Выгружать историю диалогов с Вкладка Аналитики;
Выгружать контекстные переменные Чатов с Вкладка Аналитики, тогда вы будете видеть только сохраненные в контекстных переменных ответы Собеседника;
Настроить интеграцию, например, через make.com, и сделать отправку данных себе на почту или в Google Sheets.
Если Собеседник не скрыл логин в настройках приватности Telegram, то его можно увидеть в канальной контекстной переменной channel_visitor_account.
Такое бывает, когда агент не обучен или канал с таким же токеном уже зарегистрирован. Также при активации канала могут возникнуть ошибки:
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
”Couldn’t register agent webhook” — выводится в случае, если не удалось зарегистрировать вебхук в удаленном канале.
Однако канал будет активирован несмотря на проблемы.
Это можно сделать с помощью внешнего запроса на URL https://api.telegram.org/bot{{ channel_webhook_token }}/getChatMember?chat_id=@[ЮЗЕРНЕЙМ КАНАЛА]_id={{ channel_visitor_id }}, где на вкладке Response происходит парсинг переменной из ответа: {{ body.result.status }}.
Добавьте в URL-адрес внешнего запроса юзернейм Telegram-канала или группы, подписку на которую необходимо проверить, добавьте внешний запрос в сценарий Агента и используйте полученную переменную в дальнейшем сценарии. Алгоритм взаимодействия может быть следующим:
Собеседник пишет Telegram-боту в личных сообщениях;
Бот проверяет статус подписки Собеседника;
В зависимости от статуса общение продолжается по одному из сценариев.
Пример конфигурационного файла Агента:
Для этих целей подойдет отчет Slot stats, выгрузить который можно на Вкладка Аналитики. В отчете видно, через какой слот и сколько раз проходил Собеседник в ходе конкретной диалоговой сессии.
Переменные выгружаются в алфавитном порядке.
Платформа принимает 20 запросов в секунду, но дальнейшее отправление распределяется по времени, чтобы сглаживать нагрузку и не превышать лимиты API мессенджера.
На открытые чаты — нет лимитов.