> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/conversations/team-plus.md).

# 対話プラットフォーム連携：Team+

Team+ は企業向けコミュニケーションプラットフォームです。連携後、従業員は他のシステムを別途起動することなく、Team+ 内で直接 AI アシスタントと対話できます。

{% hint style="warning" %}
Team+ 連携は現在、**1対1の対話のみサポート**しています。AI アシスタントをグループチャットに追加しても返信は行われず、MaiAgent に対話記録も残りません。グループ対話が必要な場合は、他の対話プラットフォームをご利用ください。
{% endhint %}

## 連携前の確認事項 <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

* [MaiAgent プラットフォーム](https://admin.maiagent.ai/)上で「AI アシスタント」を作成済みであること
* Team+ サービスチャンネルの管理権限（該当チャンネルの「機能設定」にアクセス可能）を持っていること
* Team+ ベンダー担当者に、貴社が使用しているのがテスト環境か本番環境かを確認済みであること

{% hint style="warning" %}
**認証情報はチャンネル作成後に変更できません。** 手順二に進む前に、必ず3つの認証情報を取得してください。
{% endhint %}

***

## 手順一：Team+ 管理画面で API を有効化し、認証情報を取得する <a href="#step-enable-api-in-teamplus" id="step-enable-api-in-teamplus"></a>

Team+ 管理画面にログインし、<mark style="color:blue;">サービスチャンネル</mark> → 管理しているチャンネルを選択 → <mark style="color:blue;">機能設定</mark> → <mark style="color:blue;">API 設定</mark> の順に進み、**API を有効化**してください。

有効化後、同じページで以下の3項目を取得します。

| 認証情報                     | 説明                                                  |
| ------------------------ | --------------------------------------------------- |
| **チャンネル番号 / Channel ID** | このサービスチャンネルの識別子                                     |
| **Channel Secret**       | Team+ から送信されたメッセージが確かにご自身のチャンネルからのものであることを検証するために使用 |
| **Channel Access Token** | MaiAgent が Team+ API を呼び出して返信を送信する際に使用              |

{% hint style="info" %}
Webhook 欄はこの段階では一旦スキップしてください。MaiAgent が生成する Webhook URL が必要になるため、**手順三**で戻って入力します。
{% endhint %}

***

## 手順二：MaiAgent で Team+ 対話プラットフォームを作成する <a href="#step-create-channel-in-maiagent" id="step-create-channel-in-maiagent"></a>

### 1. 対話プラットフォーム連携画面に進む <a href="#step-go-to-channel-integration" id="step-go-to-channel-integration"></a>

MaiAgent の左側メニューで <mark style="color:blue;">対話プラットフォーム</mark> をクリックし、右上の <mark style="color:blue;">対話プラットフォーム連携</mark> をクリックして、<mark style="color:blue;">Team+</mark> を選択します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9557e30aa762671728de3ff2fa7aa9c167365a68%2Fteamplus-choose-channel.png?alt=media" alt="プラットフォーム連携選択画面での Team+"><figcaption><p>プラットフォーム一覧から Team+ を選択</p></figcaption></figure>

### 2. 基本設定を入力する <a href="#step-fill-basic-settings" id="step-fill-basic-settings"></a>

| 項目                       | 説明                                         |
| ------------------------ | ------------------------------------------ |
| **名前**                   | この連携の名前を付けます（必須）。これは MaiAgent 側のラベルにすぎません。 |
| **AI アシスタント**            | 紐付ける AI アシスタントを選択                          |
| **チャンネル番号 / Channel ID** | 手順一で取得（必須）                                 |
| **Channel Secret**       | 手順一で取得（必須）                                 |
| **Channel Access Token** | 手順一で取得（必須）                                 |
| **Team+ サービス URL（任意）**   | 下記の説明を参照                                   |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-1e29c7657eb7312df002c39f446d3f50672a2e45%2Fteamplus-create-form.png?alt=media" alt="3つの認証情報、サービス URL、証明書セキュリティチェックのスキップオプションを含む MaiAgent の Team+ 作成フォーム"><figcaption><p>Team+ 作成フォーム（図はサンプル値）</p></figcaption></figure>

### 3. 「Team+ サービス URL」の入力が必要なケース <a href="#when-to-set-api-base-url" id="when-to-set-api-base-url"></a>

* **空欄のまま** — テスト環境を使用します。一般的なテストシナリオでは空欄のままで問題ありません。
* **URL を入力** — 貴社が本番環境を使用している場合、または Team+ が自社サーバー上にデプロイされている場合です。URL は Team+ ベンダー担当者に確認してください。`http://` または `https://` で始まる完全な URL である必要があります。

### 4. 証明書セキュリティチェックのスキップ <a href="#trust-insecure-tls" id="trust-insecure-tls"></a>

**「Team+ サービス URL」を入力した後**にのみ、フォームに <mark style="color:blue;">証明書セキュリティチェックをスキップ</mark> というオプションが表示されます。

一部の組織のサーバーでは TLS 証明書の設定が不完全（例：中間証明書の欠落）であるため、標準の接続検証が失敗し、MaiAgent が Team+ に接続できないことがあります。このオプションを有効にすると検証をスキップして連携を機能させることができます。

{% hint style="danger" %}
有効にすると、Team+ サーバーとの**接続の安全性が低下**し、接続先が本当にご自身のサーバーであることを確認できなくなります。サーバー管理者に「証明書の問題が修正できない」ことを確認した場合にのみ有効にし、相手側が証明書を修正した後は必ず無効にしてください。
{% endhint %}

### 5. リセットコマンドを有効にする <a href="#enable-reset-command" id="enable-reset-command"></a>

有効にすると、キーワードをカスタマイズできます。ユーザーが対話中にそのキーワードを入力すると、対話の記憶がクリアされ、最初からやり直せます。

### 6. 機能設定タブ <a href="#feature-settings-tab" id="feature-settings-tab"></a>

<mark style="color:blue;">機能設定</mark> タブに切り替えると、この対話プラットフォームにおける AI アシスタントの動作を調整できます。

このタブのスイッチ（<mark style="color:blue;">OCR を有効にする</mark>、<mark style="color:blue;">システム時刻を使って回答する</mark>、<mark style="color:blue;">送信者名を使って回答する</mark>）は他の対話プラットフォームと共通です。各スイッチの説明とタイムゾーンのルールについては、[機能設定](/maiagent-user-guide/ja/conversations/platform-settings/function-settings.md)をご覧ください。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-7c97c0209ae6644fd58d46bbe7d4e1ffe192c706%2Fteamplus-feature-settings.png?alt=media" alt="OCR の有効化や AI 認識設定を含む Team+ の機能設定タブ"><figcaption><p>機能設定タブ</p></figcaption></figure>

### 7. 連携テスト <a href="#step-validate-credentials" id="step-validate-credentials"></a>

<mark style="color:blue;">連携テスト</mark> をクリックすると、MaiAgent が実際に Team+ API を1回呼び出し、認証情報が正しいことを確認します。

<mark style="color:red;">認証情報の検証に失敗</mark> と表示された場合は、以下を順に確認してください。

* チャンネル番号と Channel Secret が同一のサービスチャンネルのものであるか
* Team+ 管理画面で API が有効化されているか
* サービス URL を入力している場合、その URL が外部から接続可能か。証明書の問題であれば、上記の「証明書セキュリティチェックのスキップ」を参照

### 8. 作成して Webhook URL をコピーする <a href="#step-save-and-get-webhook-url" id="step-save-and-get-webhook-url"></a>

<mark style="color:blue;">対話プラットフォーム連携</mark> をクリックして作成を完了します。システムが **Webhook URL** を生成しますので、コピーして保存してください。

このチャンネルの設定画面にいつでも戻って、この URL を再度コピーすることもできます。

***

## 手順三：Team+ 管理画面に戻り、Webhook URL を入力する <a href="#step-configure-webhook" id="step-configure-webhook"></a>

手順一の <mark style="color:blue;">API 設定</mark> ページに戻り、MaiAgent が生成した **Webhook URL** を <mark style="color:blue;">Webhook</mark> 欄に入力して保存します。

完了後、従業員が Team+ でそのサービスチャンネルに話しかけると、AI アシスタントが自動で返信します。

***

## 利用を開始する <a href="#getting-started" id="getting-started"></a>

### 対応しているメッセージタイプ <a href="#supported-message-types" id="supported-message-types"></a>

| ユーザーの送信内容               | AI アシスタントの処理方法      |
| ----------------------- | ------------------- |
| テキスト                    | 直接回答                |
| 画像                      | 画像の内容を認識可能          |
| ファイル（PDF、Excel、Word など） | 内容を読み取ってから関連する質問に回答 |
| 音声メッセージ                 | テキストに変換してから処理       |
| 動画                      | 添付ファイルとして保存し、対話に記録  |
| 位置情報                    | 対話に記録               |

AI アシスタントの返信はテキストと添付ファイルに対応しています。1件のテキストメッセージが Team+ の上限である4,000文字を超える場合、システムが自動的に分割して送信するため、内容が途切れることはありません。

***

## よくある質問 <a href="#faq" id="faq"></a>

### なぜ AI アシスタントはグループチャットで反応しないのですか？ <a href="#no-group-support" id="no-group-support"></a>

Team+ 連携は現在、1対1の対話のみを処理します。グループチャットのメッセージは返信をトリガーせず、MaiAgent の「すべての対話」にも表示されません。

これは LINE WORKS、Slack、Microsoft Teams などのプラットフォームとは異なります。これらのプラットフォームはグループをサポートしており、「メンションされた場合のみ返信する」といった設定も可能です。

### なぜ認証情報は変更できないのですか？ <a href="#why-credentials-are-immutable" id="why-credentials-are-immutable"></a>

認証情報は機密データであるため、MaiAgent は保存後にフロントエンドへ再送信することはなく、設定画面での変更も受け付けません。これは、認証情報が送信時や画面表示時に重複して露出することを避けるためです。チャンネル番号は読み取り専用で表示され、現在どのサービスチャンネルと連携しているかを確認しやすくなっています。

いずれかの認証情報を変更する必要がある場合は、このチャンネルを削除してから再作成してください。

### AI アシスタントが突然返信しなくなった <a href="#troubleshoot-no-reply" id="troubleshoot-no-reply"></a>

以下を順に確認してください。

* Team+ 管理画面で API が引き続き有効になっているか
* Webhook 欄の URL がまだ残っているか（管理画面で設定を変更した際にクリアされることがあります）
* Channel Access Token が Team+ 管理画面で再生成されていないか — 再生成された場合、古いトークンは無効になるため、このチャンネルを削除して新しい認証情報で再作成する必要があります
* 自社サーバーを使用している場合、サーバーが引き続き外部から接続可能か

### テスト環境と本番環境は共存できますか？ <a href="#test-and-production" id="test-and-production"></a>

可能です。Team+ 対話プラットフォームを2つ作成し、それぞれに対応する認証情報とサービス URL を入力してください。両者は独立した Webhook URL を持ち、互いに影響しません。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/conversations/team-plus.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
