Бот звено: Directum Bot — корпоративный чат-бот для бизнеса

Содержание

Directum Bot

Не все сотрудники работают в информационных системах компании. Однако во внутренних процессах участвуют все работники — исполняют поручения, оформляют заявления, получают на ознакомление документы.

С Directum Bot рабочая информация из корпоративных систем становится доступна каждому сотруднику. Прямо из мессенджера можно пользоваться сервисами компании и отправлять запросы во внутренние службы.

Directum Bot — инструмент, позволяющий оперативно решать повседневные задачи:

  • получать доступ к корпоративной системе в любом месте и в любое время;
  • запускать бизнес-процессы в привычном интерфейсе мессенджера.

Для работы достаточно мобильного устройства с доступом в интернет.

Решение предназначено как для рядовых сотрудников, так и для руководителей высшего звена.

Описание решения

Работа с решением ведется при помощи диалогов с чат-ботом мессенджера (Viber, Telegram и др.). Чат-бот отвечает на вопросы и самостоятельно задает их в рамках предварительно настроенных процессов.

Directum Bot позволяет автоматизировать различные бизнес-процессы компании, например, запрос справок и оформление сервисных заявок. В поставку решения включены готовые процессы: исполнение поручений, ознакомление с документами, проведение опросов, оформление заявлений. На их основе компания может быстро создать свои уникальные процессы.

Чат-бота можно настроить исходя из потребностей организации:

  • в рамках одного чат-бота регулировать доступ к командам его меню. Например, создать уникальный набор команд для руководителей и других категорий сотрудников.
  • создать нескольких чат-ботов с разной функциональностью. Например, корпоративный чат-бот для сотрудников и внешний чат-бот для клиентов.

Благодаря сервисам интеграции и обмена Directum Bot легко становится частью автоматизированных бизнес-процессов организации. Например, когда сотрудник в мессенджере запрашивает справку 2-НДФЛ, в Directum отправляется задание бухгалтеру.

Список сотрудников, имеющих доступ к решению, настраивает администратор.

Бизнес-эффект

  • Вовлечение в цифровое взаимодействие всех сотрудников, в том числе тех, кто не работает за компьютером.
  • Снижение затрат на подключение к информационным системам. Чтобы работать с решением, пользователю достаточно установить мессенджер на мобильном устройстве и авторизоваться в чате Directum Bot.
  • Быстрое подключение пользователей к решению. Мессенджер прост в использовании и всегда под рукой.
  • Легкая автоматизация бизнес-процессов компании посредством чат-бота.

Directum Bot — корпоративный чат-бот для бизнеса

Решаемые задачи

Далеко не все сотрудники работают с информационными системами компании. Однако корпоративными услугами пользуются 100% работников: отправляют кадровые заявления, обращаются в сервисные службы, заказывают справки в бухгалтерии.

Омниканальность доступа к корпоративной системе актуальна как во время всеобщей удаленной работы, так и в нормальных условиях для сотрудников, не работающих за компьютером.

Directum Bot обеспечивает доступ к информации компании через мессенджер на мобильном устройстве. Решение совместимо с Viber и Telegram и подойдет как рядовым сотрудникам, так и руководителям высшего звена.

Как это работает

Пользователь ведет диалог с чат-ботом в мессенджере, выбирая ответ из предложенных вариантов. Коммуникация может инициироваться самим работником или компанией.

С помощью Directum Bot можно:

  • оформлять заявления, отправлять запросы во внутренние службы;
  • знакомиться с локальными нормативными актами и другими документами.

В поставку решения входят наиболее распространенные сценарии работы: запрос справок бухгалтерии, отправка заявок в сервисные службы, ознакомление с документами. На их основе в Directum Bot можно легко интегрировать другие актуальные для компании процессы.

Решение работает с информационными системами Directum и Directum RX, а также с публичными и внутрикорпоративными мессенджерами.

Чат-бот Directum

Чат-бот Directum RX

Чат-бот взаимодействует с информационной системой при помощи сервисов интеграции и обмена. Например, когда сотрудник в мессенджере запрашивает справку 2-НДФЛ, бухгалтер получает задание в информационной системе.

Список сотрудников, имеющих доступ к решению, настраивает администратор.

Бизнес-эффект

  • Включение в контур цифровизации 100% сотрудников, в том числе тех, кто не работает за компьютером.
  • Снижение затрат на подключение к информационным системам. Чтобы работать с решением, пользователю достаточно установить мессенджер на мобильном устройстве и авторизоваться в чате Directum Bot.
  • Ускорение бизнес-процессов компании

Цена и стоимость

Цепочки сообщений

Отправляй ответы на команды пользователей

Группы подписчиков

Собирай подписчиков бота в группы для работы с ними

Таймеры

Отправляй сообщения с задержкой в несколько секунд, часов или дней

Кнопки

Добавь своему боту удобную навигацию с помощью кнопок

Карусель

Отправляй карточки карусели во ВКонтакте

Теги

Отмечай пользователей для их сегментации

Переменные

Храни ответы пользователей и используй их в логике бота

Цепочки сообщений

Отправляй ответы на команды пользователей

Группы подписчиков

Собирай подписчиков бота в группы для работы с ними

Таймеры

Отправляй сообщения с задержкой в несколько секунд, часов или дней

Кнопки

Добавь своему боту удобную навигацию с помощью кнопок

Карусель

Отправляй карточки карусели во ВКонтакте

Теги

Отмечай пользователей для их сегментации

Переменные

Храни ответы пользователей и используй их в логике бота

О нас

Цепочки сообщений

Отправляй ответы на команды пользователей

Группы подписчиков

Собирай подписчиков бота в группы для работы с ними

Таймеры

Отправляй сообщения с задержкой в несколько секунд, часов или дней

Кнопки

Добавь своему боту удобную навигацию с помощью кнопок

Карусель

Отправляй карточки карусели во ВКонтакте

Теги

Отмечай пользователей для их сегментации

Переменные

Храни ответы пользователей и используй их в логике бота

Цепочки сообщений

Отправляй ответы на команды пользователей

Группы подписчиков

Собирай подписчиков бота в группы для работы с ними

Таймеры

Отправляй сообщения с задержкой в несколько секунд, часов или дней

Кнопки

Добавь своему боту удобную навигацию с помощью кнопок

Карусель

Отправляй карточки карусели во ВКонтакте

Теги

Отмечай пользователей для их сегментации

Переменные

Храни ответы пользователей и используй их в логике бота

зачем создавать, кому использовать и как настроить

Чат-боты как связующее звено между кликами и конверсиями

В интернет-рекламе путь пользователя к конверсии можно разделить на два основных этапа: 

1 Взаимодействие с рекламой вне сайта.

2 Поведение на сайте компании.

Эффективность первого повышает оптимизация элементов рекламных кампаний – объявлений, таргетингов, ключевых слов, аудиторий и т.п. За второй отвечает постклик-оптимизация, то есть работа с содержимым и интерфейсом сайта, упрощающая шаги к целевому действию. Задача – помочь пользователю быстрее принять решение, сократив неопределенность выбора.

С ней успешно справляются чат-боты. Виртуальные помощники на страницах сайта предлагают потенциальному покупателю вступить в диалог, распознают его вопросы и снабжают нужной информацией о товаре. Хотя использование чат-ботов – один из digital-трендов последних лет, многие бизнесы до сих пор испытывают трудности с их внедрением.

В этой статье мы еще раз вспомним о преимуществах виртуальных собеседников и выясним, как и в каких случаях их стоит добавлять на посадочные страницы. Речь пойдет только о ботах на сайте – не о чатах в популярных мессенджерах.

Зачем создавать чат-бот

В современном маркетинге чат-бот выполняет функции колл-центра, переводя коммуникации с клиентами в текстовый формат. 

Преимущества инструмента

К плюсам чат-ботов относятся:

  • Сокращение затрат. Нет необходимости оплачивать услуги колл-центра. Автоматический диалог мало отличается от разговора по готовому скрипту, от которого человек, не связанный с компанией, не может отойти.

  • Исключение человеческого фактора. Защита от «трудных» клиентов и стресса, связанного с их звонками.

  • Удобство. По данным Google, 65 % пользователей предпочитают писать компаниям, а не звонить им.

  • Упрощение навигации. Чат-боты умеют по запросу находить на сайте нужные материалы. При этом они способны распознавать больше словоформ, чем традиционный поиск, поэтому общение с ним удобнее.

  • Адаптация информации. Переписка с ботом дает посетителю ровно тот объем данных, который ему требуется. Читать текст на страницах сайта не обязательно – в условиях информационной перегрузки это большое преимущество. 

  • Поддержка 24/7. Виртуальный помощник может осуществлять поддержку пользователей в режиме ответа на FAQ. В отличие от «живых» специалистов, он доступен для обращения в любое время суток.

