> 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/en/conversations/team-plus.md).

# Integrate with Platform: Team+

Team+ is an enterprise messaging platform. Once integrated, employees can chat with the AI Assistant directly within Team+, without needing to open any other system.

{% hint style="warning" %}
Team+ integration currently **only supports one-on-one conversations**. Adding the AI Assistant to a group chat will not get a reply, and no conversation record will be kept in MaiAgent. If you need group conversations, use a different chat platform instead.
{% endhint %}

## Before You Integrate <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

* You've already created an "AI Assistant" on the [MaiAgent platform](https://admin.maiagent.ai/)
* You have admin access to the Team+ service channel (able to access that channel's "Feature Settings")
* You've confirmed with your Team+ vendor contact whether your organization uses the test environment or the production environment

{% hint style="warning" %}
**Credentials cannot be modified after the channel is created.** Obtain all three credentials before proceeding to step two.
{% endhint %}

***

## Step 1: Enable the API and Get Credentials in the Team+ Admin Panel <a href="#step-enable-api-in-teamplus" id="step-enable-api-in-teamplus"></a>

Log in to the Team+ admin panel, and go to <mark style="color:blue;">Service Channels</mark> → select the channel you manage → <mark style="color:blue;">Feature Settings</mark> → <mark style="color:blue;">API Settings</mark>, then **enable the API**.

Once enabled, obtain the following three items on the same page:

| Credential               | Description                                                                   |
| ------------------------ | ----------------------------------------------------------------------------- |
| **Channel ID**           | The identifier for this service channel                                       |
| **Channel Secret**       | Used to verify that messages sent from Team+ genuinely come from your channel |
| **Channel Access Token** | Used by MaiAgent to call the Team+ API when sending replies                   |

{% hint style="info" %}
Skip the Webhook field for now. It requires a Webhook URL generated by MaiAgent, which we'll come back to fill in during **Step 3**.
{% endhint %}

***

## Step 2: Create a Team+ Chat Platform in MaiAgent <a href="#step-create-channel-in-maiagent" id="step-create-channel-in-maiagent"></a>

### 1. Go to Integrate Chat Platform <a href="#step-go-to-channel-integration" id="step-go-to-channel-integration"></a>

Click <mark style="color:blue;">Chat Platforms</mark> in the left menu of MaiAgent, click <mark style="color:blue;">Integrate Chat Platform</mark> in the top right, and select <mark style="color:blue;">Team+</mark>.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-9557e30aa762671728de3ff2fa7aa9c167365a68%2Fteamplus-choose-channel.png?alt=media" alt="Team+ on the Choose an Integration Platform page"><figcaption><p>Select Team+ from the platform list</p></figcaption></figure>

### 2. Fill in the Basic Settings <a href="#step-fill-basic-settings" id="step-fill-basic-settings"></a>

| Field                            | Description                                                                       |
| -------------------------------- | --------------------------------------------------------------------------------- |
| **Name**                         | Give this integration a name (required). This is just a label on MaiAgent's side. |
| **AI Assistant**                 | Select the AI Assistant to bind to it                                             |
| **Channel ID**                   | Obtained in Step 1 (required)                                                     |
| **Channel Secret**               | Obtained in Step 1 (required)                                                     |
| **Channel Access Token**         | Obtained in Step 1 (required)                                                     |
| **Team+ Service URL (optional)** | See the explanation below                                                         |

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-1e29c7657eb7312df002c39f446d3f50672a2e45%2Fteamplus-create-form.png?alt=media" alt="MaiAgent&#x27;s Team+ creation form, including the three credentials, service URL, and the skip certificate security check option"><figcaption><p>Team+ creation form (example values shown)</p></figcaption></figure>

### 3. When You Need to Fill in the "Team+ Service URL" <a href="#when-to-set-api-base-url" id="when-to-set-api-base-url"></a>

* **Leave it blank** — Uses the test environment. For general testing scenarios, leaving it blank is fine.
* **Enter a URL** — Your organization uses the production environment, or Team+ is deployed on your own server. Get the URL from your Team+ vendor contact; it must be a full URL starting with `http://` or `https://`.

### 4. Skip Certificate Security Check <a href="#trust-insecure-tls" id="trust-insecure-tls"></a>

The <mark style="color:blue;">Skip Certificate Security Check</mark> option only appears on the form **after you fill in the "Team+ Service URL."**

Some organizations' servers have an incomplete TLS certificate configuration (e.g. missing an intermediate certificate), which causes standard connection validation to fail and prevents MaiAgent from connecting to Team+. Enabling this option skips validation so the integration can work.

{% hint style="danger" %}
Enabling this **reduces the security of the connection** to the Team+ server, as it can no longer confirm that the connection target is genuinely your server. Only enable it after confirming with the server administrator that "the certificate issue cannot be fixed," and turn it off again once the certificate is fixed.
{% endhint %}

### 5. Enable Reset Command <a href="#enable-reset-command" id="enable-reset-command"></a>

When enabled, you can customize a keyword; users who type that keyword in the conversation can clear the conversation memory and start over.

### 6. Feature Settings Tab <a href="#feature-settings-tab" id="feature-settings-tab"></a>

Switch to the <mark style="color:blue;">Feature Settings</mark> tab to adjust how the AI Assistant behaves on this chat platform:

The toggles on this tab (<mark style="color:blue;">Enable OCR</mark>, <mark style="color:blue;">Use System Time to Answer</mark>, <mark style="color:blue;">Use Sender Name to Answer</mark>) are shared with other chat platforms. For details about each toggle and the timezone rules, see [Feature Settings](/maiagent-user-guide/en/conversations/platform-settings/function-settings.md).

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-7c97c0209ae6644fd58d46bbe7d4e1ffe192c706%2Fteamplus-feature-settings.png?alt=media" alt="Team+&#x27;s Feature Settings tab, including Enable OCR and AI Awareness Settings"><figcaption><p>Feature Settings tab</p></figcaption></figure>

### 7. Test Connection <a href="#step-validate-credentials" id="step-validate-credentials"></a>

Click <mark style="color:blue;">Test Connection</mark>; MaiAgent will make an actual call to the Team+ API to confirm the credentials are correct.

If <mark style="color:red;">Credential Validation Failed</mark> is shown, check the following in order:

* Whether the Channel ID and Channel Secret come from the same service channel
* Whether the API is enabled in the Team+ admin panel
* If a service URL was entered, whether it's reachable from outside; if it's a certificate issue, refer to "Skip Certificate Security Check" above

### 8. Create and Copy the Webhook URL <a href="#step-save-and-get-webhook-url" id="step-save-and-get-webhook-url"></a>

Click <mark style="color:blue;">Integrate Chat Platform</mark> to finish creating it. The system will generate a **Webhook URL** — copy it for later use.

You can also return to this channel's settings page at any time to copy this URL again.

***

## Step 3: Go Back to the Team+ Admin Panel to Fill in the Webhook URL <a href="#step-configure-webhook" id="step-configure-webhook"></a>

Go back to the <mark style="color:blue;">API Settings</mark> page from Step 1, enter the **Webhook URL** generated by MaiAgent into the <mark style="color:blue;">Webhook</mark> field, and save.

Once done, when an employee sends a message to that service channel in Team+, the AI Assistant will reply automatically.

***

## Getting Started <a href="#getting-started" id="getting-started"></a>

### Supported Message Types <a href="#supported-message-types" id="supported-message-types"></a>

| User sends                     | How the AI Assistant handles it                      |
| ------------------------------ | ---------------------------------------------------- |
| Text                           | Answers directly                                     |
| Image                          | Can recognize the image content                      |
| Files (PDF, Excel, Word, etc.) | Reads the content and answers related questions      |
| Voice message                  | Converted to text before processing                  |
| Video                          | Saved as an attachment, recorded in the conversation |
| Location                       | Recorded in the conversation                         |

The AI Assistant's replies support text and attachments. If a single text message exceeds Team+'s 4,000-character limit, the system automatically splits it into multiple messages — it won't be truncated.

***

## FAQ <a href="#faq" id="faq"></a>

### Why doesn't the AI Assistant respond in group chats? <a href="#no-group-support" id="no-group-support"></a>

Team+ integration currently only handles one-on-one conversations. Messages in group chats won't trigger a reply, and won't appear in MaiAgent's "All Conversations" either.

This differs from platforms like LINE WORKS, Slack, and Microsoft Teams — those platforms support groups and let you configure "only reply when @ mentioned."

### Why can't credentials be modified? <a href="#why-credentials-are-immutable" id="why-credentials-are-immutable"></a>

Credentials are sensitive data. Once saved, MaiAgent never sends them back to the frontend, and the settings page doesn't accept edits either, to avoid re-exposing credentials in transit or on screen. The Channel ID is shown read-only, so you can verify which service channel is currently connected.

If you need to change any credential, delete this channel and recreate it.

### The AI Assistant suddenly stopped replying <a href="#troubleshoot-no-reply" id="troubleshoot-no-reply"></a>

Check the following in order:

* Whether the API is still enabled in the Team+ admin panel
* Whether the URL in the Webhook field is still there (it may have been cleared when settings were changed in the admin panel)
* Whether the Channel Access Token has been regenerated in the Team+ admin panel — if so, the old token is now invalid, and you'll need to delete this channel and recreate it with the new credentials
* If you're using your own server, whether the server is still reachable from outside

### Can the test and production environments coexist? <a href="#test-and-production" id="test-and-production"></a>

Yes. Create two Team+ chat platforms and enter the respective credentials and service URLs for each. Each has its own independent Webhook URL, and they don't affect each other.


---

# 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/en/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.