Интеграция в телеграмм и основа работы в Sendpulse
Чтобы создать нового бота, нужно зайти в раздел “чат-боты” - добавить бота и выбрать telegram.
Как получить ключ доступа для бота в телеграм
- Откройте мессенджер Telegram, перейдите по ссылке @BotFather и выберите бота. У официального бота Telegram будет стоять синий подтверждающий знак возле имени в виде галочки.
- Запустите бота и в ответ вы получите список команд по управлению ботов.
- Выберите или напечатайте и отправьте команду /newbot.
- Дайте имя боту клиенты увидят это имя при общении с ботом. А также никнейм бота. По нему можно будет найти бота в Telegram. Никнейм должен быть уникальным, не повторять существующие в базе и заканчиваться на слово «bot».
- После того как вы выберите подходящее имя бот будет создан. Вы получите сообщение со ссылкой на бота t.me/<никнейм_бота>, рекомендации по настройке аватарки, описание бота и список команд для настройки бота.
- Для подключения бота в SendPulse вам понадобится токен. Скопируйте значение токена и перейдите к последнему пункту.
Как подключить бота в Sendpulse
- Нажмите на кнопку «Подписаться на бота». Таким образом вы сможете тестировать каждое сообщение и цепочку и отправлять их себе перед реализацией.
- Вы будете перенаправлены в приложение «Telegram», нажмите на кнопку «Запустить» и вы подпишетесь на своего бота.
- После успешного подключения чат-бота вы получите приветственную цепочку, бот появится у вас в списке ботов и вы можете начинать создавать приветственные и триггерные цепочки, массовые рассылки. Подписчики не импортируются автоматически. После подключения вы сможете собирать аудиторию с помощью виджета подписки или делясь ссылкой на бота t.me/<никнейм_бота> напрямую. Также вы можете вручную загрузить файл с ранее собранными подписчиками.
Как подключить ChatGPT от OpenAI к чат-боту
Если у вас есть гугл-аккаунт, зарегистрированный на зарубежный номер, то регистрация займет пару минут, если же у вас такого нет, то изучите инструкцию по регистрации в openAI из России.
- После регистрации аккаунта, перейдите обратно в sendpulse, выберите своего бота, перейдите в «Настройки бота» во вкладку «Интеграции». Напротив «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) укажите число:
При каждом запросе учитывается количество токенов из: поля "Инструкция для бота"; последних сообщений в диалоге с ботом; текущий запрос, который пользователь введет боту; текущего ответа, который бот выдаст пользователю.
Если в поле «Инструкция для бота» вы укажете максимально допустимое количество токенов, то может оказаться, что суммарное количество данных в токенах будет выше лимита О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.
Соединение элементов
Кликните на синий кружок в блоке и протяните линию от одного элемента к другому элементу, чтобы связать их.
Кликните на линию два раза, чтобы появились кнопки с удалением связи.
Непривязанный блок цепочки будет светится желтым, напоминая пользователю, что его необходимо подвязать.
Блок с незаполненными полями будет подсвечиваться красным. К примеру, вы выбрали кнопку, но не назвали ее, выбрали ссылку но не указали ее. Пока вы не заполните поля, вы не сможете выйти из элемента или конструктора с сохранением.
Элемент «Действие»
Элемент «Действие» виден только вам. Выберите на панели слева элемент и перетащите его после отслеживаемого блока.
После выберите, какое именно действие следует создать:
Элемент «Запуск цепочки»
Вы можете облегчить структуру вашего бота, перекинув читателя на другую цепочку.
После выбора действия «Цепочка» выберите из выпадающего списка созданную ранее цепочку.
На блоке «Цепочка» ветка заканчивается. После этого блока вы не сможете продолжать редактируемую цепочку, добавляя другие элементы.
Элемент «Фильтр»
Сегментируйте клиентов по их персональным данным и получению предыдущих сообщений. Выберите на панели слева элемент и перетащите его после блока, с которого начнется ветвление сценариев.
Затем выберите само условие. Вы можете комбинировать условия, добавляя операторы каждому или любому, или добавлять независимые дополнительные условия.
После добавления условий добавьте к каждому из вариантов выполнения условия (зеленая точка) или невыполнения условия (красная точка) на следующие элементы цепочки.
Элемент «Пауза»
Это период, в течение которого подписчику не отправляются автоматические сообщения. Пауза может быть установлена в минутах, часах или днях.
Вы можете выбрать паузу в промежутке, используя опцию «Временной период», или до определенного времени, используя опцию «До времени» и «До даты».
Выберите «Временной период» и установите паузу между отправкой элементов цепочки от 1 минуты до 24 часов. Используйте ее в цепочке, к примеру, для прогрева клиента. Через указанное время отправится следующее сообщение.
При выборе паузы между блоками в 1 день и более можно установить время — в котором часу отправлять сообщение. Следующим днем считается проход часовой стрелки через 00:00 по часовому поясу, выставленному в настройках личного кабинета.
Также вы можете выбрать «До времени» или «До даты» и установить задержку до определенного времени. К примеру, вы можете использовать эту опцию для обозначения рабочего времени или времени действия акции.
Также с помощью элемента «Пауза» вы можете задавать условие выполнения следующего элемента цепочки: отправлять всегда или при неактивности подписчика.
Управление цепочками
Вы можете включать и выключать цепочки. Для этого выберите интересующую вас и переключите на нужный режим.
Выключенные цепочки будут светится серым.