Интересующие нас чат-боты бывают двух основных типов:

1 В виде самостоятельного лендинга.

2 Виджет на странице сайта.

Несмотря на все преимущества, чат-боты не всегда способствуют конверсии – в некоторых случаях они могут ей только навредить. Разберемся, каким бизнесам они подойдут, а каким стоит вообще отказаться от этого инструмента.

Кому использовать чат-боты

Лучше всего чат-боты работают в сегменте B2C – с товарами и услугами, о которых пользователи не имеют достаточно знаний. Это могут быть, например, программы страхования, банковские продукты, гостиничные номера, медицинские услуги, развлекательные мероприятия и т.п.

Здесь хорошо работает аналогия с консультантом в фирменном магазине Apple. Вы можете ничего не знать о тактовой частоте процессора, функциях оперативной памяти и различиях видеочипов, но вам достаточно рассказать о своих целях и бюджете, и специалист быстро подберет вам ноутбук, не вдаваясь в подробности.

Если выбор вашего товара может проходить таким же образом, а для покупки пользователю не обязательно разбираться в его устройстве, чат-бот – решение для вас, и его стоит использовать.

Кому не использовать чат-боты

Противоположная ситуация: потенциальный клиент обладает большим объемом информации о продукте и перед покупкой хочет узнать все его характеристики. Часто такое встречается в сфере B2B: корпоративное ПО, промышленную технику, логистические услуги и т.п. заказывают специалисты, хорошо в них разбирающиеся.

Из сегмента B2C сюда попадут персонализируемые товары и услуги, не связанные со сложными технологиями. Например, салоны красоты, мебель, туризм или интернет-магазины с широким ассортиментом товаров повседневного спроса, в выборе которых чат-бот не поможет.

Представьте, что около овощей и фруктов в супермаркете к вам подойдет консультант из предыдущего примера. Вряд ли его вопросы о ваших потребностях помогут вам наполнить корзину – только лишат возможности спокойно изучить все полки самому.

Как настроить чат-бот

Добавить и настроить чат-бот на своем сайте можно несколькими способами. Среди основных:

Плагин CMS

Владельцам сайтов на известных CMS – WordPress, Drupal, joomla и т.д. – как всегда, повезло больше всех. Под эти движки обычно уже есть готовые плагины чат-ботов, для настройки которых не обязательно иметь навыки программирования. Вот некоторые из них:

WordPress – Collect.chat, IBM Watson Assistant, Acobot Lead Generation AI Chatbot (полный список)

Drupal – Drupal Chatbot, Acobot AI Live Chat (Free Chatbot), Chatbot Builder (полный список)

joomla – Webemus Cliengo ChatBot (полный список)

Часто такие расширения работают по наглядной схеме drag-and-drop. Например, в Collect.chat настройка скрипта для бота выглядит следующим образом:

Полная функциональность популярных плагинов бывает платной, но и облегченная бесплатная версия доступна во многих из них.

Специализированный сервис

Второй способ подключить чат-бота – воспользоваться специально созданным для этого онлайн-сервисом. Например:

Среди них вы сможете найти идеальный вариант – как простое визуализированное решение, так и полноценный фреймворк для девелоперов. Правда, бесплатным в этом случае будет только пробный период. По сравнению с плагинами CMS, у самостоятельных сервисов гораздо более развитая клиентская поддержка и широкая кастомизация.

Создание «с нуля»

Самый универсальный, хотя и самый сложный способ создать бота для сайта – написать его «с нуля». Для этого понадобятся либо услуги программиста – штатного или фрилансера – либо знание основ кодинга и понятный гайд.

Примеры хороших инструкций по созданию чат-ботов с помощью Node.js опубликованы по ссылке. Хотя этот подход требует наибольших вложений времени и средств, на выходе вы получаете полностью кастомизируемый виджет, алгоритмы которого известны вам от начала до конца.

Ручная настройка через Telegram

На Хабре некоторое время назад рассматривался необычный подход к созданию чат-помощника для сайта. В нем Telegram-бот используется в качестве посредника между пользователями, задающими вопросы на сайте, и представителями компании, отвечающими на них.

По первоначальному замыслу это не бот как таковой: общаться с клиентами приходится сотрудникам. Однако решение сохраняет все преимущества анонимной текстовой переписки и избавляет от необходимости придумывать автоматические сценарии диалога. При желании его можно модернизировать, «посадив» на другой конец настоящего Telegram-бота, созданного в одном из перечисленных выше сервисов.

6 правил робототехники

В заключение приведем несколько рекомендаций, которым полезно следовать при создании собственного чат-бота.

1 Минимум кликов. Как и всегда в интерфейсах приложений, чем меньше нажатий требует операция, тем меньше шансов, что пользователь бросит ее выполнение. Используйте инструменты упрощенного ввода: от вопросов с множественным выбором и меню до распознавания речи.

2 Минимум сообщений. Дополнение к предыдущему пункту: пользователи ценят, когда бот говорит мало и по делу.

3 Начать с простого. Чат-бот должен создавать ценность для клиента, выполняя хотя бы одну полезную функцию, которой нет в интерфейсе сайта.

4 Предлагать следующий шаг. В идеале при переписке с ботом клиенту не приходиться думать самому.

5 Всегда отвечать. Даже когда чат-бот «не понял» сообщения, лучше с юмором признаться в этом пользователю, чем вообще оставить его без ответа.

6 Персонализировать. Приятнее общаться с ботом, разговаривающим на «человеческом» языке в своей собственной манере. Несколько вариантов ответа на один и тот же вопрос – простой, но эффективный шаг к «очеловечиванию» алгоритма.

Итог

Грамотно настроенный чат-бот помогает упростить взаимодействие пользователей с сайтом и приблизить их к конверсии. Приводить этих пользователей на сайт по разным каналам продвижения удобно через бесплатную систему автоматизации рекламы Click.ru.

В сервисе есть все необходимые инструменты для быстрого запуска контекстных и таргетированных кампаний: от планирования семантики и анализа конкурентов до распределения бюджета и генерации готовых объявлений. Стабильное вознаграждение партнерам с оборота рекламных расходов в Яндекс и Google позволит выделить больше средств на постклик-оптимизацию, в том числе, разработку бота. Уделяйте больше внимания потенциальным клиентам на нижних уровнях «воронки продаж», автоматизировав привлечение трафика с верхних.

Чат-бот на базе ИИ | Microsoft Azure

Существует два основных типа чат-ботов, которые используются в компаниях: транзакционные и разговорные. Они отличаются общим уровнем сложности и использования искусственного интеллекта.

Транзакционные чат-боты

Транзакционных чат-ботов также еще называют ориентированными на задания или декларативными. Это узкоспециализированные чат-боты, основная цель которых заключается в выполнении или автоматизации одной функции. В них используются правила, алгоритмы обработки естественного языка и в меньшей степени технология машинного обучения. Обучения этого типа ботов выполняется на основе структурированных данных. Транзакционные чат-боты предназначены для ответа на фиксированные вопросы и решения определенных проблем. После выбора вопроса чат-бот будет предлагать возможные варианты, пока пользователь не получит нужный ответ.

Транзакционные чат-боты генерируют автоматические ответы в режиме диалога. Общаться с такими чат-ботами нужно строго определенными фразами, что делает их полезными для компаний, которые заранее знают, в чем их клиентам может понадобиться помощь. Например, рестораны, службы доставки и банки используют транзакционных чат-ботов для ответа на стандартные вопросы, например о часах работы, или для помощи клиентам в выполнении простых операций без нюансов. Сейчас транзакционные чат-боты очень распространены.

Разговорные чат-боты

Разговорные чат-боты обладают более развитыми, интерактивными и персонализированным возможностями. Они используют разговорный ИИ, чтобы интерпретировать сообщения пользователей и естественно отвечать на них. Благодаря искусственному интеллекту, алгоритмам обработки естественного языка и доступу к базам знаний и другой информации эти чат-боты могут обнаруживать нюансы в вопросах и ответах пользователей и имитировать ответы людей. Эти чат-боты на базе ИИ учитывают контекст и используют принципы понимания естественного языка, NLP и машинное обучение, чтобы обучаться в процессе работы.

