Управление соединителями Microsoft 365 и пользовательскими соединителями

Важно!

Соединители Microsoft 365 (ранее называемые соединителями Office 365) скоро устареют, и создание новых соединителей Microsoft 365 будет заблокировано в ближайшее время. Дополнительные сведения о графике устаревания и о том, как приложение "Рабочие процессы" обеспечивает более гибкий и безопасный интерфейс, см. в статье Прекращение использования соединителей Microsoft 365 в Microsoft Teams.

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

Дополнительные сведения о триггере получения запроса веб-перехватчика Teams см. в разделе Microsoft Teams — webhook.

Если вы уже создали соединители Office 365:

Известные проблемы

  • Приложение workflows может публиковать как бот потока в общих каналах. Поддержка публикации в качестве бота потока в частных каналах находится в разработке. Рабочие процессы в настоящее время могут публиковать сообщения от имени пользователя.
  • Рабочие процессы поддерживают как адаптивные карточки, так и формат карточки сообщений (отрисовка кнопок не поддерживается). Вы можете преобразовать карточки сообщений в адаптивную карточку. Узнайте, как преобразовать сообщение соединителя карта формат в адаптивную карточку.

Ограничения

Рабочие процессы связаны только с определенными пользователями (которые называются владельцами рабочего процесса), а не с командой Или каналом Teams. Рабочие процессы могут стать потерянными потоками при отсутствии владельца, если совладельцы не назначены. Чтобы обеспечить непрерывность бизнес-процесса, автоматизированного потоком, администраторы могут добавить одного или нескольких совладельцев и предоставить им полный контроль над рабочим процессом. Они также могут добавить проверку подлинности для подключений (если таковые имеются) и включить поток, если он был отключен. Дополнительные сведения см. в разделе Управление потерянными потоками.

Соединители в Microsoft Teams доставляют содержимое и обновления служб непосредственно из сторонних служб в канал Teams. С помощью соединителей пользователи могут получать обновления из популярных служб, таких как Azure DevOps Services, Trello, Wunderlist, GitHub и т. д. Соединители публикуют эти обновления непосредственно в потоке чата. Эта функция позволяет всем участникам команды оставаться в состоянии синхронизации и быстро получать соответствующую информацию.

Teams и группы Microsoft 365 используют соединители. Одни и те же соединители можно использовать в Teams и Microsoft Exchange.

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

Важно!

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

URL-адрес соединителей обновления

Примечание.

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

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

Это изменение необходимо только для соединителей на основе веб-перехватчиков, таких как входящие веб-перехватчики и соединители сторонних производителей. Изменение не требуется для опроса соединителей, таких как RSS. Необходимо обновить URL-адрес соединителя, чтобы продолжить отправку уведомлений в Teams после 31 декабря 2024 г.

Совет

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

Чтобы обновить URL-адрес, выполните следующие действия.

  1. Перейдите на вкладку Публикации в канале Teams, выберите Открыть сведения о канале, выберите Управление каналом, выберите Изменить в разделе Соединители и выберите Пункт Настроено . Проверьте существующие подключения соединителя на этой странице.

    Снимок экрана: управление каналом. Снимок экрана: кнопка

    Снимок экрана: настроенный раздел для существующих подключений соединителя в команде.

  2. Обновите только те подключения, которые отображаются Attention required в параметре Управление .

    Снимок экрана: настроенные подключения в канале Teams, которым требуется внимание.

  3. Выполните одно из следующих действий.

    • Для соединителей, содержащих URL-адрес веб-перехватчика, выберите Управление и обновление URL-адреса.

      Снимок экрана: параметр для обновления URL-адреса веб-перехватчика.

      Примечание.

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

    • Для других типов соединителей удалите соединитель и повторно создайте конфигурацию соединителя.

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

    Снимок экрана: подтверждение после обновления URL-адреса.

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

Включение и отключение соединителей в Teams

Модуль Exchange Online PowerShell версии 2 использует современную проверку подлинности и работает с многофакторной проверкой подлинности (MFA) для подключения ко всем связанным с Exchange средам PowerShell в Microsoft 365. Администраторы могут использовать Exchange Online PowerShell для отключения соединителей для всей организации или определенного почтового ящика группы. Если соединитель отключен, он влияет на всех пользователей в этой организации или почтовом ящике. Невозможно отключить соединитель для нескольких конкретных пользователей.

Примечание.

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

Параметр организации переопределяет параметр группы. Например, если администратор включает соединители для группы и отключает те же соединители для организации, соединители для группы отключаются. Чтобы включить соединитель в Teams, подключитесь к Exchange Online PowerShell, используя современную проверку подлинности с MFA или без нее.

