Добавление чат-бота в Microsoft Teams из приложения Teams

Выберите версию Power Virtual Agents, которую вы используете, здесь:

После того, как вы создали бота, вы захотите, чтобы люди использовали его.

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

Пользователь может:

  • Настройте внешний вид вашего бота в Microsoft Teams.
  • Установите бота для себя в Microsoft Teams.
  • Поделитесь ссылкой для установки бота с другими пользователями.
  • Отобразите бота в магазине приложений Microsoft Teams.
    • Покажите бота своим товарищам по команде или пользователям с общим доступом, добавив его в магазин приложений Microsoft Teams в раздел Создано коллегами.
    • Покажите бота своей организации, отправив бота на утверждение администратором, чтобы он был размещен в магазине приложений Microsoft Teams в разделе Создано вашей организацией.
  • Добавьте бота в канал команды.
  • Загрузите предварительно созданный манифест приложения Teams, чтобы распространить его в своем клиенте Microsoft Teams.

Предварительные условия

Настройте внешний вид бота в Microsoft Teams

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

  1. Перейдите на вкладку Опубликовать на боковой панели и выберите Сделать доступным для других.

  2. Выберите Изменить сведения для изменения значка, цвета и описания бота. Они будут показаны в магазине приложений Microsoft Teams и на вкладку «О приложении» после того, как пользователь установит его. Ознакомьтесь с рекомендациями по форматам значков Microsoft Teams.

    Вы можете изменить значок, цвет фона и описания.

    Важно!

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

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

  3. Выберите Дополнительно для добавления дополнительной информации:

    • Имя разработчика
    • Веб-сайт
    • Заявление о конфиденциальности
    • Условия использования

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

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

Примечание

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

Вы можете настроить аватар бота в разделе Настройка внешнего вида бота.

Значок аватара бота в чате Teams.

Установите бота как приложение в Microsoft Teams

После того, как вы опубликовали бота, вы можете добавить его в свою версию Microsoft Teams прямо из приложения Power Virtual Agents.

Важно!

Новый контент в недавно опубликованном боте не будет отображаться в текущих разговорах. Через 30 минут простоя бот обновится.

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

Вам следует добавить своего бота в свою версию Teams, прежде чем поделиться им с другими.

  1. Перейдите на вкладку Чат-бот.

    Вкладка чат-бота находится на верхней панели.

  2. Откройте бота, которого хотите добавить.

  3. В боковой области выберите Опубликовать.

  4. Выберите Открыть бота, чтобы запустить запрос установки в Microsoft Teams. Выберите Добавить, чтобы добавить как приложение в Teams. Бот будет установлен только для вас.

    Откройте бота со страницы публикации.

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которым вы хотите поделиться.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

    Сделайте бота доступным для других со страницы публикации

  5. Выберите Параметры доступности и выберите Копировать ссылку.

    Важно!

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

    Скопируйте ссылку из параметров доступности Teams.

  6. Поделитесь скопированной ссылкой с пользователями, чтобы установить бота в Microsoft Teams.

Отобразите бота в магазине приложений Microsoft Teams

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

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

Вы можете поделиться своим ботом, добавив его в магазин приложений Microsoft Teams, раздел Создано для вашей организации > Создано коллегами. Только ваши коллеги по команде и пользователи с общим доступом увидят там бота.

Важно!

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

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

Раздел Создано коллегами находится внизу раздела Создано для вашей организации в магазине приложений Teams.

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которого хотите показать в магазине приложений Microsoft Teams.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Параметры доступности.

  6. Выберите Показывать моим коллегам и пользователям, которым предоставлен доступ и проверьте, у кого есть доступ к боту.

    Показать бота в магазине приложений Teams в разделе Создано коллегами.

  7. Убедитесь, что выбрано Показывать в разделе "Создано коллегами" и выберите Поделиться.

    Установите флажок Создано коллегами в пользовательском интерфейсе общего доступа.

  8. Это автоматически добавит бота в раздел Создано коллегами, будет отображаться зеленая метка Добавлено в Teams на странице параметров доступности.

Всплывающее меню показывает, что бот добавлен в Teams.

Примечание

Если ваше приложение не отображается в разделе Создано коллегами, ваше приложение Teams может кэшировать информацию.

Попробуйте выйти и снова войти (если вы используете настольное приложение) или обновить страницу в браузере (если вы используете веб-приложение Teams).

Удаление бота из раздела "Создано коллегами"

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

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которого вы хотите удалить.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Параметры доступности.

  6. Выберите флажки Показывать моим коллегам и пользователям, которым предоставлен доступ и Показывать в разделе "Создано коллегами".

    Снимите флажок Создано коллегами в пользовательском интерфейсе общего доступа.

  7. Выберите Предоставить общий доступ. Теперь бот больше не будет отображаться в магазине приложений Microsoft Teams в разделе Создано коллегами.

Показать организации

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

Раздел Создано вашей организацией находится вверху раздела Создано для вашей организации в магазине приложений Teams.

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

Перед отправкой бота в вашу организацию убедитесь, что:

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

Примечание

После утверждения бота администратором его доступность в разделе Создано вашей организацией будет полностью управляться вашим администратором. Только администратор может удалить бота из раздела Создано вашей организацией.

