コネクタを Office コネクタ開発者ダッシュボードに登録する

重要

Office 365 Teams 内のコネクタは間もなく廃止される予定です。 ワークフロー アプリは、よりスケーラビリティとセキュリティを備えた同様の機能を提供します。 詳細については、「Microsoft Teams内のOffice 365 コネクタの廃止」を参照してください。 コネクタ開発者ポータルでの新しいコネクタの登録は無効になっています。

アプリケーション用の Office コネクタの構築は簡単です。 必要なのは、開発者ポータルでコネクタを登録し、統合された構成エクスペリエンスをアプリケーションに追加し、コネクタを実装するだけです。 カタログに発行することで、ユーザーがコネクタを簡単に見つけられるようにすることができます。

独自のコネクタを構築する

コネクタの登録

コネクタ開発者ポータルにアクセスし、Microsoft 365 資格情報でサインインします。 Microsoft 365 テナントをお持ちでない場合は、 Microsoft 365 開発者プログラムを通じてテナントの資格を得る可能性があります。詳細については、 FAQ を参照してください。 または、 1 か月間の無料試用版にサインアップするか、Microsoft 365 プランを購入することもできます。

[新しいコネクタ] を選択して、フォームにデータを入力します。 [保存] を選択すると、ページに新しいオプションが表示されます。

• [Outlook にサイドロード] ボタンによって、コネクタが、ログオン中のユーザーの Outlook の機能に一時的に追加されます。 ユーザーは、受信トレイまたは属している任意のグループのいずれかでコネクタを構成できるようになります。
• [ストアに発行] ボタンを使用すると、ストアに一覧表示するための Microsoft によるレビューを含む発行プロセスが開始されます。

統合された構成機能を追加する

統合された構成機能を使用すると、ユーザーは Outlook から離れることなく、コネクタを構成できます。 アプリケーションでは、構成の状態を Outlook に伝えるために Microsoft Teams JavaScript ライブラリを活用する Web ページとして構成を公開します。

詳細については、「構成機能を統合する」を参照してください。

注:

「構成機能を統合する」ドキュメントは、Microsoft Teams 固有のものですが、記載されている方法は Outlook でも同様に機能します。

Outlook 固有の構成要件

構成機能に認証が必要な場合、Windows 版 Outlook で認証フローを有効にするための追加の要件があります。

Windows 版 Outlook は、追加のクエリ パラメーターをコネクタの認証スタート ページに渡します。

callbackUrl=<connectors url>

認証が完了した後、アプリでこの値を保持し、追加のパラメーターとして microsoftTeams.authentication.notifySuccess または microsoftTeams.authentication.notifyFailure メソッドに渡す必要があります。

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

コネクタをストアに発行する

コネクタを徹底的にテストし、Office コネクタ カタログに一覧表示する準備ができたら、[ ストアに発行 ] ボタンを使用してレビュー用に送信できます。 確認と承認が完了すると、コネクタがコネクタ カタログに追加されます。

コネクタ提出のチェックリスト

• ストアに提出する前に、コネクタが完全に機能し、徹底的にテストされていることを確認してください。
• ユーザーがコネクタ カードを使用するさまざまなクライアント (Outlook on the Web、Outlook 2016 以降、および Outlook Groups のモバイル アプリ) で、コネクタ カードをテストします。
• テキスト修飾に限定して Markdown を使用していること、およびコネクタ カード ペイロードで HTML を送信しないことを確認してください。
• 値の追加と過剰なノイズ生成とのバランスを維持します。 通知が多すぎるためにユーザーが対応に苦慮していないことを確認してください。
• コネクタ カードを送信する対象の適切なイベントを識別します。 グループに送信する情報がグループのメンバーにとって有益であることを確認してください。
• レポートまたは概要の送信時は、ダイジェスト形式を使用して、ユーザーがレポートの時刻と頻度を選択できるようにします。
• コネクタ カードの送信時は、カードの重要な部分を強調表示するために Markdown を最大限に活用します。
• 可能な限り、関連するアクションを提供することにより、コネクタ カードを操作可能にします。
• 呼び出されるアクションは、障害発生率が極めて低く、エンドポイントからの応答が速い必要があります。
• ユーザーが構成を一時停止または削除するための規定があることを確認してください。
• コネクタが提供する機能について、わかりやすいユーザー向けのドキュメントを用意してください。
• コネクタを登録するとき:
  • コネクタの名前とロゴが他の製品やサービスの商標や著作権を侵害していないことを確認してください。
  • サイズが 60 KB 未満であり、種類が jpg、jpeg、png、gif の高品質のロゴを提供します。
  • アプリケーションの簡潔な説明を提供します (例: 「Contoso ヘルプ デスクは企業と顧客を引き合わせます」)。
  • コネクタの詳細な説明を提供します (例: 「Contoso ヘルプ デスク コネクタは、顧客のチケットのアクティビティについて Office 365 グループに通知します」)。
• コネクタをストアに発行するとき:
  • 詳細な手順を入力し、コネクタをテストできるようにテスト アカウント情報を共有してください。

次の手順

• 質問がある場合、サポートが必要な場合、コードで問題が発生している場合は、Microsoft Q&A の開発者コミュニティにお問い合わせください。
• スタック オーバーフローに質問や問題を投稿することもできます。 関連するテクノロジに基づいて、以下のように質問にタグを付けます。
  • REST API: microsoftgraph または outlook-rest-api
  • アドイン: outlook-web-addins
  • アクション可能メッセージまたは Outlook コネクタ: office365connectors
• 機能の提案がある場合は、Microsoft 365 Developer Platform Ideas フォーラムにアイデアを投稿し、提案に投票してください。