Разговорные чат-боты на базе ИИ, которых часто называют виртуальными или цифровыми помощниками, также применяют упреждающую аналитику для персонализации на основе профилей пользователей и их поведения в прошлом. Они могут в течение определенного времени изучать предпочтения пользователей, а затем предоставлять рекомендации и даже предугадывать потребности. Разговорных чат-ботов используют интернет-магазины, онлайн-сервисы, социальные сети, компаниями с передовыми SaaS-инструментами, а также B2B-компаниями, которые предоставляют корпоративные решения.

Как сделать эффективного многоязычного чат-бота

Зачем нужен многоязычный чат-бот

Многоязычные боты поддерживают запросы на трех и более языках. Этим они отличаются от одноязычных и двуязычных ботов, понимающих один и два языка соответственно. 

Функционал многоязычных ботов, как и любых других, зависит от целей автоматизации: ответы на запросы пользователей в режиме 24/7, предоставление справочной информации, прием и оформление заказов, помощь в выборе продуктов и др. Нюансы начинаются при адаптации этого функционала под разные языковые аудитории. 

Многоязычные боты актуальны для крупных компаний, работающих в нескольких странах, или глобальных социальных проектов.

Так, в ответ на пандемию коронавируса эксперты ЮНИСЕФ/РОЕЦА и ВОЗ/Европа запустили интерактивного чат-бота HealthBuddy Europe. 

Он помогает получить достоверную информацию, связанную с COVID-19: какие варианты заболевания существуют, как проявляются симптомы, есть ли вакцины и др. В настоящее время бот доступен на 19 языках, включая английский, испанский, итальянский, казахский, португальский и русский.

Также многоязычные боты востребованы, если в регионе присутствия компании пользователи говорят на разных языках. Например, по данным KPMG и Google, в Индии 72,9% пользователей общаются на хинди, 27,1% — на английском. 

Существуют также другие языки и многочисленные диалекты. Принимая во внимание этот факт, диагностический медицинский центр Dr. Lal PathLabs со штаб-квартирой в Дели решил внедрить в службу поддержки клиентов многоязычного бота.

 

Как сделать многоязычный чат-бот

Для реализации многоязычного бота используются разные языки NLU (Natural language understanding, понимание естественного языка). Поддерживаемые языки и принципы, по которым бот переключается с одного языка на другой, различаются и зависят от возможностей платформ (Botmock, Xenioo, BotMyWork и др.).

Например, Dialogflow поддерживает более 50 языков, а язык общения бот выбирает в зависимости от локали девайса или канала, в котором происходит диалог.

Благодаря встроенному мультиязычному NLU-ядру CAILA на базе JAICP от Just AI можно создавать ботов на 16 языках, а также подключать к проекту внешние NLU-сервисы для поддержки других языков.

Язык общения может задаваться настройками канала, также платформа позволяет реализовать динамический выбор языка в процессе разговора. 

В случае с двуязычным ботом это работает так: допустим, клиент общается с русскоязычным ботом, а потом пишет запрос на английском. Бот переключает контекст на англоязычного бота — теперь клиент продолжает общение с этим ботом. Позже пользователь снова может написать запрос на русском, и контекст беседы будет возвращен на русскоязычного бота. 

Описанная схема не подойдет, если к русскому и английскому добавить французский: слишком частое переключение контекста без возврата может привести к переполнению стека ботов. В схему требуется добавить еще один компонент — роутер.

Бот-роутер представляет собой промежуточное звено между одноязычными ботами, он определяет язык входящих запросов и перенаправляет их на нужного бота.

 

На что обратить внимание при разработке 

 

  • На семантические различия слов

Семантика как лингвистическая наука изучает смысловое значение единиц языка, например, слов и выражений. При создании многоязычных ботов нельзя механически переводить, так как значения слов в разных языках могут отличаться. 

Например, в русском языке есть слова голубой и синий, и мы понимаем разницу между ними, но в английском оба цвета называются blue. Выражения Good evening и Good night технически представляют собой одно и то же, но первое звучит как приветствие, а второе — как прощание. Это и есть семантические различия.  

 

  • На глубину перевода 

Переводчик интерпретирует смысл текста на одном языке и создает эквивалентный текст на другом. Его главная задача — без искажений передать смысл оригинала. 

Существует вид перевода, требующий более высокой квалификации специалиста и творческого подхода, — транскреация. Ее используют в рекламных или маркетинговых целях, для передачи названий фильмов. 

Специалист, который занимается транскреацией, должен ориентироваться на новую целевую аудиторию и сделать текст максимально понятным для нее. Транскреация учит думать о ситуации в целом и переводить с учетом различий в психологии пользователей и языковых особенностей, поэтому такой подход полезно использовать при разработке многоязычных ботов. 

 

  • На культурные различия между странами 

Когда между пользователями многоязычного чат-бота существуют весомые культурные различия, личность бота на каждом рынке нужно создавать заново. Например, есть игра с голосовым ботом в образе добродушного почтальона.

Француз будет в восторге, если виртуальный персонаж спросит о том, как прошел день рождения дочери. Англичанина такое общение насторожит. Он подумает: «Откуда этот странный почтальон знает, что у моей дочери вчера был день рождения?». 

В одной стране принят small talk перед тем, как перейти к делу, в другом регионе не любят терять времени зря. В Китае считается неприличным открыто говорить «нет». Культурные особенности влияют на характер бота, словарь и структуру вопросов и ответов, цель и структуру пользовательского опыта. Все это нужно отразить в сценарии бота. 

 

  • На состав команды 

Чтобы не прогадать с переводом и психологией пользователей, стоит включить в состав команды носителя языка. Особенно это актуально для таких сложных языков, как китайский, и закрытых культур, например, Японии.

 

  • На процесс тестирования 

Тестирование имеет смысл проводить с участием носителей языка и тех, для кого используемый язык второй или третий. Теоретически может быть такая ситуация: во время заграничной поездки русскоязычный клиент захочет воспользоваться ботом и выберет английский, если опции с его родным языком не будет. 

Фото на обложке: TippaPatt/shutterstock.com

Ботов: Введение для разработчиков

Боты — это сторонние приложения, которые работают внутри Telegram. Пользователи могут взаимодействовать с ботами, отправляя им сообщения, команды и встроенные запросы. Вы управляете своими ботами с помощью HTTPS-запросов к нашему Bot API.

1. Что можно делать с ботами?

Чтобы назвать несколько вещей, вы можете использовать ботов для:

  • Получайте индивидуальные уведомления и новости . Бот может действовать как умная газета, рассылая вам релевантный контент, как только он будет опубликован.

  • Интеграция с другими сервисами . Бот может дополнять чаты Telegram контентом из внешних сервисов.
    Gmail Бот , GIF-бот , IMDB-бот , Wiki-бот , Музыкальный бот , Youtube-бот , GitHubBot

  • Принимать платежи от пользователей Telegram . Бот может предлагать платные услуги или работать как виртуальная витрина. Подробнее »
    Demo Shop Bot , Demo Store

  • Создание собственных инструментов .Бот может предоставлять вам оповещения, прогнозы погоды, переводы, форматирование или другие услуги.
    Markdown бот , Наклейка бот , Голосовать бот , Лайк бот

  • Создание однопользовательских и многопользовательских игр . Бот может предложить богатые возможности HTML5, от простых аркад и головоломок до 3D-шутеров и стратегических игр в реальном времени.
    GameBot , Gamee

  • Создание социальных служб .Бот может связывать людей, которые ищут партнеров для разговора на основе общих интересов или близости.

  • Практически все остальное . Кроме посуды — боты плохо мыть посуду.

2. Как работают боты?

По сути, боты Telegram — это специальные учетные записи, для настройки которых не требуется дополнительный номер телефона. Пользователи могут взаимодействовать с ботами двумя способами:

  • Отправляйте сообщения и команды ботам, открывая с ними чат или добавляя их в группы.
  • Отправляйте запросы прямо из поля ввода, набрав @username бота и запрос. Это позволяет отправлять контент от встроенных ботов прямо в любой чат, группу или канал.

Сообщения, команды и запросы, отправляемые пользователями, передаются программному обеспечению, работающему на ваших серверах. Наш промежуточный сервер обрабатывает все шифрование и связь с Telegram API за вас. Вы общаетесь с этим сервером через простой HTTPS-интерфейс, который предлагает упрощенную версию Telegram API.Мы называем этот интерфейс нашим Bot API.

