Интеграция в телеграмм и основа работы в Sendpulse
Чтобы создать нового бота, нужно зайти в раздел “чат-боты” - добавить бота и выбрать telegram.
Как получить ключ доступа для бота в телеграм
- Откройте мессенджер Telegram, перейдите по ссылке @BotFather и выберите бота. У официального бота Telegram будет стоять синий подтверждающий знак возле имени в виде галочки.
- Запустите бота и в ответ вы получите список команд по управлению ботов.
- Выберите или напечатайте и отправьте команду /newbot.
- Дайте имя боту клиенты увидят это имя при общении с ботом. А также никнейм бота. По нему можно будет найти бота в Telegram. Никнейм должен быть уникальным, не повторять существующие в базе и заканчиваться на слово «bot».
- После того как вы выберите подходящее имя бот будет создан. Вы получите сообщение со ссылкой на бота t.me/<никнейм_бота>, рекомендации по настройке аватарки, описание бота и список команд для настройки бота.
- Для подключения бота в SendPulse вам понадобится токен. Скопируйте значение токена и перейдите к последнему пункту.
Как подключить бота в Sendpulse
- Нажмите на кнопку «Подписаться на бота». Таким образом вы сможете тестировать каждое сообщение и цепочку и отправлять их себе перед реализацией.
- Вы будете перенаправлены в приложение «Telegram», нажмите на кнопку «Запустить» и вы подпишетесь на своего бота.
- После успешного подключения чат-бота вы получите приветственную цепочку, бот появится у вас в списке ботов и вы можете начинать создавать приветственные и триггерные цепочки, массовые рассылки. Подписчики не импортируются автоматически. После подключения вы сможете собирать аудиторию с помощью виджета подписки или делясь ссылкой на бота t.me/<никнейм_бота> напрямую. Также вы можете вручную загрузить файл с ранее собранными подписчиками.
Как подключить ChatGPT от OpenAI к чат-боту
Если у вас есть гугл-аккаунт, зарегистрированный на зарубежный номер, то регистрация займет пару минут, если же у вас такого нет, то изучите инструкцию по регистрации в openAI из России.
- После регистрации аккаунта, перейдите обратно в sendpulse, выберите своего бота, перейдите в «Настройки бота» во вкладку «Интеграции». Напротив «OpenAI» нажмите «Подключить».
| Использовать токен с настроек аккаунта (Use the token from the account settings) | Если вы используете один аккаунт OpenAI в различных сервисах SendPulse, включая все боты, вы можете добавить токен в общие настройки аккаунта.Чтобы добавить токен, перейдите в «Настройки аккаунта» во вкладку «https://login.sendpulse.com/settings/#api». В секции «Интеграции > OpenAI & ChatGPT» нажмите «Подключить». Вставьте ключ и нажмите «Сохранить». После этого вы сможете выбрать опцию «Использовать токен с настроек аккаунта» и подключить OpenAI для вашего бота. | | --- | --- | | Использовать отдельный токен для этого бота (Use a separate token for this bot) | Если вам нужно использовать отдельный аккаунт OpenAI для текущего бота, выберите эту опцию и в следующем поле вставьте скопированный ключ. |
- Нажмите “create new secret key”. Введите название (название можно дать опираясь на название вашего проекта).
- Скопируйте готовый ключ и сохраните его в отдельном документе, т.к. после закрытия сайта, вы не сможете его больше увидеть. Нажмите done
Выбирайте модель ChatGPT-3.5 или ChatGPT (gpt 3.5 turbo 16k). Разница в них в количестве добавляемых символов. Модель ChatGPT (gpt 3.5 turbo 16k) учитывает 15000 символов/токенов в контексте, в то время как лимит первой модели 5000 символов. подробнее о каждой модели вы можете прочитать в статье Sendpulse - начало работы
При создании подсказки учитывайте следующие рекомендации:
- Добавьте максимальное количество контекста и условий для ответа в каждом сценарии. Перечислите все предварительные условия взаимодействия с ботом: укажите, какие пользователи и на каком этапе решения своих задач будут обращаться, какие подробности необходимо учесть в ответах, а какие темы избегать.Давайте модели задание сгенерировать несколько результатов, чтобы иметь возможность сравнить и указать ей наиболее подходящий.
- Дайте понять, чего вы хотите, с помощью примеров. К примеру, если вам нужно, чтобы модель ранжировала список элементов в алфавитном порядке или классифицировала абзац по настроению, перечислите примеры запросов и ожидаемый формат результата или какого эффекта хотите добиться. Если вам нужно, чтобы бот на вопросы отвечал определенным образом — приведите пример вопроса и ответа.
- Предоставляйте качественные и максимально точные данные. Проверьте свои примеры — модель обычно достаточно умна, чтобы опознать основные орфографические ошибки, но она также может предположить, что это сделано намеренно, и это может повлиять на ответ. Если вам нужно, чтобы модель отвечала на определенном языке — укажите этот язык прямо. Так же рекомендуется использовать слова вместо цифр. Помните, что AI понимает все указания буквально.
- Персонифицируйте модель. Чтобы модель могла войти в образ определенного человека или персонажа, опишите, чем он занимается, какими качествами обладает, в каком тоне или с каким лексиконом будет общаться, а также другие аспекты жизни виртуального помощника.
- Тестируйте полученный результат и обновляйте инструкцию. После настройки подсказок обязательно протестируйте полученный результат, просматривайте диалоги с пользователями и при необходимости корректируйте указания бота, добавляя или убирая детали. Тренируйте модель, пока не добьетесь желаемых результатов.
Используйте готовый шаблон для бота. Настройте его под свою нишу.
Токен – часть слова, используемая для обработки природного языка.
В поле «Максимальное количество соответствующих токенов» (Maximum number of tokens in response) укажите число:
Максимальная количество символов в поле «Инструкция для бота»*
Максимальная количество токенов в ответе подписчику*
ChatGPT (gpt-3.5-turbo-16k-instruct)
Custom fine-tuned model (Instruct)
При каждом запросе учитывается количество токенов из: поля "Инструкция для бота"; последних сообщений в диалоге с ботом; текущий запрос, который пользователь введет боту; текущего ответа, который бот выдаст пользователю.
Если в поле «Инструкция для бота» вы укажете максимально допустимое количество токенов, то может оказаться, что суммарное количество данных в токенах будет выше лимита ОpenАИ. В результате запрос завершится ошибкой и ваш подписчик не получит ответа.
Мы рекомендуем выставлять 700-1000, т но вы можете настроить их под себя.
При первой регистрации, OpenAI дает $18 долларов на 3 месяца. Из этой суммы будет сниматься плата за использование токенов.
Тарифы за токены различаются, зависимо от используемой модели. К примеру, модель gpt-3.5-turbo-16k стоит в два раза дороже модели gpt-3.5-turbo, поскольку она использует больше контекста.
Чтобы посмотреть, сколько токенов у вас осталось, перейдите в ваш аккаунт в OpenAI во вкладку «Usage».
Укажите показатель температуры от 0 до 2.
Температура – это параметр, влияющий на абстрактность ответов. Например, если задавать один и тот же вопрос, то исходные данные будут разные в соответствии с выбранной температурой — абстрактные или более точные. Более высокие значения ближе к 2, например,1,3, сделают ответы более случайными. Низшие значения ближе к 0, например, 0.2, сделают их более исчерпывающими, но одинаковыми по смыслу.
Как создать автоматизированную цепочку для Telegram чат-бота
Отправляется сразу после подписки на ваш чат-бот, то есть сразу после нажатия кнопки «Запустить». Такая цепочка знакомит подписчика с вашим чат-ботом, в ней вы сможете рассказать о своем боте и его возможностях чем чат-бот будет полезен подписчику, какую информацию может дать, как часто будет отправлять рассылки и какого содержания. Подключить приветственную серию можно к запуску других триггерных цепочек.
Запускается в ответ на вопросы подписчиков вне рамок сценариев чат-бота, а также при отправке боту картинки. Тут вы можете добавить сообщение с текстом, что менеджер подключится в течение рабочего дня и ответ на ваш вопрос. Обычно оно запускается, когда настройка интеграции с ChatGPT слетела, в таком случае проверьте настройки или замените API ключ
Цепочка с одним сообщением, которая запустится после команды отписаться — /stop или /unsubscribe.
Вы можете создавать свои слова — триггеры, на которые бот будет реагировать и запускать цепочку.
Нажмите «Создать новый триггер». Напишите команду из слова или нескольких слов. К примеру «Менеджер” “человек” - чтобы оповестить менеджера и подключить его к чату. Или “цена” “услуги” - чтобы дать список.
Тут также можно выставить запрет на повторный вызов.
После создания триггера нажмите «Создать цепочку» и начните ее редактирование.
Если пользователь введет часть вашей команды, бот предложит ему ответ в виде кнопки с названием вашего триггера — после нажатия на нее запустится цепочка.
Как редактировать цепочку
Вы можете выбрать первым элементом, с которого запускается цепочка, следующие блоки: «Сообщение», «Фильтр», «Случайный выбор», «Запрос API» или «Действие».
C помощью элемента «Сообщение» вы можете создать сообщение любого типа и добавить к нему различные блоки: текст, видео, галерею, кнопки или запросить данные пользователя и подобное.
В текстовом блоке наберите текст сообщения. Ограничение по длине одного текстового блока — 4000 символов.
Вы можете добавить кнопку для перехода на сайт или продолжения диалога клиента с ботом. Введите имя вашей кнопки. Вы можете добавить до 20 символов и эмодзи к тексту кнопки.
Разнообразьте информацию вашего сообщения визуальным контентом, который будет согласован с текстом.
Нажмите кнопку «Выберите файл», чтобы загрузить изображение с компьютера или устройства, или перетащите файл в поле загрузки.
Ограничений по размеру изображения нет, но при добавлении картинки учитывайте, что разрешение картинки для Telegram будет 500px по ширине и 200px по высоте.
Чтобы загрузить картинку по ссылке, выберите «Загрузить изображение по URL» в выпадающем меню и укажите ссылку на картинку в поле.
В пункте «Сообщения» нажмите «Добавить»и выберите «Карусель». Для каждой карты можно выбрать изображение, добавить до 3 кнопок, название до 32 символов и краткое описание до 80 символов.
Вы можете добавлять файлы в любом формате, кроме исполняемых файлов, размером до 20 МБ. Прикрепите билеты, карту, чек-листы, инструкции или другие дополнительные материалы.
Нажмите кнопку «Выберите файл» (Choose file), чтобы загрузить файл с компьютера или устройства или перетащите файл в поле загрузки.
Используется для отправки аудиодорожек. Вы можете добавить файл размером до 20 МБ в формате MP4.
Вы также можете заметить, что отображать мультимедийный файл как голосовое сообщение.
Используется для отправки видеофайлов. Вы можете добавить файл размером до 20 МБ в формате MP3, MP4 и OGG.
Разбивайте большой текст на небольшие абзацы до 4 строк и разделяйте элементом «Задержка». Пауза имитирует индикатор печатания текста и дает передышку пользователю.
Нажмите «Добавить» и выберите элемент «Задержка». Укажите значение в секундах - от 1 до 5.
Соединение элементов
Кликните на синий кружок в блоке и протяните линию от одного элемента к другому элементу, чтобы связать их.
Кликните на линию два раза, чтобы появились кнопки с удалением связи.
Непривязанный блок цепочки будет светится желтым, напоминая пользователю, что его необходимо подвязать.
Блок с незаполненными полями будет подсвечиваться красным. К примеру, вы выбрали кнопку, но не назвали ее, выбрали ссылку но не указали ее. Пока вы не заполните поля, вы не сможете выйти из элемента или конструктора с сохранением.
Элемент «Действие»
Элемент «Действие» виден только вам. Выберите на панели слева элемент и перетащите его после отслеживаемого блока.
После выберите, какое именно действие следует создать:
Открывает чат с подписчиком в разделе «Диалоги»
Отключает подписчика от получения массовых и автоматических рассылок бота
Присваивает тег подписчику, удаляет присвоенный пользователю тег
Устанавливает значение переменной, которая присвоится или обновится для подписчика. Также можно создать новую переменную
Отправляет POST запрос с данными подписчика на ваш URL
Создает https://sendpulse.com/ru/knowledge-base/crm/deals/sources при выполнении определенного действия, например, нажатии кнопки «Купить»
Заблокировать или разблокировать в группе или канале
Блокирует или разблокирует подписчика в выбранной группе или канале
Отправляет сообщение в системный бот или группу Telegram, где чат-бот добавлен администратором.
!https://www.spcdn.org/images/En-knowledge_base/chatbots/telegram/create-flow/scr30-min.png
Элемент «Запуск цепочки»
Вы можете облегчить структуру вашего бота, перекинув читателя на другую цепочку.
После выбора действия «Цепочка» выберите из выпадающего списка созданную ранее цепочку.
!https://www.spcdn.org/images/En-knowledge_base/chatbots/telegram/create-flow/scr31-min.png
На блоке «Цепочка» ветка заканчивается. После этого блока вы не сможете продолжать редактируемую цепочку, добавляя другие элементы.
Элемент «Фильтр»
Сегментируйте клиентов по их персональным данным и получению предыдущих сообщений. Выберите на панели слева элемент и перетащите его после блока, с которого начнется ветвление сценариев.
Затем выберите само условие. Вы можете комбинировать условия, добавляя операторы каждому или любому, или добавлять независимые дополнительные условия.
!https://www.spcdn.org/images/En-knowledge_base/chatbots/telegram/create-flow/scr31-min.png
После добавления условий добавьте к каждому из вариантов выполнения условия (зеленая точка) или невыполнения условия (красная точка) на следующие элементы цепочки.
!https://www.spcdn.org/images/En-knowledge_base/chatbots/telegram/create-flow/scr32-min.png
Элемент «Пауза»
Это период, в течение которого подписчику не отправляются автоматические сообщения. Пауза может быть установлена в минутах, часах или днях.
Вы можете выбрать паузу в промежутке, используя опцию «Временной период», или до определенного времени, используя опцию «До времени» и «До даты».
Выберите «Временной период» и установите паузу между отправкой элементов цепочки от 1 минуты до 24 часов. Используйте ее в цепочке, к примеру, для прогрева клиента. Через указанное время отправится следующее сообщение.
!https://www.spcdn.org/images/En-knowledge_base/chatbots/telegram/create-flow/scr33-min.png
При выборе паузы между блоками в 1 день и более можно установить время — в котором часу отправлять сообщение. Следующим днем считается проход часовой стрелки через 00:00 по часовому поясу, выставленному в настройках личного кабинета.
Также вы можете выбрать «До времени» или «До даты» и установить задержку до определенного времени. К примеру, вы можете использовать эту опцию для обозначения рабочего времени или времени действия акции.
!https://www.spcdn.org/images/En-knowledge_base/chatbots/telegram/create-flow/scr34-min.png
Также с помощью элемента «Пауза» вы можете задавать условие выполнения следующего элемента цепочки: отправлять всегда или при неактивности подписчика.
!https://www.spcdn.org/images/En-knowledge_base/chatbots/telegram/create-flow/scr35-min.png
Управление цепочками
Вы можете включать и выключать цепочки. Для этого выберите интересующую вас и переключите на нужный режим.