Работа ботом: Телеграм Боты 1491 чат-ботов в Telegram 2020 «Работа»

Общий интерфейс бота

Создание бота для Microsoft Teams — Команды

• 11.06.2020
• 10 минут на чтение

В этой статье

Для создания диалогового бота вам потребуется выполнить следующие шаги:

1. Подготовьте среду разработки.
2. Создайте свой веб-сервис.
3. Зарегистрируйте свою веб-службу в качестве бота в Microsoft Bot Framework.
4. Создайте манифест приложения и пакет приложения.
5. Загрузите свой пакет в Microsoft Teams.

Создание веб-службы, регистрация веб-службы и создание пакета приложения с помощью Bot Framework можно выполнять в любом порядке; однако, поскольку эти три части настолько взаимосвязаны, независимо от того, в каком порядке вы их делаете, вам нужно будет вернуться, чтобы обновить другие.Для вашей регистрации требуется конечная точка обмена сообщениями из развернутой веб-службы, а для вашей веб-службы требуются идентификатор и пароль, созданные при регистрации. Вашему манифесту приложения также необходим регистрационный идентификатор для подключения Teams к вашей веб-службе.

По мере создания бота вы будете регулярно переключаться между изменением манифеста приложения и развертыванием кода в веб-службе. При работе с манифестом приложения помните, что вы можете либо вручную манипулировать файлом JSON, либо вносить изменения через App Studio.В любом случае вам нужно будет повторно развернуть (загрузить) свое приложение в Teams, когда вы внесете изменения в манифест; однако в этом нет необходимости при развертывании изменений в веб-службе.

См. Документацию по Bot Framework для получения дополнительной информации о Bot Framework.

Подготовьте среду разработки

Первое, что вам нужно сделать, это подготовить среду разработки. Вам необходимо убедиться, что выгрузка пользовательских приложений включена для организации Office 365, в которой вы хотите создать свое приложение.Если вам нужен выделенный клиент для разработки, вы можете зарегистрироваться в программе для разработчиков Office 365. Дополнительные сведения см. В разделе Настройка среды разработки.

Создайте свой веб-сервис

Сердце вашего бота — ваш веб-сервис. Он будет определять один маршрут, обычно / api / messages , по которому будут приниматься все запросы. Для начала у вас есть несколько вариантов на выбор:

• Начните с примера бота диалога Teams на C # / dotnet или JavaScript.
• Если вы используете JavaScript, используйте Yeoman Generator для Microsoft Teams, чтобы сформировать приложение Teams, включая веб-службу. Это особенно полезно при создании приложения Teams, которое содержит больше, чем просто диалогового бота.
• Создайте свой веб-сервис с нуля. Вы можете добавить SDK Bot Framework для своего языка или работать напрямую с полезными нагрузками JSON.

Зарегистрируйте свой веб-сервис в Bot Framework

Важно

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

Регистрация вашей веб-службы в Bot Framework обеспечивает безопасный канал связи между клиентом Teams и вашей веб-службой. Клиент Teams и ваш веб-сервис никогда не взаимодействуют напрямую. Вместо этого сообщения маршрутизируются через службу Bot Framework (Microsoft Teams использует отдельный экземпляр этой службы, совместимый со стандартами Office 365).

У вас есть два варианта регистрации веб-службы в Bot Framework. Вы можете использовать либо App Studio, либо устаревший портал, чтобы зарегистрировать своего бота без подписки Azure. Или, если у вас уже есть подписка Azure (или вы не против ее создать), вы можете использовать портал Azure для регистрации своей веб-службы.

Без подписки Azure

Если вы не хотите регистрировать своего бота в Azure, вы должны , использовать либо эту ссылку — https: // dev.botframework.com/bots/new или App Studio. Если вы нажмете кнопку Create a bot на портале Bot Framework, вы создадите регистрацию бота в Microsoft Azure, и вам потребуется предоставить подписку Azure. Чтобы управлять своей регистрацией или перенести ее в подписку Azure после создания, перейдите по адресу: https://dev.botframework.com/bots.