Отправьте заявку для раздела "Создано вашей организацией"

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которого вы хотите отправить.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Параметры доступности.

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

  7. Выберите Показывать всем в моей организации.

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

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

    Примечание

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

    После утверждения все новые и существующие пользователи бота в Teams получат обновление.

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

  9. Появится окончательное подтверждение. Щелкните Да, чтобы продолжить. Бот будет отправлен вашему администратору для утверждения, и вы увидите примечание с состоянием вашей отправки.

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

    Примечание

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

    Иначе пользователи в организации не смогут общаться с ботом после его установки из магазина приложений Microsoft Teams в разделе Создано вашей организацией.

    Работайте со своим администратором и политикой приложения Microsoft Teams для тех, кто может найти и установить бота.

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

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

  12. Или же обратитесь к администратору, чтобы предварительно закрепить или установить приложение для пользователей с политикой приложения Microsoft Teams, чтобы они могли найти бота прямо в своем списке приложений Microsoft Teams.

Примечание

Если ваше приложение не отображается в разделе Создано вашей организацией, даже если есть состояние Утверждено, ваше приложение Teams может кэшировать информацию.

Попробуйте выйти и снова войти (если вы используете классическое приложение) или обновить страницу в браузере (если вы используете веб-приложение Teams).

Добавить бота в рабочую группу

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

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

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

Добавить бота в команду, в которой он создан

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

Чтобы добавить бота в команду, в которой он создан:

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которого нужно добавить в команду.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Параметры доступности.

  6. Выберите Добавить в {название команды}.

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

  7. Выберите Добавить, чтобы добавить бота в команду.

Разрешить пользователям добавлять ботов в свои команды

Этот параметр позволяет пользователям добавлять бота в любую команду, частью которой они являются, при добавлении бота в Microsoft Teams.

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

Важно!

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

Чтобы разрешить пользователям добавлять бота в рабочую группу:

  1. Перейдите на вкладку Чат-бот.

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

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Изменить сведения.

  6. Выберите Разрешить пользователям добавлять этого бота в рабочую группу.

    Флажок установлен, чтобы разрешить пользователю добавлять бота в команды, частью которых он является

  7. Выберите Сохранить.

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

Если вы ранее отправили бота на одобрение администратора, вам нужно будет отправить повторно после включения этого параметра. Администратор должен одобрить эти изменения, прежде чем пользователи смогут добавить бота в свои команды из магазина приложений Microsoft Teams в разделе «Создано вашей организацией».

Запретить пользователям добавлять бота в команду

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

Чтобы запретить пользователям добавлять бота в команду:

  1. Перейдите на вкладку Чат-бот.

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

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Изменить сведения.

  6. Снимите флажок Разрешить пользователям добавлять этого бота в рабочую группу.

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

  7. Выберите Сохранить.

Настройка поведения личного приветствия

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

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

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

Чтобы настроить, когда бот отправляет личное приветствие:

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которого требуется изменить.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Параметры.

    Точка входа в настройки для настройки поведения личного приветствия бота

  6. Настройте параметры личного приветствия.

    Параметры личного приветствия пользователя

  7. Выберите Сохранить.

Загрузите манифест приложения Teams бота (дополнительно)

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

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которого вы хотите загрузить.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Параметры доступности.

  6. Выберите Загрузить ZIP.

    Загрузите ZIP-файл манифеста приложения Teams из параметров доступности панели Teams.

  7. Манифест будет создан как файл ZIP и сохранен в соответствии с настройками сохранения вашего браузера.

Удалить бота из боковой панели

Вы можете удалить бота из списка приложений, если больше не хотите его использовать. Это не удаляет бота из приложения Power Virtual Agents, это просто означает, что вы не можете общаться с ботом в Microsoft Teams.

  1. Щелкните правой кнопкой мыши значок приложения бота.

  2. Выберите Удалить, а затем выберите Удалить.

    Удаление бота.

Отключение своего бота от Teams

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

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

Для ботов, одобренных администратором, они по-прежнему будут отображаться в магазине приложений Microsoft Teams в разделе Создано вашей организацией. Вам нужно будет связаться со своим администратором, чтобы удалить бота.

  1. Перейдите на вкладку Чат-бот.

  2. Откройте бота, которого вы хотите отключить.

  3. В боковой области выберите Опубликовать.

  4. Выберите Сделать бота доступным для других пользователей.

  5. Выберите Отключить бота от Teams.

    Отключите канал Teams на панели каналов Teams.

  6. Просмотрите информацию об отключении вашего бота и выберите Отключить, чтобы продолжить.

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

Известные ограничения

  • В настоящее время только области Личный и Рабочая группа поддерживаются для Microsoft Teams. Групповой чат не поддерживается.
  • Установка значка аватара бота на боковой панели в Управление > Сведения не будет отображаться для ботов, одобренных администратором. Боты, одобренные администратором, будут использовать значок приложения в качестве аватара бота.
  • Teams имеют ограничение скорости для ботов. В зависимости от потребностей вашего бизнеса, вы, возможно, захотите, чтобы содержимое вашего бота было кратким для ботов, добавляемых в Microsoft Teams.
  • Отключение вашего бота может занять несколько минут, прежде чем бот станет недоступен для пользователей Microsoft Teams.