Подробное описание Bot API доступно на этой странице »

3. Как создать бота?

Для этого есть… бот. Просто поговорите с BotFather (описанным ниже) и выполните несколько простых шагов. После того, как вы создали бота и получили токен авторизации, перейдите к руководству по API бота, чтобы узнать, чему вы можете научить своего бота.

Вы также можете ознакомиться с некоторыми примерами кода здесь »

4.Чем боты отличаются от людей?
  • У ботов нет онлайн-статуса и отметок времени последнего посещения, вместо этого в интерфейсе отображается метка «бот» .
  • Боты имеют ограниченное облачное хранилище — старые сообщения могут быть удалены сервером вскоре после их обработки.
  • Боты не могут инициировать разговоры с пользователями. Пользователь должен либо добавить их в группу, либо сначала отправить им сообщение. Люди могут использовать ссылки t.me/ или поиск по имени пользователя, чтобы найти вашего бота.
  • Имена пользователей ботов всегда заканчиваются на «бот» (например, @TriviaBot, @GitHub_bot).
  • При добавлении в группу боты по умолчанию не получают все сообщения (см. Конфиденциальный режим).
  • Боты никогда не едят, не спят и не жалуются (если специально не запрограммировано иное).

5. Бонусы для ботов Боты

Telegram уникальны во многих отношениях — мы предлагаем два типа клавиатур, дополнительные интерфейсы для команд по умолчанию и глубинные ссылки, а также форматирование текста, интегрированные платежи и многое другое.

Встроенный режим

Пользователи могут взаимодействовать с вашим ботом с помощью встроенных запросов прямо из поля ввода текста в любом чате . Все, что им нужно сделать, это начать сообщение с именем пользователя вашего бота, а затем ввести запрос.

Получив запрос, ваш бот может вернуть некоторые результаты. Как только пользователь нажимает на один из них, он отправляется в текущий открытый чат пользователя. Таким образом, люди могут запрашивать контент у вашего бота в любом из своих чатов, групп или каналов.

Загляните в этот блог, чтобы увидеть в действии пример встроенного бота. Вы также можете попробовать ботов @sticker и @music, чтобы убедиться в этом сами.

Мы также реализовали простой способ для вашего бота переключаться между встроенным режимом и режимом PM.

Подробнее о встроенном режиме »

Платежная платформа

Вы можете использовать ботов для приема платежей от пользователей Telegram по всему миру.

  • Отправляйте счета на в любой чат , в том числе в группы и каналы.
  • Создание счетов-фактур, которые могут быть переадресованы и использованы несколькими покупателями для заказа вещей.
  • Используйте встроенный режим, чтобы помочь пользователям показывать ваши товары и услуги своим друзьям и сообществам.
  • Разрешить подсказок от пользователей с предварительно установленными и настраиваемыми суммами.
  • Принимать платежи от пользователей в мобильных или настольных приложениях .
  • Попробуйте @ShopBot, чтобы создать тестовый счет — или начните сообщение с @ShopBot ... в любом чате для встроенного счета .
  • Посетите демонстрационный магазин, чтобы увидеть пример канала Telegram, используемого в качестве виртуальной витрины .

Подробнее о Платежной платформе »

Игровая платформа

Боты могут предложить своим пользователям игр HTML5 , чтобы играть в одиночку или соревноваться друг с другом в группах и в чатах один на один. Платформа позволяет вашему боту отслеживать очков, за каждую игру, сыгранную в каждом чате. Каждый раз, когда в игре появляется новый лидер, другие участники чата уведомляются о том, что им нужно активизировать его.

Поскольку в основе лежит технология HTML5, игры могут быть любыми, от простых аркад и головоломок до многопользовательских 3D-шутеров и стратегических игр в реальном времени. Наша команда создала для вас несколько простых демонстраций:

Вы также можете проверить бота @gamee , у которого более 20 игр.

Подробнее об игровой платформе »

Клавиатуры

Традиционных чат-ботов, конечно, можно научить понимать человеческий язык.Но иногда вам требуется более формальный ввод от пользователя — и именно здесь пользовательские клавиатуры могут стать чрезвычайно полезными.

Всякий раз, когда ваш бот отправляет сообщение, он может передать специальную клавиатуру с предопределенными параметрами ответа (см. ReplyKeyboardMarkup). Приложения Telegram, которые получают сообщение, будут отображать вашу клавиатуру для пользователя. Нажатие любой кнопки немедленно отправит соответствующую команду. Таким образом, вы можете значительно упростить взаимодействие пользователя с вашим ботом.

В настоящее время мы поддерживаем текст и эмодзи для ваших кнопок. Вот несколько примеров пользовательской клавиатуры:

Для получения дополнительной технической информации о настраиваемых клавиатурах обратитесь к руководству по Bot API (см. SendMessage).

Встроенные клавиатуры и обновление на лету

Бывают случаи, когда вы предпочитаете делать что-либо, не отправляя никаких сообщений в чат. Например, когда ваш пользователь меняет настройки или просматривает результаты поиска. В таких случаях вы можете использовать встроенные клавиатуры, которые интегрированы непосредственно в сообщения, которым они принадлежат.

В отличие от настраиваемых клавиатур для ответов, нажатие кнопок на встроенных клавиатурах не приводит к отправке сообщений в чат. Вместо этого встроенные клавиатуры поддерживают кнопки, которые работают за кулисами: кнопки обратного вызова, кнопки URL и переключение на встроенные кнопки.

Когда используются кнопки обратного вызова, ваш бот может обновлять свои существующие сообщения (или только свои клавиатуры), чтобы чат оставался аккуратным. Ознакомьтесь с этими примерами ботов, чтобы увидеть встроенные клавиатуры в действии: @music, @vote, @like.

Подробнее о встроенных клавиатурах и редактировании «на лету» »

Команды Команды

представляют собой более гибкий способ связи с вашим ботом.Может использоваться следующий синтаксис:

  / команда

Команда всегда должна начинаться с символа «/» и не может быть длиннее 32 символов. Команды могут использовать латинские буквы, цифры и символы подчеркивания. Вот несколько примеров:

  / get_messages_stats
/ set_timer 10мин будильник!
/ get_timezone Лондон, Великобритания

Сообщения, начинающиеся с косой черты, всегда передаются боту (вместе с ответами на его сообщения и сообщениями, которые @ упоминают бота по имени пользователя).Приложения Telegram будут:

  • Предложите список поддерживаемых команд с описаниями, когда пользователь вводит ‘/’ (для того, чтобы это работало, вы должны предоставить список команд для BotFather). Нажатие на команду в списке немедленно отправляет команду.
  • Показать дополнительную кнопку (/) в поле ввода во всех чатах с ботами. При нажатии на нее набирается ‘/’ и отображается список команд.
  • Выделите / команды в сообщениях. Когда пользователь нажимает выделенную команду, команда отправляется сразу.

Если в группе несколько ботов, можно добавить имена пользователей ботов в команды, чтобы избежать путаницы:

  / start @ TriviaBot
/ start @ ApocalypseBot

Это делается автоматически, когда команды выбираются из списка предложений. Помните, что ваш бот должен уметь обрабатывать команды, за которыми следует его имя пользователя.

Глобальные команды

Чтобы упростить пользователям навигацию по мультивселенной ботов, мы просим всех разработчиков поддерживать несколько основных команд.В приложениях Telegram будет ярлыков интерфейса для этих команд.

  • / начало — начинает взаимодействие с пользователем, например, отправляя приветственное сообщение. Эту команду также можно использовать для передачи боту дополнительных параметров (см. Глубинные ссылки)
  • / help — возвращает справочное сообщение. Это может быть краткий текст о том, что может делать ваш бот, и список команд.
  • / settings — (если применимо) возвращает настройки бота для этого пользователя и предлагает команды для редактирования этих настроек.

Пользователи увидят кнопку Start , когда они впервые начнут беседу с вашим ботом. Справка и Настройки Ссылки будут доступны в меню на странице профиля бота.

Форматирование: полужирный, курсив, текст фиксированной ширины и встроенные ссылки

Вы можете использовать полужирный, курсив или текст фиксированной ширины, а также встроенные ссылки в сообщениях ваших ботов. Клиенты Telegram будут отображать их соответственно.

Подробнее читайте в руководстве по Bot API »

Режим конфиденциальности