Когда вы редактируете свойства существующей регистрации Bot Framework, не зарегистрированной в Azure, вы увидите столбец «Состояние миграции» и синюю кнопку «Перенести», которая приведет вас на портал Microsoft Azure.Не нажимайте кнопку «Перенести», если вы этого не хотите. Вместо этого выберите имя бота, и вы можете редактировать его свойства:

Сценарии, когда должен иметь регистрацию бота в Azure (либо путем создания его на портале Azure, либо путем миграции):

• Вы хотите использовать OAuthPrompt Bot Framework для аутентификации.
• Вы хотите включить дополнительные каналы, такие как веб-чат, прямая линия или Skype.

Использование App Studio

App Studio — это приложение Teams, которое помогает создавать приложения Teams, включая регистрацию веб-службы в качестве бота, создание манифеста приложения и пакета приложения, а также обновление параметров и конфигураций.Он также содержит библиотеку элементов управления React и настраиваемые образцы для карточек. См. Раздел Начало работы с Teams App Studio.

Помните, что если вы используете App Studio для регистрации своей веб-службы, вам необходимо перейти на https://dev.botframework.com/bots, чтобы управлять своей регистрацией.

В устаревшем портале

Создайте регистрацию бота по этой ссылке: https://dev.botframework.com/bots/new. Не забудьте добавить Microsoft Teams в качестве канала из списка рекомендуемых каналов после создания бота. Не стесняйтесь повторно использовать любой созданный вами идентификатор приложения Microsoft, если вы уже создали пакет / манифест приложения.

с подпиской Azure

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

1. На портале Azure в разделе «Службы Azure» выберите Создать ресурс .

2. В поле поиска введите «бот». И в выпадающем списке выберите Регистрация каналов бота .

3. Нажмите кнопку Создать .

4. В колонке Регистрация канала бота введите запрашиваемую информацию о своем боте.

5. Оставьте поле Конечная точка обмена сообщениями пока пустым, вы введете требуемый URL-адрес после развертывания бота. На следующем рисунке показан пример настроек регистрации:

6. Щелкните Идентификатор приложения Microsoft и пароль , а затем Создать новый .

7. Щелкните Создать идентификатор приложения на портале регистрации приложений .

8. В открывшемся окне Регистрация приложения щелкните вкладку Новая регистрация в левом верхнем углу.

9. Введите имя бот-приложения, которое вы регистрируете, мы использовали BotTeamsAuth (нужно выбрать собственное уникальное имя).

10. Для поддерживаемых типов учетных записей выберите учетные записи в любом каталоге организации (Любой каталог Azure AD — Многопользовательский) и личные учетные записи Microsoft (e.грамм. Skype, Xbox) .

11. Нажмите кнопку Register . После завершения Azure отобразит страницу Обзор для приложения.

12. Скопируйте и сохраните в файл значение Application (client) ID .

13. На левой панели щелкните Сертификат и секреты .

    1. В разделе Секреты клиента щелкните Новый секрет клиента .
    2. Добавьте описание, чтобы идентифицировать этот секрет от других, которые вам, возможно, потребуется создать для этого приложения.
    3. Установить Срок действия на ваш выбор.
    4. Щелкните Добавить .
    5. Скопируйте секрет клиента и сохраните его в файл.

14. Вернитесь в окно Регистрация канала бота и скопируйте App ID и Client secret в поля Microsoft App ID и Password , соответственно.

15. Щелкните ОК .

16. Наконец, нажмите Create .

После того, как Azure создаст ресурс регистрации, он будет включен в список группы ресурсов.

После создания регистрации каналов ботов вам необходимо включить канал Teams.

1. На портале Azure в разделе Службы Azure выберите только что созданный канал Bot Channel Registration .
2. На левой панели щелкните Каналы .
3. Щелкните значок Microsoft Teams, затем выберите Сохранить .

Портал Bot Framework оптимизирован для регистрации ботов в Microsoft Azure. Вот что нужно знать:

• Канал Microsoft Teams для ботов, зарегистрированных в Azure, — бесплатно . Сообщения, отправленные по каналу Teams, НЕ будут учитываться в качестве использованных сообщений для бота.
• Если вы регистрируете своего бота с помощью Microsoft Azure, код вашего бота не обязательно должен быть , размещенным на в Microsoft Azure.
• Если вы регистрируете бота с помощью портала Microsoft Azure, у вас должна быть учетная запись Microsoft Azure.Вы можете создать его бесплатно. Чтобы подтвердить свою личность при создании учетной записи Azure, вы должны предоставить кредитную карту, но с нее не будет взиматься плата; всегда бесплатно создавать и использовать ботов с Microsoft Teams.

Создайте манифест приложения и пакет

Манифест вашего приложения определяет метаданные для вашего приложения, точки расширения, которые использует ваше приложение, и указатели на веб-службы, к которым подключаются эти точки расширения. Вы можете использовать App Studio для создания манифеста приложения или создать его вручную.

Добавить с помощью App Studio

1. В клиенте Teams откройте App Studio из переполненного меню … на левой панели навигации. Если App Studio еще не установлена, вы можете сделать это, выполнив поиск.
2. На вкладке редактора манифеста выберите Создать новое приложение (или, если вы добавляете бота в существующее приложение, вы можете импортировать свой пакет приложения)
3. Добавьте сведения о своем приложении (полное описание каждого поля см. В определении схемы манифеста).
4. На вкладке Bots нажмите кнопку Setup .
5. Вы можете создать новую регистрацию веб-службы ( Новый бот ) или, если вы уже зарегистрировали ее, выбрать Существующий бот .
6. Выберите возможности и области, которые потребуются вашему боту.
7. При необходимости обновите адрес конечной точки вашего бота, чтобы он указывал на вашего бота. Он должен выглядеть примерно так: https://someplace.com/api/messages .
8. При желании добавьте команды бота.
9. При желании вы можете загрузить готовый пакет приложения с вкладки Test и распространить .

Создать вручную

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

При желании вы можете определить один или несколько списков команд, которые бот может рекомендовать пользователям. Объект представляет собой массив (максимум 2 элемента) со всеми элементами типа объект . Вы должны определить отдельный список команд для каждой области, которую поддерживает ваш бот. См. Меню ботов для получения дополнительной информации.

Пример простого манифеста

Пример ниже представляет собой простой объект-бот с двумя определенными списками команд.Это не весь файл манифеста приложения, а только часть, относящаяся к расширениям обмена сообщениями.

  ...
  "боты": [
    {
      "botId": "% MICROSOFT-APP-ID-ЗАРЕГИСТРИРОВАННО-С-BOT-FRAMEWORK%",
      "needsChannelSelector": ложь,
      "isNotificationOnly": ложь,
      "области": ["командный", "личный", "групповой чат"],
      "supportsFiles": правда,
      "commandLists": [
        {
          "области": ["команда", "групповой чат"],
          "команды": [
            {
              "title": "Команда 1",
              "description": "Описание команды 1"
            },
            {
              "title": "Команда N",
              "description": "Описание команды N"
            }
          ]
        },
        {
          "области": ["личный", "групповой чат"],
          "команды": [
            {
              "title": "Персональная команда 1",
              "description": "Описание Персональной команды 1"
            },
            {
              "title": "Персональная команда N",
              "description": "Описание Персональной команды N"
            }
          ]
        }
      ]
    }
  ],
...
  

Создайте пакет приложения вручную

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

Загрузите свой пакет в Microsoft Teams

Примечание

Для успешной загрузки бота администратор клиента должен сначала разрешить загрузку сторонних или пользовательских приложений в Teams.

Если вы использовали App Studio, вы можете установить свое приложение из Test и распространить вкладку редактора манифеста . Кроме того, вы можете установить пакет приложения, щелкнув меню переполнения ... на левой панели навигации, нажав Другие приложения , а затем ссылку Загрузить пользовательское приложение . Вы также можете импортировать манифест приложения или пакет приложения в App Studio, чтобы внести дополнительные обновления перед загрузкой.

Следующие шаги

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

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

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

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

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

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

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

• Создание собственных инструментов .Бот может предоставлять вам оповещения, прогнозы погоды, переводы, форматирование или другие услуги.
  Бот 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. Бонусы для ботов

  / команда  

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

  / start @ TriviaBot
/ start @ ApocalypseBot  

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

  / начало PAYLOAD  

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

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

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

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