Microsoft Teams通知

FyneDeskはチケット通知をMicrosoft Teamsに直接投稿できます。チケットが作成、割り当て、返信されたとき、またはステータスや優先度が変わったとき、選択したTeamsチャネルにカードが表示されます。チケット番号、タイトル、主要な詳細、そしてチケットを開くFyneDeskで開くボタンが付いています。ProプランとBusinessプランに含まれています。

設計上、通知専用です ボットがTeamsのメッセージを読むことは決してなく、誰もTeamsからチケットを作成・変更できません。カードを投稿するだけです。カードは組織のメール言語(English、Deutsch、Español、Português)に従います。Teamsの中からチケットを作成する機能は、現在開発中の別機能です。

必要なもの

  • カスタムアプリをアップロードできるMicrosoft Teams管理者。FyneDeskがTeamsアプリストアに掲載されるまでは、アプリはカスタムアプリをアップロードでインストールされます。これは組織のTeams管理者ポリシーで許可されている必要があります。
  • チャネルをリンクし、機能をオンにするFyneDesk管理者。管理者が有効にするまで、連携は組織でオフになっています。

ステップ1 — FyneDesk Teamsアプリパッケージをダウンロードする

アプリは小さな.zipファイル(マニフェストとアイコン)として提供されます。FyneDesk管理者がFyneDesk内からダウンロードします:設定 → 接続 → Microsoft Teamsに移動し、Teamsアプリパッケージ(.zip)をダウンロードをクリックします。

FyneDesk内からのみ パッケージはFyneDeskアカウントからのみ入手可能で、公開ダウンロードはありません。これは意図的なものです。Teamsにアップロードするアプリが本物の最新FyneDeskパッケージであることを保証します。他のどこかから誰かがFyneDesk Teamsの.zipを送ってきても、アップロードせず、設定から自分自身のコピーをダウンロードしてください。(Teamsアプリストアへの掲載も進行中です。)

ステップ2 — Teamsにインストールする

Microsoft TeamsでApps → Manage your apps → Upload an app → Upload a custom appに移動し、受け取った.zipを選択します。

「Upload a custom app」が見つからない、またはグレーアウトしている? Microsoft管理者がカスタムアプリのアップロードを許可する必要があります(Teams管理センター → Teams apps → Setup policies)。または、管理者が組織全体にアプリをアップロードすることもできます。

ステップ3 — ボットをチャネルに追加する

インストール中にAdd to a teamを選び、通知を受け取るべきチャネルを選択します。(アプリのオプションから後でチームに追加することもできます。)

ステップ4 — ボットがワンタイムコードを投稿する

参加した直後、ボットはそのチャネルにワンタイムのリンクコードを投稿します。XXXX-XXXXのような形式で、7日間有効です。このコードは、FyneDeskがリンクが正当であることを検証する方法です。チャネルを見られる人だけが使用できます。

ステップ5 — FyneDeskでチャネルをリンクする

FyneDesk管理者が設定 → 接続 → Microsoft Teamsに移動し、コードを貼り付けてチャネルをリンクをクリックします。チャネルがリンク済みの会話の下に表示されます。

ステップ6 — マスタースイッチをオンにする

同じページでマスタースイッチをオンにします。管理者が有効にするまで組織への通知はオフで、それまでTeamsには何も投稿されません。

ステップ7 — ルーティングを選ぶ

各イベントタイプ(新しいチケットチケットの割り当て新しい返信ステータス変更優先度変更)について、カードを受け取るべきチャネルを選ぶか、そのイベントについて静かにしておくにはチャネルなしを選びます。

近日公開 SLA違反と期限のカードは間もなく提供されます。提供された際には、同じルーティングリストに表示されます。

ステップ8 — テストする

FyneDeskでテストチケットを作成します。カードは数秒以内に選択したチャネルに届くはずで、チケットを開くFyneDeskで開くボタンが付いています。

任意 — 担当者への個人DM

チケットが割り当てられたエージェントは、チャネル投稿の代わりに、または加えて、ボットから個人(1対1)メッセージを受け取れます。

  • エージェントが同じアプリをTeamsに個人としてインストールします(Add for me)。
  • FyneDeskは業務用メールでエージェントを照合します。TeamsアカウントのメールがそのエージェントのFyneDeskログインメールと同じである必要があります。
  • イベントで担当者にDMにチェックを入れると、チケットの割り当て先に個人カードが届きます。

チャネルを追加する

Teamsで別のチャネルにボットを追加します。組織がリンクされると、同じMicrosoftテナント内の新しいチャネルは自動的に接続され、リンク済みの会話リストに表示されるだけです。ボットは実際に必要な場合にのみ新しいコードを投稿します。

オフにする

  • 1つのチャネルについて:Teamsでそのチャネルからボットを削除します。FyneDeskは気付いて、自動的にそこへのルーティングを停止します。
  • すべてについて:設定 → 接続 → Microsoft Teamsのマスタースイッチが、何もアンインストールせずにすべてのTeams通知を即座に静かにします。

FAQ

「Microsoftでサインイン」ではなくコードなのはなぜですか?

コードは、リンクする人がTeamsチャネルFyneDeskワークスペースの両方を実際に管理していることを証明します。ボットがチャネル内にそれを投稿するため、そのチャネルを読める人だけがリンクを完了でき、他の誰かが貴社のTeamsを乗っ取るのを防ぎます。

ボットは何を見られますか?

会話の中身は何も見えません。カードを投稿するだけです。明示的に追加されたチャネルと、個人インストールの場合はユーザーの名前と業務用メール(担当者の照合のみに使用)を把握します。

どの言語ですか?

カードは組織のメール言語設定(設定 → メール)に従います:English、Deutsch、Español、Português。

費用はいくらですか?

Microsoft Teams通知はProプランとBusinessプランに含まれています。追加のアドオン料金はありません。

Webhook + Power Automateのセットアップはどうなりますか?

その方法も引き続き使えます。FyneDesk通知をMicrosoft Teamsに送る(webhook)をご覧ください。ただしチャネル通知については、このネイティブボットの方がシンプルな道です。構築するフローがなく、カードはフォーマット済み・ローカライズ済みで届きます。

今後予定

SLA違反と期限のカードは近日公開予定です。Teamsの中からチケットを作成・更新する機能は、現在開発中の別のBusiness機能です。

トラブルシューティング

Teams通知が機能しない — よくある解決策

テストチケットの後にカードが届かない。設定 → 接続 → Microsoft Teamsでマスタースイッチがオンになっていること、およびイベントタイプ(例:新しいチケット)がチャネルなしではなくチャネルにルーティングされていることを確認してください。

リンクコードの有効期限が切れた。コードは7日間有効です。チャネルからボットを削除して再度追加してください。新しいコードが投稿されます。

「Upload a custom app」がグレーアウトしている。Microsoft管理者がカスタムアプリのアップロードを許可する(Teams管理センター → Teams apps → Setup policies)か、組織全体にアプリをアップロードする必要があります。

エージェントが個人DMを受け取れない。アプリを個人としてインストールし(Add for me)、TeamsアカウントのメールがそのエージェントのFyneDeskログインメールと正確に一致する必要があります。その上で、イベントで担当者にDMにチェックが入っていることを確認してください。

カードが誤った言語になっている。カードは各ユーザーのTeams言語ではなく、組織のメール言語(設定 → メール)に従います。