Ботов часто добавляют в группы, чтобы улучшить общение между пользователями-людьми, например.г. путем предоставления новостей, уведомлений от внешних служб или дополнительных функций поиска. Это особенно актуально для групп, связанных с работой. Теперь, когда вы делитесь группой с ботом, вы склонны спрашивать себя: «Как я могу быть уверен, что этот маленький негодяй не продает мою историю чата моим конкурентам?» Ответ — приватный режим .

Бот, работающий в режиме конфиденциальности, не будет получать все сообщения, которые люди отправляют группе. Вместо этого он получит только:

  • Сообщения, начинающиеся с косой черты ‘/’ (см. Команды выше)
  • Ответы на собственные сообщения бота
  • Служебные сообщения (люди, добавленные или удаленные из группы и т. Д.)
  • Сообщения из каналов, в которых он участвует

С одной стороны, это помогает некоторым из нас лучше спать по ночам (в наших колпаках из фольги), с другой — позволяет разработчикам ботов экономить много ресурсов, поскольку им не нужно обрабатывать десятки тысяч неактуальных сообщения каждый день.

Конфиденциальный режим включен по умолчанию для всех ботов, кроме ботов, которые были добавлены в группу как админы (админы ботов всегда получают все сообщения). Его можно отключить, чтобы бот получал все сообщения, как обычный пользователь (для того, чтобы это изменение вступило в силу, боту необходимо будет повторно добавить и в группу).Мы рекомендуем делать это только в тех случаях, когда для работы вашего бота это абсолютно необходимо — пользователи всегда могут видеть текущие настройки конфиденциальности бота в списке участников группы. В большинстве случаев использования опции принудительного ответа для сообщений бота более чем достаточно.

Итак, какие именно сообщения будет получать мой бот? »

Глубокие ссылки

Telegram-боты имеют механизм глубоких ссылок, который позволяет передавать дополнительные параметры боту при запуске. Это может быть команда, запускающая бота, или токен аутентификации для подключения учетной записи Telegram пользователя к его учетной записи на каком-либо внешнем сервисе.

У каждого бота есть ссылка, открывающая с ним беседу в Telegram — https://t.me/ . К этой ссылке можно добавить параметры start или startgroup со значениями длиной до 64 символов. Например:

  https://t.me/triviabot?startgroup=test

A-Z , a-z , 0-9 , _ и - разрешены. Мы рекомендуем использовать base64url для кодирования параметров с двоичными и другими типами содержимого.

Переход по ссылке с параметром start откроет индивидуальный диалог с ботом, показывая кнопку СТАРТ вместо поля ввода. Если используется параметр startgroup , пользователю предлагается выбрать группу для добавления бота. Как только пользователь подтверждает действие (нажимает кнопку СТАРТ в своем приложении или выбирает группу для добавления бота), ваш бот получит сообщение от этого пользователя в следующем формате:

  / начало PAYLOAD

PAYLOAD обозначает значение параметра start или startgroup , которое было передано в ссылке.

Пример глубокой ссылки

Предположим, сайт example.com хочет отправлять уведомления своим пользователям через бота Telegram. Вот что они могут сделать, чтобы включить уведомления для пользователя с идентификатором 123 .

  1. Создайте бота с подходящим именем пользователя, например @ExampleComBot
  2. Настроить веб-перехватчик входящих сообщений
  3. Сгенерировать случайную строку достаточной длины, например $ memcache_key = "vCh2vGWJxfSeofSAs0K5PA"
  4. Поместите значение 123 с ключом $ memcache_key в Memcache на 3600 секунд (один час)
  5. Покажем нашему пользователю кнопку https: // t.меня / ExampleComBot? start = vCh2vGWJxfSeofSAs0K5PA
  6. Настройте процессор веб-перехватчиков для запроса Memcached с параметром, который передается во входящих сообщениях, начиная с / start . Если ключ существует, запишите chat_id, переданный веб-перехватчику, как telegram_chat_id для пользователя 123 . Удалите ключ из Memcache.
  7. Теперь, когда мы хотим отправить уведомление пользователю 123 , проверьте, есть ли у него поле telegram_chat_id .Если да, используйте метод sendMessage в API ботов, чтобы отправить им сообщение в Telegram.
Расположение и номер

Некоторым ботам для правильной работы требуются дополнительные данные от пользователя. Например, знание местоположения пользователя помогает получить более релевантные географические результаты. Номер телефона пользователя может быть очень полезен для интеграции с другими сервисами, такими как банки и т. Д.

Боты могут запрашивать у пользователя его местонахождение и номер телефона с помощью специальных кнопок.Обратите внимание, что кнопки и номера телефона, и кнопки запроса местоположения будут работать только в приватных чатах.

При нажатии этих кнопок клиенты Telegram отображают подтверждающее уведомление, которое сообщает пользователю, что должно произойти.

Руководство: Цифровые и позиционные кнопки »

6. BotFather

Вверх, чтобы узнать все о ботах Telegram »

BotFather — единственный бот, который правит ими всеми. Это поможет вам создать новых ботов и изменить настройки существующих.

Создание нового бота

Используйте команду / newbot для создания нового бота. BotFather запросит у вас имя и имя пользователя, а затем сгенерирует токен авторизации для вашего нового бота.

Имя вашего бота отображается в контактных данных и в других местах.

Имя пользователя — это короткое имя, которое используется в упоминаниях и ссылках на t.me. Имена пользователей состоят из 5–32 символов и нечувствительны к регистру, но могут включать только латинские символы, числа и символы подчеркивания.Имя пользователя вашего бота должно заканчиваться на на «бот», например tetris_bot или TetrisBot.

Токен представляет собой строку в соответствии со строками 110201543: AAHdqTcvCh2vGWJxfSeofSAs0K5PALDsaw , которая требуется для авторизации бота и отправки запросов в API бота. Держите свой токен в безопасности и храните его в безопасности, он может использоваться кем угодно для управления вашим ботом.

Создание токена авторизации

Если ваш существующий токен скомпрометирован или вы потеряли его по какой-либо причине, используйте команду / token для создания нового.

Botfather командует

Остальные команды говорят сами за себя:

  • / mybots — возвращает список ваших ботов с удобными элементами управления для редактирования их настроек
  • / mygames — делает то же самое для ваших игр

Редактировать ботов

  • / setname — измените имя вашего бота.
  • / setdescription — изменить описание бота , короткий текст до 512 символов, описывающий вашего бота.Пользователи увидят этот текст в начале разговора с ботом, озаглавленный «Что умеет этот бот?».
  • / setabouttext — изменить бота на информацию , еще более короткий текст до 120 символов. Пользователи увидят этот текст на странице профиля бота. Когда они делятся вашим ботом с кем-то, этот текст отправляется вместе со ссылкой.
  • / setuserpic — изменить фото профиля бота. Всегда приятно поменять имя на лицо.
  • / setcommands — изменить список команд, поддерживаемых вашим ботом.Пользователи будут видеть эти команды как предложения, когда они набирают / в чате с вашим ботом. Каждая команда имеет имя (должно начинаться с косой черты ‘/’, буквенно-цифровое значение плюс подчеркивание, не более 32 символов, без учета регистра), параметры и текстовое описание. Пользователи будут видеть список команд всякий раз, когда они набирают ‘/’ в разговоре с вашим ботом.
  • / deletebot — удалите своего бота и освободите его логин.

Изменить настройки

  • / setinline — переключить встроенный режим для вашего бота.
  • / setinlinegeo — запросить данные о местоположении для предоставления встроенных результатов на основе местоположения.
  • / setjoingroups — переключить, можно ли добавлять вашего бота в группы или нет. Любой бот должен уметь обрабатывать личные сообщения, но если ваш бот не предназначен для работы в группах, вы можете отключить это.
  • / setprivacy — укажите, какие сообщения будет получать ваш бот при добавлении в группу. Если режим конфиденциальности отключен, бот будет получать все сообщения.Мы рекомендуем оставить режим конфиденциальности включенным. Вам нужно будет повторно добавить бота в существующие группы, чтобы это изменение вступило в силу.

Управление играми

  • / newgame — создать новую игру.
  • / listgames — получите список своих игр.
  • / editgame — редактировать игру.
  • / deletegame — удалить существующую игру.

Обратите внимание, что может потребоваться несколько минут , чтобы изменения вступили в силу.

Предупреждения о состоянии

миллионов выбирают Telegram за его скорость. Чтобы оставаться конкурентоспособным в этой среде, ваш бот также должен быть отзывчивым. Чтобы помочь разработчикам поддерживать своих ботов в форме, Botfather отправляет оповещения о статусе, если видит, что что-то не так.

