Зарегистрируйте ваш соединитель с помощью панели разработчиков соединителей Office

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

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

Регистрация соединителя

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

Выберите пункт New Connector (Создать соединитель) и заполните форму. После нажатия кнопки Save (Сохранить) новые параметры отобразятся на странице.

• Кнопка Sideload to Outlook (Загрузка неопубликованного соединителя в Outlook) временно добавит ваш соединитель в интерфейс Outlook для вошедшего в систему пользователя. Этот пользователь сможет настроить соединитель в своей папке "Входящие" или в любой группе, участником которой он является.
• Кнопка Publish to Store (Опубликовать в Магазине) запустит процесс публикации, в том числе проверку корпорацией Майкрософт на размещение в Магазине.

Добавление встроенного интерфейса настройки

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

Дополнительные сведения см. в статье Интеграция интерфейса настройки.

Требования к настройке, характерные для Outlook

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

Outlook для Windows передает дополнительный параметр запроса для начальной страницы проверки подлинности соединителей.

callbackUrl=<connectors url>

Ваше приложение должно сохранить это значение и передать его в виде дополнительного параметра для методов microsoftTeams.authentication.notifySuccess или microsoftTeams.authentication.notifyFailure после завершения проверки подлинности.

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

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

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

Контрольный список для отправки соединителя

• Перед отправкой в Store убедитесь, что ваш соединитель полностью функционален и тщательно протестирован.
• Проверьте карточки соединителей в различных клиентах, в которых пользователи будут их применять: Outlook в Интернете, Outlook 2016 и более поздних версиях и мобильных приложениях Outlook Groups.
• Убедитесь, что для оформления текста используется строго Markdown, а в полезные данные карточки соединителя не отправляется HTML.
• Придерживайтесь меры при добавлении возможностей, чтобы не перегрузить ими. Пользователь не должен увязнуть в слишком большом количестве уведомлений.
• Определите нужные события, для которых будут отправляться карточки соединителя. Убедитесь, что информация, оправляемая группе, полезна для ее членов.
• При отправке отчетов или сводок используйте формат дайджеста и позвольте пользователю выбрать время и частоту их получения.
• При отправке карточек соединителя для выделения их важных частей эффективно используйте Markdown.
• Обеспечьте возможность выполнять определенные действия в связи с карточками соединителя там, где это допустимо.
• Процент сбоев вызываемых действий должен быть очень низким, соответствующий отклик от конечной точки — быстрым.
• Предусмотрите для пользователей возможность приостановки или удаления конфигурации.
• Подготовьте понятную документацию для пользователей, описывающую возможности соединителей.
• При регистрации соединителя:
  • Убедитесь, что использование имени и логотипа вашего соединителя не нарушает авторские права или права на товарные знаки, связанные с другими продуктами или службами.
  • Предоставьте высококачественный логотип в формате JPG, JPEG, PNG или GIF размером не более 60 КБ.
  • Предоставьте краткое описание приложения (например, "Contoso Help Desk сближает компании и клиентов").
  • Предоставьте подробное описание соединителя (например, "Соединитель Contoso Help Desk уведомляет вашу группу Office 365 о действиях, связанных с запросами клиентов в службу поддержки").
• При публикации соединителя в Магазине:
  • Не забудьте предоставить пошаговые инструкции и сведения о тестовой учетной записи, чтобы мы могли протестировать соединитель.

Дальнейшие действия

• Если у вас возникли вопросы, проблема с кодом или вам нужна помощь, задайте вопрос сообществу разработчиков на сайте Microsoft Q&A.
• Вы также можете опубликовать свой вопрос или проблему на сайте Stack Overflow. Поставьте вопросу тег в соответствии со связанной технологией:
  • REST API: microsoftgraph или outlook-rest-api
  • Надстройки: outlook-web-addins
  • Сообщения с действиями или соединители Outlook: office365connectors
• Если вы хотите предложить функцию, опубликуйте свою идею на нашем форуме идей платформы разработчиков Microsoft 365 и проголосуйте за свое предложение.