Telegram
Telegram – бесплатный онлайн-мессенджер, одно из самых популярных мобильных приложений в мире.
Что позволяет?
Данный канал позволяет полностью автоматизировать общение с клиентами.
Подключение
Подключение Савви к агенту в Telegram
Чтобы подключить Telegram к Вашему агенту в Савви, зайдите в раздел "Каналы" и выберите Telegram
Видим поле, в котором требуется указать токен. Токен — это уникальный идентификатор пользователя в Telegram. Он позволяет серверам определять запросы и защищает доступ к каналу.
Чтобы получить токен, нужно в поисковой строке Telegram вбить @BotFather
Нажав на кнопку Start, мы получаем список команд. Если нужно получить токен уже существующего агента, выберите команду /token
После того, как Вы получили токен в BotFather, пропишите его в поле Telergram и нажмите кнопку "Сохранить"
Далее перед нами появятся следующие настройки
Если в поле Сообщение при команде /start задать приветствие, агент будет отправлять его при обращении клиента в канале Telegram, который уже подключен к Савви:
Нажимаем Сохранить.
Подключение Савви к индивидуальной учётной записи
Вы можете подключить Савви к индивидуальной учётной записи в Telegram.
Внесите свой UserID в соответствующее поле. Более подробно о том, где получить UserID, можете посмотреть в соответствующим разделе.
Перейдите в @BotFather, нажмите /mybots и выберите нужного агента
Затем нужно выбрать Bot Settings
Далее нажать Secretary Mode
Затем выбрать Turn On
Далее нужно скопировать username бота
Переходим к настройке автоматизации чатов на стороне Telegram. Рассмотрим на примере десктопной версии Telegram.
Убедитесь, что у вас установлено приложение Telegram самой последней версии.
Нужно перейти далее в настройки.
Затем переходим в "Мой аккаунт".
Далее надо перейти в раздел "Автоматизация чатов"
В поле «@имя бота» указываем username нашего бота.
Нажимаем «Добавить»
Нажимаем «Готово»
Настройте чаты, в которых бот будет отвечать.
Затем отметьте минимально необходимый для работы набор прав.
Как узнать User ID, Bot ID, Group ID, Channel ID
ID — это уникальный номер, который используется для идентификации в Telegram. Он отличается от @username, которое можно изменять.
Чтобы узнать свой User ID, Bot ID, Group ID или Channel ID средствами платформы Савви выполните следующие шаги:
В настройках канала Telegram, необходимо активировать флаг "Обрабатывать команду /get_id".
В чате с агентом отправьте команду /get_id. После выполнения команды появятся кнопки для получения ID.
MY ID - позволяет получить свой ID USER ID - позволяет получить ID другого пользователя BOT ID - позволяет получить ID бота GROUP ID - позволяет получить ID группы CHANNEL ID - позволяет получить ID канала
Выберите нужную кнопку. Если это MY ID, то Ваш ID сразу появится в чате. В случае других ID нажмите на кнопку, выберите интересующего Вас пользователя, агента, группу или канал, после чего в чате появится соответствующий ID.
Настройка чёрного и белого списка пользователей по их ID
Здесь Вы можете вписать id пользователей, кому агент не будет отвечать, либо id пользователей, кому агент будет отвечать. В этом случае агент будет отвечать только выбранным пользователям.
Режим ответов агента в группах
Если флаг Отвечать в группах только при упоминании
❌выключен, то агент будет отвечать на все сообщения в группе, где он подключенЕсли флаг Отвечать в группах только при упоминании
✅включен, то агент будет отвечать только в том случае, если к нему обратятся через упоминание: "@my_bot Привет".
В поле Ключевые слова для ответа на сообщение можно задать ключевые слова, при использовании которых в диалоге агент будет отвечать.
Проверка подписки на каналы
Активация флага Проверять подписку на группу позволяет агенту отвечать только подписанным пользователям. Пользователям, которые не подписаны, будет выводиться заданное сообщение.
Режим ответов агента в группах с темами
Настройка ответов агента при упоминании, при использовании ключевых слов и проверка подписки аналогична предыдущему пункту.
Дополнительно имеется возможность указать ID тем, в которых агент должен отвечать, и тем, в которых не должен. Как получить ID темы, смотрите ниже в соответствующем пункте.
Как узнать ID темы
Чтобы получить ID темы необходимо выполнить следующие шаги:
Кликните правой кнопкой мыши на одном из сообщений в теме, ID которой необходимо получить.
Вы получите ссылку в следующем формате:
Необходимо взять обведенную часть и прибавить к ней -100.
В данном примере ID будет -1002460154739/12
Настройки при работе в группах с темами
Сохранять ли все сообщения - это означает, что если в диалоге было сообщение, на которое бот не должен отвечать, то при этой включенной настройке сообщение все равно будет добавлено в чат - это сделано для того, что бы бот имел целостную картину мира
Добавлять ли префикс - у нас все сохраняется, как "клиент" даже если это писали разные люди. Данная настройка позволяет добавлять префикс изменяя родительское сообщение, что бы указывать, кто это писал. Как это будет выглядеть для бота, все сообщения от Покупателя, но перед каждым сообщением username пользователя Телеграм:
Режим ответов агента в каналах
Настройка ответов агента при упоминании, при использовании ключевых слов и проверка подписки аналогична пункту 9.
Очистка контекста на команду /start.
Данная настройка особенно полезна при тестовых диалогах. При вводе в Telegram команды /start контекст диалога полностью очищается и можно начинать новый диалог.
Пометка о прочтении у бизнес-агентов
Если Вы хотите, чтобы сообщения в бизнес-агенте отмечались как прочитанные, то в настройках бизнес-агента выдайте разрешение - "Чтение сообщений"
В настройках Савви включите "Пометка о прочтении у бизнес-агентов"
Кнопки в Telegram
Кнопки Савви для Telegram являются программируемыми (динамическими), а не статическими. Они не отображаются в чате Telegram сразу после создания действия в Савви. Кнопки появляются в ходе диалога при вызове соответствующей функции в месте, предусмотренном промптом или инструкцией.
Пример инструкции:
#РАБОТА С ФУНКЦИЯМИ
В начале диалога вызвать функцию send_telegram_message().
Настроить кнопки можно через создание действия. Добавление кнопок позволит расширить взаимодействие клиента с агентом.
Настройка:
Перейдите на вкладку "Действия" и нажмите кнопку "Добавить".
Выберите действие "Кнопки в Telegram". Процедура добавления данного действия аналогична добавлению других действий.
Переходим к настройке шага.
Доступно 3 варианта шага: 1. Добавить кнопки внизу экрана - внизу экрана в интерфейсе мессенджера будет добавлено заданное количество кнопок с выбранными функциями. 2. Добавить кнопки под сообщением - кнопки добавляются после определенного сообщения агента. 3. Убрать кнопки внизу экрана - функция позволяет убрать кнопки, которые были добавлены при выборе Варианта 1.
Добавить кнопки внизу экрана
Параметры клавиатуры.
Задают поведение клавиатуры при взаимодействии с ней.
Принудительно показывать - запускает принудительный показ кнопок. Подгонять высоту - адаптирует размер кнопок. Скрывать после использования - после использования одной из кнопок, панель с кнопками убирается. Показывать подсказку, когда кнопки на экране - при активации появится поле, в которое Вы можете внести текст подсказки, когда кнопки показаны на экране.
Добавление кнопки
Для добавления кнопки нажмите на "+"
Настройка кнопки
Вы можете выбрать 1 из 4 типов кнопки: Отправить сообщение - отправляет в чат заданный текст. Это может быть информационный текст, ссылка либо ключевая фраза, по которой агент выполнит другое действие. В таком случае не нужно ждать это слово от пользователя. Запрос контакта - позволяет отправить в чат имя, фамилию, указанные в профиле, и номер телефона пользователя. Это удобно при сборе информации о пользователе и заполнении базы данных либо бронировании услуги. Запрос местоположения - в чат отправляются координаты и адрес пользователя. Вариантом использования могут быть контекстные действия агента в зависимости от геолокации пользователя, например выбор ближайшего филиала или примерный расчёт доставки. Открыть мини-приложение - позволяет открыть любую подходящую под требованию ссылку в формате мини-приложения и быстро просмотреть, таким образом клиент может ознакомиться с Вашим сайтом, либо информации об услугах и акциях без необходимости переходить в браузер.
Обратите внимание, что при создании кнопки с функцией открытия ссылок в формате мини-приложения, можно добавить только ссылки с протоколом https.
Для каждой кнопки можно задать уникальное название.
Добавить кнопки под сообщением
Добавление кнопок выполняется аналогично тому, как это было в предыдущем пункте.
Для этого типа кнопок доступно 2 варианта: 1. Скопировать текст - позволяет добавить текст, который будет скопирован при клике, можно задать, например, личный промо-код, либо ссылку на сайт. 2. Открыть ссылку - позволяет привязать к кнопке ссылку, которая будет открыта при клике по кнопке.
Убрать кнопки внизу экрана
Данный вариант шага не имеет специфических настроек. Запуск действия с таким шагом удаляет ранее созданные кнопки внизу экрана.
Задание функции удаления:
На вкладке "Условия срабатывания" необходимо задать имя функции, по которой будет запускаться действие.
Всегда следует задавать название функции таким образом, чтобы выбранное слово или фраза описывали само действие. Описание должно быть максимально точным. Соблюдение этих правил позволит добиться стабильной работы действия.
В инструкции необходимо прописать условие срабатывания и название функции, для примера представим, что функция называется delete_button:
Задание аргументов и констант
Аналогично другим действиям можно добавлять аргументы и константы на соответствующих вкладках, что позволяет расширить гибкость сценариев использования. Вы можете формировать содержание кнопок динамически во время диалога, либо получать информацию из других сервисов, либо источников.
После того, как аргумент или константа созданы, их необходимо добавлять через кнопку в виде шестеренки.
Дополнительные настройки
Блок настроек аналогичен другим действиям.
Кнопки в Telegram — мощный инструмент, который улучшает пользовательский опыт взаимодействия с агентом.
Стартовый параметр
Стартовый параметр представляет из себя эффективный инструмент работы с реферальными программами, также может использоваться при работе со статистикой в маркетинге для получения информации по потокам клиентов из разных источников. Этот параметр можно использовать для выполнения различных действий на платформе Савви.
Стартовый параметр сохраняется в поле start_parameter. Он может быть передан либо в ссылке на агента, например:
Либо он может быть введен непосредственно после команды /start:
Если стартовый параметр получен, он отобразится в шапке экспорта в соответствующем поле.
Удобно взаимодействовать со стартовым параметром, либо другими параметрами из плейсхолдера, используя запуск по триггеру.
Рассмотрим на примере получения аналитических данных в кабинете Савви. Для этого необходимо настроить действие "Базовый шаг".
Добавьте действие "Базовый шаг". Выберите запуск по триггеру. Установите параметры, указанные на скриншоте.
Установите в действии нужный Вам тег.
При выполнении условий действие в диалоге будет выполнено, и тег будет проставлен. Агент при этом продолжит вести диалог как обычно — выполнение этого действия не влияет на ход общения.
В разделе "Аналитика", Вы сможете посмотреть статистику по тегам.
Выключение ответов агента
Если Вам по каким-то причинам требуется на время отключить ответы агента в Telegram, то необходимо выключить флаг "Ответы агента".
Последнее обновление
Это было полезно?