Мы будем проверять количество ответов и коэффициент конверсии запросов / ответов для популярных ботов (~ 300 запросов в минуту: но не записывайте это, поскольку значение может измениться в будущем).Если мы получим аномально низкие показания, вы получите уведомление от Botfather.

Ответ на предупреждения

По умолчанию вы будете получать только одно предупреждение на одного бота в час. Каждое предупреждение имеет следующие кнопки:

  • Фиксированный. Используйте это, если вы обнаружили проблему с вашим ботом и исправили ее. Если вы нажмете кнопку исправления, мы возобновим отправку предупреждений в обычном режиме, чтобы вы могли видеть, сработало ли исправление в течение 5–10 минут, вместо того, чтобы ждать час.
  • Поддержка. Используйте это, чтобы открыть чат с @BotSupport, если вы не видите проблем с ботом или считаете, что проблема на нашей стороне.
  • Без звука на 8 часов / 1 нед. Используйте это, если вы не можете исправить своего бота в данный момент. Это отключит все предупреждения для рассматриваемого бота за указанный период времени. Мы не рекомендуем использовать эту опцию, поскольку ваши пользователи могут перейти на более стабильный бот. Вы можете включить оповещения в настройках своего бота через Botfather.
Отслеживаемые проблемы

В настоящее время мы будем уведомлять вас о следующих проблемах:

1.

  Слишком мало ** личных сообщений ** отправлено по сравнению с предыдущими неделями: ** {value} **

Ваш бот отправляет гораздо меньше сообщений, чем в предыдущие недели. Это полезно для ботов в стиле новостной рассылки, которые рассылают сообщения без подсказок от пользователей. Чем больше значение, тем значительнее разница.

2. 

  Слишком мало ответов на входящие ** личные сообщения **. Коэффициент конверсии: ** {value} **

Ваш бот не отвечает на все отправляемые ему сообщения (коэффициент конверсии запросов / ответов для вашего бота был слишком низким как минимум в течение двух из трех последних 5-минутных периодов).Чтобы обеспечить удобство работы пользователей, отвечайте на все сообщения, отправляемые вашему боту. Ответьте на сообщение обновлений , вызвав методы send… (например, sendMessage).

3. 

  Слишком мало ответов на ** встроенные запросы **. Коэффициент конверсии: ** {value} **

Ваш бот не отвечает на все отправляемые ему встроенные запросы, рассчитанные таким же образом, как указано выше. Ответьте на обновлений inline_query , вызвав answerInlineQuery.

4. 

  Слишком мало ответов на ** запросы обратного вызова **. Коэффициент конверсии: ** {значение} **
Слишком мало ответов на ** запросы к игре обратного вызова **. Коэффициент конверсии: ** {value} **

Ваш бот не отвечает на все отправляемые ему запросы обратного вызова (с играми или без них), рассчитанные таким же образом, как указано выше. Ответьте на обновления callback_query , вызвав answerCallbackQuery.

Обратите внимание, что функция предупреждений о состоянии все еще тестируется и будет улучшена в будущем.

Это введение. Теперь вы определенно готовы перейти к РУКОВОДСТВУ ПО API BOT .

Если у вас есть вопросы, ознакомьтесь с часто задаваемыми вопросами о Bot »

встроенных ботов

Помимо отправки команд в личных сообщениях или группах, пользователи могут взаимодействовать с вашим ботом с помощью встроенных запросов . Если встроенные запросы включены, пользователи могут вызвать вашего бота, введя его имя пользователя и запрос в поле ввода текста в любом чате .Запрос отправляется вашему боту в обновлении. Таким образом, люди могут запрашивать контент у вашего бота в любых своих чатах, группах или каналах, вообще не отправляя никаких сообщений.


Чтобы включить эту опцию, отправьте команду / setinline в @BotFather и укажите текст-заполнитель, который пользователь увидит в поле ввода после ввода имени вашего бота.

См. Соответствующие методы и объекты в Руководстве по API для ботов.

Встроенные результаты

Встроенные боты поддерживают всех типов контента , доступных в Telegram (всего 20).Они могут отправлять стикеры, видео, музыку, локации, документы и многое другое.


Клиенты могут отображать результаты с вертикальной или горизонтальной прокруткой, в зависимости от типа контента:


Как только пользователь нажимает на элемент, он немедленно отправляется получателю, а поле ввода очищается.

Переключение режимов inline / PM

Некоторым встроенным ботам может быть полезен процесс начальной настройки, например, подключение их к учетной записи на внешней службе (например.г., YouTube). Мы добавили простой способ переключения между приватным чатом с ботом и любым чатом, в котором пользователь хочет поделиться встроенными результатами.


Вы можете отобразить специальную кнопку «Перейти в личку» над встроенными результатами (или вместо них). Эта кнопка откроет приватный чат с ботом и передаст параметр по вашему выбору, чтобы вы могли запрашивать у пользователя соответствующие действия по настройке. После этого вы можете использовать встроенную клавиатуру с кнопкой switch_inline_query , чтобы отправить пользователя обратно в исходный чат.

Примеры ботов
@youtube — показывает кнопку «Войти на YouTube», а затем предлагает персонализированные результаты.

Руководство: переход на PM

Результаты на основе местоположения

Встроенные боты могут запрашивать данные о местоположении у своих пользователей. Используйте команду / setinlinegeo с @BotFather, чтобы включить это. Ваш бот будет запрашивать у пользователя разрешение на доступ к их местоположению всякий раз, когда он отправляет встроенный запрос.

Пример бота
@foursquare — этот бот запросит разрешение на доступ к местоположению пользователя, а затем предоставит результаты с геотаргетингом.

Вирусное распространение

В сообщениях, отправленных с помощью вашего бота, рядом с именем отправителя будет отображаться его имя пользователя.

Когда пользователь нажимает на имя пользователя бота в заголовке сообщения, упоминание автоматически вставляется в поле ввода. При вводе символа @ в поле ввода отображается список предложений, в которых представлены недавно использованные встроенные боты.

Сбор отзывов

Чтобы узнать, какие из предоставленных результатов ваши пользователи отправляют своим партнерам по чату, отправьте @Botfather команду / setinlinefeedback .Если этот параметр включен, вы будете получать обновления результатов, выбранных вашими пользователями.

Обратите внимание, что это может вызвать проблемы с загрузкой популярных ботов — вы можете получить больше результатов, чем фактические запросы из-за кеширования (см. Параметр cache_time в answerInlineQuery). В этих случаях мы рекомендуем отрегулировать настройку вероятности, чтобы получить 1/10, 1/100 или 1/1000 результатов.

Примеры встроенных ботов

Вот несколько примеров встроенных ботов на случай, если вам интересно увидеть один в действии.Попробуйте любой из этих вариантов:
@gif — поиск GIF
@vid — поиск видео
@pic — поиск изображений Яндекс
@bing — поиск изображений Bing
@wiki — поиск в Википедии
@imdb — поиск IMDB
@bold — выделите жирным, курсивный или фиксированный системный текст

NEW
@youtube — Подключите свою учетную запись для получения персонализированных результатов
@music — Поиск и отправка классической музыки
@foursquare — Поиск и отправка адресов места проведения
@sticker — Находите и отправляйте стикеры на основе эмодзи

Боты FAQ

Если вы новичок в ботах Telegram, мы рекомендуем сначала ознакомиться с нашим Знакомство с ботами .
Вам также может пригодиться Bot API Manual .

Общие вопросы
Как создать бота?

Создавать ботов Telegram очень просто, но вам потребуются хотя бы некоторые навыки компьютерного программирования. Чтобы бот работал, создайте учетную запись бота с помощью @BotFather, а затем подключите его к своему внутреннему серверу через наш API.

К сожалению, готовых способов создать работающего бота, если вы не разработчик, не существует.Но мы уверены, что скоро вы найдете множество ботов, созданных другими людьми, с которыми можно будет поиграть.

Я разработчик. Где найти примеры?

Вот два примера ботов, написанных на PHP:

  • Hello Bot демонстрирует основы API бота Telegram.
    • Бот
  • Simple Poll является более полным примером, он поддерживает как длинный опрос, так и Webhooks для получения обновлений.

Многие члены нашего сообщества создают ботов и публикуют исходники.
Собираем на на этой странице »

Напишите нам на @BotSupport, если вы создали бота и хотели бы поделиться им с другими.

Вы добавите X в Bot API?

