HubSpot×Teams連携をマスターしたい/1.連携アプリのインストール

2024/08/16に公開

はじめに

HubSpotのTeams連携が過去にベータ機能で遊んでた頃よりいろいろと変わっててついていけてないお年頃なので、このタイミングでいろいろと試したいと思います。

今のところの記事一覧

この記事ではまずは連携アプリのインストールに挑戦します✊

📖参考記事
https://knowledge.hubspot.com/ja/integrations/connect-hubspot-and-microsoft-teams

前提条件

対応プラン

HubSpot×Teams連携は以下プランに対応しています:

  • HubSpot: 全てのプランで対応
  • Teams: 法人アカウントで対応(個人用のTeamsには対応していません)

その他条件

またナレッジベース記事を参照すると、次の条件もあるようです:

HubSpotアカウントに接続できるMicrosoft Teamsのインスタンスは1件に限定されています。
HubSpotの異なるデータセンター間で同一のMicrosoft Teamsアカウントをインストールすることはできません。

Microsoft Teams管理センターでの準備

インストールに入る前にTeamsの管理センターの方でHubSpotのアプリを許可されるように設定しておきます。

📝 Teams管理センターの権限を持っていない方は組織の管理者に依頼しましょう

<確認方法>

  1. Microsoft Teams管理センターにアクセスします
  2. ナビゲーション[Teamsのアプリ]>[アプリを管理]の画面にアクセス
  3. 画面右下の方にある検索窓で"hubspot"と検索
  4. [アプリの状態]が「許可済み」になっていることを確認
  5. 許可されていなかったら、[名前]列下のアプリ名をクリックし[許可済み]のトグルをONにします
  6. 次に、ナビゲーション[Teamsのアプリ]>[アクセス許可ポリシー]の画面にアクセス
  7. [グローバル(組織全体の既定値)]をクリック
  8. [サードパーティ製アプリ]の設定が[すべてのアプリを許可]or HubSpotのアプリが許可されている状態に設定されていることを確認

    HubSpotアプリのみを許可した場合

インストール種別

HubSpotのTeams連携アプリでは次の2つのインストール方法があります。

① 限定インストール
② フルインストール

それぞれのインストール方法で求められるアクセス範囲(許可する範囲)や権限が変わってきます。

こちらの記事を参照の上、適切な方法にてインストールしましょう

📍ワークフローでの連携機能(Teams通知の送信など)を使用するには、フルインストールにてインストールする必要があります

今回はどちらの方法もトライしてみます。

① 限定インストールの方法

まずは、①限定インストールの方法です。

  1. HubSpotにログインの上マーケットプレイスからMicrosoft Teamsの連携アプリのインストール画面にアクセス
  2. [アプリをインストール]をクリックして
  3. [限定インストール]を選び、[アプリをインストール]をクリックします
  4. Microsoftアカウントにログインの上、求められるアクセス範囲の許可を行います
  5. インストールが完了すると連携アプリの設定画面(HubSpot側の画面)に遷移します
  6. 画面内にある[アカウントを接続]をクリックします
  7. Microsoftアカウントでログインをすると、[接続済みアカウント]にマッピングされているHubSpotユーザ情報とMicrosoftアカウント情報が表示されます

    変更したい場合は[接続済みアカウントを編集]で変更が可能です
  8. またTeams側に連携がインストールされた旨の通知がbotから飛んできます

📍6~8の手順は連携を使用されるユーザ毎に操作する必要があります

② フルインストールの方法

次に、②フルインストールの方法です。

  1. HubSpotにログインの上マーケットプレイスからMicrosoft Teamsの連携アプリのインストール画面にアクセス
  2. [アプリをインストール]をクリックして
  3. [フルインストール]を選び、[アプリをインストール]をクリックします
  4. Microsoftアカウントにログインの上、求められるアクセス範囲の許可を行います
  5. インストールが完了すると連携アプリの設定画面(HubSpot側の画面)に遷移します
  6. 画面内にある[アカウントを接続]をクリックします
  7. HubSpotユーザと紐づけるTeamsのユーザアカウントを指定します。フルインストールの場合、Microsoftのアカウント認証はすでにインストール時にされているため限定インストールと少し画面が異なるようです
  8. Teams側の認証が求められたので、Teamsの画面に移動しHubSpotのbotメッセージから[確認]をクリックします

  9. 正常にインストールされた旨の通知を受け取れたら完了です

📍6~8の手順は連携を使用されるユーザ毎に操作する必要があります

アンインストールの方法

連携アプリのアンインストール方法についてはナレッジベースの方に記載がなかったため、補足します。

  1. まずは HubSpotの連携アプリ一覧画面からTeamsの設定画面にアクセスし、[アンインストール]をクリックします
  2. 「続行するには下に~」の下にあるテキストボックスに"アンインストール"と入力し、[アンインストール]ボタンをクリック

    入力しないとボタンがアクティブにならないです
  3. 気が向いたらフィードバックを送ってあげましょう(今回は検証目的なので一旦スキップ)
  4. 次に、Teams画面に移動し 左サイドの ... からHubSpotのアプリを検索して開きます
  5. 左サイドバーに開かれた[HubSpot]を右クリックし[アンインストール]をクリック
  6. 「削除しますか?」といったメッセージがでてくるので削除しますを選択。botから送られてきたチャット通知は気が向いたら消すのでいいかなと思います

これでアンインストールが完了します🚮

次回は

これで無事に連携アプリがインストールできました。次回はHubSpotにTeamsのチームを接続する方法を解説します(フルインストールの前提で実践します)👋


⭐ 書けました
https://zenn.dev/raynya/articles/9450d17f325ea7

Discussion