Чтобы включить или отключить соединитель, выполните следующие команды в Microsoft Exchange Online PowerShell:

  1. Откройте PowerShell от имени администратора.

  2. Используйте команду Import-Module ExchangeOnlineManagement для импорта модуля Microsoft Exchange.

  3. Чтобы отключить соединители в организации, используйте команду Set-OrganizationConfig -ConnectorsEnabled:$false.

  4. Чтобы подключить учетную запись администратора, используйте команду Connect-ExchangeOnline -UserPrincipalName UPN -ExchangeEnvironmentName O365USGovGCCHigh. Замените UPN именем участника-пользователя.

  5. Чтобы включить соединители для Teams, используйте следующие команды. Чтобы отключить соединители или сообщения с действиями, присвойте значение false вместо true в следующих командах.

    • Set-OrganizationConfig -ConnectorsEnabled:$true
    • Set-OrganizationConfig -ConnectorsEnabledForTeams:$true
    • Set-OrganizationConfig -ConnectorsActionableMessagesEnabled:$true

Дополнительные сведения об обмене модулями PowerShell см. в разделе Set-OrganizationConfig. Чтобы включить или отключить соединители Outlook, подключите приложения к группам в Microsoft Outlook. Дополнительные сведения о имени участника-пользователя (UPN) см. в статье Имя участника-пользователя в Microsoft 365.

Примечание.

Распространение этих изменений занимает до 24 часов.

Публикация соединителей для организации

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

Важно!

Пользовательские соединители недоступны в средах Government Community Cloud (GCC), Government Community Cloud-High (GCCH) и Министерства обороны (DOD). Этот раздел относится только к ранее опубликованным соединителям. Вы можете продолжать управлять существующими настраиваемыми соединителями и использовать их до тех пор, пока функция не будет выведена из эксплуатации. Чтобы использовать соединители в команде или канале, откройте меню "Дополнительные параметры" в правом верхнем углу канала. В меню выберите Соединители, а затем укажите или найдите нужный соединитель. При необходимости настройте выбранный соединитель.

Снимок экрана: добавление соединителей в канал в Teams из параметра

Использование соединителей в GCC или GCCH

Примечание.

Использование соединителей в средах GCC и GCCH поддерживается только для существующих конфигураций до прекращения использования этой функции.

Соединители по умолчанию отключены в средах Сообщества облака для государственных организаций (GCC) и Сообщества государственных организаций Cloud-High (GCCH). Чтобы разрешить пользователям использовать соединители в средах GCC или GCCH, выполните следующие действия.

  1. Необходимо включить соединители в Teams.

  2. Чтобы задать параметры, подключитесь к Exchange Online PowerShell.

  3. Чтобы использовать входящий веб-перехватчик в Teams, создайте пользовательское приложение, используя следующий код manifest.json. Чтобы использовать значки в пользовательском приложении, следуйте рекомендациям по созданию значков приложений.

    {
      "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
      "manifestVersion": "1.5",
      "id": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
      "version": "1.0.0",
      "packageName": "com.incomingwebhook.microsoft",
      "developer": {
        "name": "Microsoft Corporation",
        "websiteUrl": "https://go.microsoft.com/fwlink/?linkid=837668",
        "privacyUrl": "https://privacy.microsoft.com/privacystatement",
        "termsOfUseUrl": "https://www.microsoft.com/servicesagreement"
      },
      "description": {
        "full": "The Incoming Webhook connector enables external services to notify you about activities that you want to track.",
        "short": "Send data from a service to your Microsoft 365 group in real time. "
      },
      "icons": {
        "outline": "outline.png",
        "color": "color.png"
      },
      "connectors": [
        {
          "connectorId": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
          "scopes": ["team"]
        }
      ],
      "name": {
        "full": "Incoming Webhook",
        "short": "Incoming Webhook"
      },
      "accentColor": "#FFFFFF",
      "permissions": ["identity", "messageTeamMembers"]
    }
    
  4. Отправьте пользовательское приложение в Центр администрирования Teams.

Рекомендации по использованию соединителей в Teams

  • Соединители по умолчанию отключаются в средах облачного сообщества для государственных организаций (GCC) и Cloud-High сообщества государственных организаций (GCCH). Чтобы включить соединители, задайте ConnectorsEnabled для параметров или ConnectorsEnabledForTeams значение $true с помощью командлета SetOrganizationConfig . Чтобы задать параметры, подключитесь к Exchange Online PowerShell.

  • Если пользователь, добавивший соединитель в команду, покидает команду, соединитель продолжает работать.

  • Вы не можете настроить новые подключения для следующих соединителей:

    • Ага!
    • Airbrake
    • Aircall
    • Ссылки на приложения
    • AppSignal
    • Стебель фасоли
    • Bitbucket
    • Приятель
    • Buildkite
    • КОШКИ
    • Чатра
    • CircleCI
    • CodeShip
    • Постоянный контакт
    • Getresponse
    • Инспектор призраков
    • Groove
    • Heroku
    • Honeybadger
    • Домофон
    • Журналы
    • Mailchimp
    • Microsoft Forms
    • Opsgenie
    • PagerDuty
    • Бумажная трюма
    • Средство отслеживания сводных данных
    • Рэйгун
    • Runscope
    • SatisMeter
    • Семафор
    • Караул
    • Простой вход и выход
    • Стек Exchange
    • SUBVERSION
    • TestFairy
    • Travis CI
    • Trello
    • Uptodown
    • Userlike
    • Wrike
    • XP-Dev
    • Zendesk