API бота еще довольно молод. Есть много потенциальных возможностей, которые следует рассмотреть и реализовать. Некоторое время мы будем изучать, что люди делают со своими ботами, чтобы увидеть, какие направления будут наиболее важными для платформы.

Приглашаем всех разработчиков ботов делиться идеями относительно нашего Bot API в нашей учетной записи @BotSupport .

Какие сообщения будет получать мой бот?

1. Все боты вне зависимости от настроек получат:

  • Все служебные сообщения.
  • Все сообщения из приватных чатов с пользователями.
  • Все сообщения от каналов, участником которых они являются.

2. Администраторы ботов и боты с отключенным режимом конфиденциальности будут получать все сообщения, кроме сообщений, отправленных другими ботами.

3. Боты с включенным режимом конфиденциальности получат:

  • Команды, явно предназначенные для них (например, / command @ this_bot).
  • Общие команды от пользователей (например, / start) если бот был последним ботом, отправившим сообщение группе.
  • Сообщения, отправленные через этого бота.
  • Отвечает на любые сообщения, явно или неявно предназначенные для этого бота.

Примечание , что каждое конкретное сообщение может быть доступно только одному боту с поддержкой конфиденциальности одновременно, т.е.д., ответ боту A, содержащий явную команду для бота B или отправленный через бота C, будет доступен только боту A. Ответы имеют наивысший приоритет.

Почему мой бот не видит сообщения от других ботов?

Боты, разговаривающие друг с другом, потенциально могут застрять в нежелательных циклах. Чтобы этого избежать, мы решили, что боты не смогут видеть сообщения от других ботов независимо от режима.

Получение обновлений
Как мне получать обновления?

В настоящее время есть два способа получения обновлений.Вы можете использовать либо длинный опрос, либо Webhooks. Обратите внимание, что , а не , возможно получать обновления с помощью длительного опроса, пока установлен исходящий Webhook.

Продолжительный опрос дает мне одни и те же обновления снова и снова!

Метод getUpdates возвращает 100 первых неподтвержденных обновлений. Чтобы подтвердить обновление, используйте параметр offset при вызове getUpdates следующим образом:

  смещение = update_id последнего обработанного обновления + 1

Все обновления с update_id меньше или равным смещению будут помечены как подтвержденные на сервере и больше не будут возвращаться.

У меня проблемы с Webhooks.

Если вы успешно настроили веб-перехватчик, но не получаете никаких обновлений, помните:

  • Для работы веб-перехватчиков необходим действующий сертификат SSL.
  • Чтобы использовать самозаверяющий сертификат, вам необходимо загрузить сертификат открытого ключа с помощью параметра certificate в setWebhook. Пожалуйста, загрузите как InputFile, отправка строки не будет работать.
  • Порты, которые в настоящее время поддерживаются для Webhooks: 443 , 80 , 88 , 8443 .
  • Подстановочные сертификаты могут не поддерживаться.
  • Перенаправления не поддерживаются.
  • CN должен точно соответствовать вашему домену.

Пожалуйста, ознакомьтесь с этим новым WEBHOOK GUIDE , чтобы узнать все, что нужно знать о веб-перехватчиках!

У меня проблемы с самозаверяющим сертификатом!

Ознакомьтесь с этим руководством по самозаверяющим сертификатам, которое мы сделали специально для вас. Если вы прочитали это, но у вас все еще есть вопросы, напишите нам в службу поддержки ботов.

Как я могу убедиться, что запросы Webhook поступают из Telegram?

Если вы хотите убедиться, что запрос Webhook исходит от Telegram, мы рекомендуем использовать секретный путь в URL-адресе, который вы нам даете, например www.example.com/your_token. Поскольку никто другой не знает токен вашего бота, можете быть уверены, что это мы.

Как я могу делать запросы в ответ на обновления?

Это возможно, если вы используете веб-перехватчики. Положительный момент в том, что вам нужно меньше запросов, недостаток — в этом случае невозможно узнать, что такой запрос был успешным, или получить его результат.

Каждый раз, когда вы получаете обновление веб-перехватчика, у вас есть два варианта:

1. Отправьте сообщение POST на https://api.telegram.org/bot/method

2. Ответьте напрямую и укажите метод как полезную нагрузку JSON в ответе

Вы также можете взглянуть на наш пример HelloBot, он предлагает реализацию этого PHP.

Работа со СМИ
Как мне скачивать файлы?

Используйте метод getFile.Обратите внимание, что это будет работать только с файлами размером до 20 МБ.

Как загрузить большой файл?

Боты в настоящее время могут отправлять файлы любого типа размером до 50 МБ, так что да, очень большие файлы пока работать не будут. Сожалею. Этот лимит может быть изменен в будущем.

Могу ли я рассчитывать на постоянство file_ids?

Да, file_ids можно рассматривать как постоянные.

Передача пользователям
Мой бот достигает пределов, как мне этого избежать?

При отправке сообщений в определенном чате избегайте отправки более одного сообщения в секунду.Мы можем разрешить короткие пакеты, превышающие этот предел, но в конечном итоге вы начнете получать 429 ошибок.

Если вы отправляете массовые уведомления нескольким пользователям, API не будет разрешать более 30 сообщений в секунду или около того. Для достижения наилучших результатов рассмотрите возможность рассылки уведомлений через большие интервалы в 8–12 часов.

Также обратите внимание, что ваш бот не сможет отправлять более 20 сообщений в минуту в одну и ту же группу.

Как я могу отправить сообщение всем подписчикам моего бота сразу?

К сожалению, на данный момент у нас нет способов рассылки массовых сообщений, например.г. уведомления. Мы можем добавить что-нибудь в этом роде в будущем.

Чтобы избежать выхода за наши пределы при рассылке массовых уведомлений, рассмотрите возможность их распространения на более длительные интервалы, например 8-12 часов. API не будет разрешать массовые уведомления более чем ~ 30 пользователям в секунду, если вы перейдете через это, вы начнете получать 429 ошибок.

См. Также: Как избежать превышения лимита?

Если у вас есть вопросы, на которые нет ответов на этой странице, напишите нам на @BotSupport в Telegram.
Мы приветствуем любые предложения по бот-платформе и API.

Включение функции связи с ботами с помощью SDK

Вы можете отобразить возможность добавить официальную учетную запись LINE в качестве друга, когда пользователь входит в ваше приложение. Это называется функцией бот-ссылки . Разработчики могут указать официальную учетную запись LINE для добавления в друзья.

Перед тем, как приступить к настройке, прочтите раздел Добавление официальной учетной записи LINE в качестве друга при входе в систему (ссылка для бота) в документации для входа в систему LINE, чтобы понять функцию ссылки для бота и следующие особенности:

  • Связывание официальной учетной записи LINE с ваш канал на LINE Developers Console
  • Параметр приглашения бота, отправляемый на платформу LINE, и его поведение
  • Флаг статуса дружбы, возвращаемый платформой LINE, и его значение

В этом разделе объясняется, как включить эти функции связи между ботами с помощью LINE SDK:

Установка параметра приглашения бота в запросе на вход

В следующем примере кода показано, как установить параметр botPrompt при использовании виджета LoginButton .

В следующем примере кода показано, как установить параметр botPrompt при использовании метода LoginApi.getLoginIntent () .

Дополнительные сведения о значениях параметров см. В разделе LineAuthenticationParams.BotPrompt в справочнике LINE SDK для Android.

Проверка статуса дружбы между пользователем и официальной учетной записью LINE

Вы можете проверить статус дружбы между пользователем и официальной учетной записью LINE, используя следующие методы.

Проверьте объект

LineLoginResult в ответе на вход

После успешного входа в систему объект LineLoginResult содержит логическое значение, которое указывает, изменился ли статус дружбы. Вы можете получить значение с помощью метода getFriendshipStatusChanged () .

Чтобы получить флаг статуса дружбы, должны быть выполнены следующие условия:

  • Параметр botPrompt указывается с объектом LineAuthenticationParams в запросе на вход.
  • Пользователю отображается экран согласия с возможностью добавить свою официальную учетную запись LINE в качестве друга.

В следующем примере кода показано, как получить статус дружбы из объекта LineLoginResult .

Дополнительные сведения о возвращаемых значениях см. В разделе getFriendshipStatusChanged () в справочнике LINE SDK для Android.

Используйте LINE Login для получения статуса дружбы

Вызовите метод LineApiClient.getFriendshipStatus () после того, как пользователь вошел в ваше приложение и был возвращен токен доступа.

Для получения дополнительных сведений о возвращаемых значениях см. GetFriendshipStatus () в справочнике LINE SDK для Android.

Добавление бота к серверам

Если вы читали предыдущие страницы руководства, у вас должно быть настроено приложение бота. Однако его пока нет ни на одном сервере. Так как же это работает?

Прежде чем вы сможете увидеть своего бота на своих (или других) серверах, вам необходимо добавить его, создав и используя уникальную ссылку для приглашения с использованием идентификатора клиента вашего бот-приложения.

Ссылки для приглашения бота

Базовая версия одной такой ссылки выглядит так:

  https://discord.com/oauth3/authorize?client_id=12345678
  • 45678&scope=bot+applications.commands

    • 1

    Структура URL-адреса довольно проста:

    • Первая часть — это просто стандартная структура Discord для авторизации приложения OAuth3 (например, вашего приложения-бота) для входа на сервер Discord.
    • Вторая часть, в которой указано client_id =... — указать , какое приложение вы хотите авторизовать. Вам нужно будет заменить эту часть идентификатором вашего клиента, чтобы создать действительную ссылку для приглашения.
    • Наконец, третья часть, в которой говорится, что scope = bot + applications.commands , указывает, что вы хотите добавить это приложение в качестве бота Discord с возможностью создания команд косой черты.

    СОВЕТ

    Параметр разрешений также существует, чтобы ограничить или гарантировать разрешение вашего бота на сервере, на который вы его добавляете.Для удобства использования рекомендуется использовать этот веб-сайт «Открыть в новом окне».

    ПРЕДУПРЕЖДЕНИЕ

    Если вы получаете сообщение об ошибке «Бот требует предоставления кода», перейдите в настройки вашего приложения и отключите параметр «Требовать предоставления кода OAuth3». Обычно вам не следует устанавливать этот флажок, если вы не знаете, зачем вам это нужно.

    Создание и использование вашей ссылки для приглашения

    Как упоминалось выше, вам необходимо заменить параметр client_id на идентификатор вашего клиента, чтобы сгенерировать ссылку для приглашения.Чтобы узнать идентификатор своего приложения, вернитесь на страницу «Мои приложения» в новом окне в разделе «Приложения» еще раз и щелкните свое приложение-бот.

    Вставьте идентификатор своего приложения в шаблон ссылки, а затем откройте его в своем браузере. Вы должны увидеть что-то вроде этого (с именем пользователя и аватаром вашего бота):

    Выберите сервер, на который вы хотите добавить его, и нажмите «Авторизовать». Обратите внимание, что вам понадобится разрешение «Управление сервером» на сервере, чтобы добавить туда своего бота. После этого вы увидите красивое подтверждающее сообщение:

    Поздравляем! Вы успешно добавили своего бота на свой сервер Discord.Он должен отображаться в списке участников вашего сервера примерно так:

    Доступ преподавателей и студентов к Dr. Chat Bot

    Все преподаватели / сотрудники и студенты: Требуется , чтобы проходить ежедневное обследование состояния здоровья Dr. Chat Bot перед тем, как явиться в университет. Скрининг, который занимает всего несколько секунд, помогает выявить преподавателей / сотрудников и студентов с симптомами COVID-19 до того, как они прибудут в кампус, и дает инструкции о самокарантине и о том, с кем связаться, если указан самокарантин.Преподаватели / сотрудники и студенты, у которых появляются симптомы, сообщите об этом сотрудникам службы здравоохранения (585-275-6040) и как можно быстрее покидают кампус.

    Преподаватели / сотрудники, если у вас нет доступа к Интернету для прохождения проверки Dr. Chat Bot до прибытия в университетский городок, вам следует заранее договориться со своим менеджером о ее завершении сразу по прибытии на работу.

    Студенты, если у вас нет доступа в Интернет для прохождения проверки Dr. Chat Bot до прибытия в кампус, используйте следующие методы:

    • Приложение URMobile и использование сотовой связи.
    • Используйте приложение URMobile сразу после прибытия в кампус.

    Чтобы получить доступ к инструменту проверки Dr. Chat Bot:

    Преподаватели, сотрудники и все студенты немедицинского центра должны использовать: Dr. Chat Bot

    • Преподаватели / сотрудники должны ввести учетные данные, используемые для входа на свой рабочий компьютер или электронную почту;
    • Студенты должны ввести учетные данные, которые они используют для университетской беспроводной сети (UR Connected).

    Сотрудники Медицинского центра использовали отдельную ссылку для доступа к Dr.Chat Bot и должен продолжить этот процесс.

    Любой, кто не знает своих учетных данных, посещает сайт IT My Identity Service.

    • Войдите в систему с помощью NetID.
      Если вы забыли пароль,
      • Нажмите [ Забыли пароль? ] для вашей учетной записи Active Directory UR]
      • Если вам нужна дополнительная помощь, позвоните в ИТ-отдел университета по телефону 275-2000.

    Приложение UR Mobile также содержит инструмент Dr. Chat Bot.Новичкам следует открыть приложение UR Mobile, подождать несколько секунд, пока в нижней части экрана не появится черный баннер «Доступны новые настройки», а затем нажать, чтобы обновить.

    Получил https://healthlab.urmc.rochester.edu/UniversityHealthScreen . Введите имя пользователя и пароль Active Directory и выберите Тип учетной записи (UR или URMC).

    1. Выберите подходящий ответ внизу экрана. Если выбрано Нет , появятся эти экраны.
    2. Подтвердите выбранный ответ.
    3. Получить сообщение подтверждения.
    4. Выберите подходящий ответ внизу экрана. Если выбрано Да , появятся эти экраны.
    5. Если вы получили сообщение, указанное ниже, следуйте приведенным ниже инструкциям.
    6. Закройте браузер

    Часто задаваемые вопросы — Dr Chat Bot
    • Какие учетные данные я использую для входа в систему?
      • Учетная запись UR или URMC Active Directory
    • Что делать, если я забыл свой пароль?
    • Нужно ли мне находиться в сети кампуса?
      • Нет (веб-сайт выходит в Интернет)
    • Что произойдет, если я скажу да —
      • Он спросит, какие симптомы вы чувствуете.В зависимости от последующих вопросов он может направить вас к Службе здравоохранения (585-275-6040)
    • К кому мне обратиться за помощью? —

    Чат-бот — Создание приложения

    Информация о приложении

    Здесь вы вводите краткое и длинное описание своего приложения и обновляете имя, которое вы только что дали своему приложению. Обратите внимание, что это уникальное имя приложения будет видно, даже если ваше приложение не опубликовано.

    После установки чат-бот отправит пользователю сообщение, содержащее имя и краткое описание приложения.Краткое описание должно включать краткий пример или начальные инструкции по использованию вашего чат-бота.

    Это также хорошее время для загрузки необходимого значка приложения . Значок должен быть квадратным изображением шириной и высотой от 160 до 400 пикселей в формате GIF / JPG / JPEG / PNG и не может быть больше 1 МБ.

    Предварительный просмотр изображений предоставляет пользователям визуальные детали вашего приложения с помощью изображений и видео. Здесь вы можете показать основные функции и варианты использования вашего приложения, используя снимки экрана с подсказками и результатами чата.Поддерживаются только изображения JPG / GIF / JPEG / PNG и видео MP4. Максимальный размер видео — 10 МБ. Изображения должны быть размером 1200 на 780 пикселей.

    Категории позволяют систематизировать и классифицировать ваше приложение вместе с аналогичными приложениями и упростить пользователям поиск и поиск вашего приложения. Здесь вы можете выбрать до трех категорий для своего приложения.

    Название вашей компании будет открыто отображаться на главной странице Marketplace и на странице сведений о вашем приложении.

    Затем добавьте Контактное лицо разработчика , имя и адрес электронной почты, которые могут использоваться командой Zoom Marketplace или вашими пользователями для любых запросов относительно вашего приложения.

    Примечание. НЕ принимаются домены поставщика услуг электронной почты, например: @ gmail.com или @ outlook.com . Отправленный адрес электронной почты должен быть действующим доменом и рабочим адресом электронной почты, который команда Zoom Marketplace может подтвердить в процессе проверки.

    Добавьте ссылки для доступа пользователей к страницам вашей Политики конфиденциальности и Support , которые требуются для утверждения. Вы также можете предоставить ссылки на страницы Documentation и Configure , которые, хотя и не требуются, могут иметь важное значение для работы ваших пользователей с вашим приложением.

    .

    Добавить комментарий

    Ваш адрес email не будет опубликован. Обязательные поля помечены *