diff --git a/integrations/superoffice-for-teams/ai-summary.md b/integrations/superoffice-for-teams/ai-summary.md new file mode 100644 index 0000000000..bcba362796 --- /dev/null +++ b/integrations/superoffice-for-teams/ai-summary.md @@ -0,0 +1,31 @@ +--- +uid: teams-ai-summary +title: AI summaries in SuperOffice for Teams +description: How to generate and review an AI summary of a Teams conversation when archiving to SuperOffice. +keywords: SuperOffice for Teams, Teams, AI, summary, AI Labs +author: schildea +date: 07.05.2026 +content_type: howto +category: integration +topic: SuperOffice for Teams +language: en +--- + +# AI summaries in SuperOffice for Teams + +If your organization has [AI Labs][1] activated, you can ask SuperOffice for Teams to generate a summary of the conversation – so you (or a colleague) can quickly understand the outcome without reading every message. + +1. Click the checkbox **Generate Summary** in the archive window. +1. The **Create** button changes to **Preview** so you can review the summary first. +1. Edit the summary if needed. +1. Click **Create** to save. + +The summary is added to the **Description** field of the SuperOffice document. The full chat is still stored in the attached .EML file. + +Summaries currently use neutral, professional business language and are returned as a single block of text. + +> [!NOTE] +> If **Generate Summary** is unavailable, AI Labs is not activated for your SuperOffice tenant. Contact your SuperOffice administrator. + + +[1]: https://docs.superoffice.com/en/ai/learn/index.html \ No newline at end of file diff --git a/integrations/superoffice-for-teams/archive-conversation.md b/integrations/superoffice-for-teams/archive-conversation.md new file mode 100644 index 0000000000..287d0eb903 --- /dev/null +++ b/integrations/superoffice-for-teams/archive-conversation.md @@ -0,0 +1,81 @@ +--- +uid: teams-archive-conversation +title: Archive a Teams conversation +description: How to save Teams chat messages and channel conversations to SuperOffice. +keywords: SuperOffice for Teams, Teams, archive, save chat, conversation, messages +author: schildea +date: 07.05.2026 +content_type: howto +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Archive a Teams conversation + +Archiving works in chats and standard channels – refer to the [compatibility overview][1] to see exactly what's supported where. You can start archiving in two ways. Both open the same archive window, where you choose your scope and fill in the details needed to save the content to the correct place in SuperOffice. + +## Option A – Start from a specific message + +Use this when you want to capture a specific point in the conversation – a key decision, a handover, or (in a standard channel) a message with a file. + +1. Find the message in the chat or channel. +1. Right-click the message (or select the **...** menu). +1. Choose **SuperOffice for Teams**. +1. Click **Save Chat**. +1. Choose your scope: **This message**, **This and later**, or **Custom**. +1. Fill in the details to connect the archive to the correct record in SuperOffice (see below). +1. Click **Create**. + +![The right-click context menu on a Teams message, with the "SuperOffice for Teams" option highlighted -screenshot][img1] + +## Option B – Start from the compose bar + +Use this when you want to archive a range of messages – like Today, Yesterday, or the Last 7 days. + +1. Open the chat or channel. +1. Click the **+** (apps) icon in the compose area. +1. Search for and select **SuperOffice for Teams**. +1. Click **Save Chat** in the pop-up. +1. Pick a date range or choose **Custom** to select start and end dates. +1. Fill in the details to connect the archive to the correct record in SuperOffice (see below). +1. Click **Create**. + +> [!NOTE] +> Starting apps from the compose bar is blocked in direct chats with external users. You can still launch SuperOffice for Teams from the message menu if both users are managed by an organization. + +![The compose bar area with the "+" (apps) icon expanded, showing SuperOffice for Teams in the app picker -screenshot][img2] + +## Choosing what to include + +Before you save, you can decide what gets included. + +* **Include deleted message notices:** Adds a placeholder line where messages were removed. The original deleted content is not retrieved. +* **Include emoji reactions:** Captures reactions like thumbs up or heart alongside messages. Custom emojis are not supported. +* **Include files (attach to .EML):** Attaches files from the selected date range to the email file. This option is only available in standard channels. + +## Choosing where it goes in SuperOffice + +Whether you're saving a chat or a file, you'll fill in a few details so the archive lands in the correct place. + +* **Title:** Prefilled based on your selection, but you can change it. +* **Contact or Company:** SuperOffice will automatically pre-populate this field if it can match someone from the conversation to a contact in SuperOffice. If no match is found, pick a company or contact manually. You'll see recently used entries from SuperOffice, and you can search by name. Click the **Chat** icon to pick someone from the Teams conversation who also exists in SuperOffice. +* **Sale (optional):** Link the message or file to a sale. +* **Project (optional):** Link the message or file to a project. +* **Document template (Type):** Choose the document template your organization has set up for Teams conversations or files. +* **Completed:** Check this to mark the activity as completed in SuperOffice. If unchecked, it appears in your open activities. + +![The archive form showing title, contact, sale, project, template, and options fields -screenshot][img3] + +When you're ready, click **Create**. After a successful save, SuperOffice for Teams shows an **Open in SuperOffice** link so you can jump straight to the new document. + +![The successfully archived chat confirmation with the Open in SuperOffice button -screenshot][img4] + + +[1]: index.md + + +[img1]: media/teams-message-menu-sofo.png +[img2]: media/teams-compose-bar-picker.png +[img3]: media/teams-archive-form.png +[img4]: media/teams-archive-success.png \ No newline at end of file diff --git a/integrations/superoffice-for-teams/archive-file.md b/integrations/superoffice-for-teams/archive-file.md new file mode 100644 index 0000000000..5a760d596f --- /dev/null +++ b/integrations/superoffice-for-teams/archive-file.md @@ -0,0 +1,39 @@ +--- +uid: teams-archive-file +title: Save a file from a Teams channel +description: How to save a file from a standard Teams channel to SuperOffice. +keywords: SuperOffice for Teams, Teams, archive, file, channel, save file +author: schildea +date: 07.05.2026 +content_type: howto +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Save a file from a Teams channel + +When you're in a standard channel, you can also save a single file. How the file option becomes available depends on how you started the archive: + +* **Started from a message:** The Save File button is enabled if that specific message contains a file. +* **Started from the compose bar:** The Save File button is enabled if the channel contains any files. Use the file picker to select which files to archive. + +The file picker lists files found based on the above, each with a status icon: + +* **Green check:** Already archived to SuperOffice. Shows when and by whom. +* **File icon:** Not yet archived. Ready to save. +* **Red warning:** File is too large to archive. + + +The file picker is single-select – you can choose one file at a time. Saving a file with the same name always creates a new document in SuperOffice (overwriting is not supported yet). + +There is a file size limit of 94 MB. + +## Choosing where it goes in SuperOffice + +Whether you're saving a chat or a file, you'll fill in a few details so the archive lands in the correct place. See [Archive a conversation][1] for a full description of these fields. + + +[1]: archive-conversation.md + + diff --git a/integrations/superoffice-for-teams/deploy.md b/integrations/superoffice-for-teams/deploy.md new file mode 100644 index 0000000000..04060f4bd8 --- /dev/null +++ b/integrations/superoffice-for-teams/deploy.md @@ -0,0 +1,97 @@ +--- +uid: teams-deploy +title: Deploy SuperOffice for Teams +description: How to register your tenant, upload the app package, grant admin consent, and optionally push the app to users. +keywords: SuperOffice for Teams, Teams, deploy, admin, tenant registration, admin consent, setup policy +author: schildea +date: 07.05.2026 +content_type: howto +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Deploy SuperOffice for Teams + +These steps are done once per tenant by a Microsoft 365 or SuperOffice administrator. + +> [!TIP] +> Setting up for yourself only? [Go to the user guide][5]. + +## Step 1 – Register your tenant + +Before users can archive content to SuperOffice, an administrator must register the customer tenant in the SuperOffice for Teams portal. This step happens outside Teams and creates the tenant record the app needs. + +To register the tenant: + +1. Go to the SuperOffice for Teams portal: [https://superofficeforteams.superofficeapps.com][1] +1. Sign in with your SuperOffice account. +1. Select the tenant you want to register. +1. Accept the terms and privacy policy. +1. Save the settings. + +After saving, you will be redirected to the main page. Scroll down to download the Teams app package (.zip file). You will need this file in the next step when uploading the app in the Teams admin center during the pilot. + +![SuperOffice for Teams portal showing the Get Started section and Download Teams app button -screenshot][img1] + +## Step 2 – Upload the app in the Teams admin center + +During the pilot, the administrator uploads the SuperOffice for Teams app package as a .zip file in the Teams admin center. Once SuperOffice for Teams is published in Microsoft AppSource and the Teams app store, this manual upload step will no longer be needed. + +To upload the app during the pilot: + +1. Go to the Teams admin center: [https://admin.teams.microsoft.com/policies/manage-apps -screenshot][2] +1. Click **Actions** in the top right corner. +1. Select **Upload new app**. +1. Upload the SuperOffice for Teams app package (.zip file). + +## Step 3 – Grant admin consent + +After uploading the app, the administrator must grant admin consent in the Teams admin center. This allows SuperOffice for Teams to request the Microsoft permissions it needs to work on behalf of the signed-in user. + +To grant admin consent: + +1. Go to the Teams admin center. +1. Open **Teams apps > Manage apps**. +1. Find and open **SuperOffice for Teams**. +1. Go to the **Permissions** tab. +1. Click the **Grant admin consent** link in the information message. +1. Follow the Microsoft consent flow to approve the requested permissions. + +> [!NOTE] +> If admin consent is not granted at this stage, each individual user will need to request consent from the administrator when they first try to sign in. Granting consent during setup helps avoid extra approval steps for users later. + +## Step 4 (optional) – Push the app to users + +After completing steps 1 through 3, users can find and install SuperOffice for Teams themselves from the Teams app store. During the pilot, they will find it under **Built for your org**. After publication, they will be able to find it through the normal Teams app store flow. + +If you want the app to be ready for users without requiring them to install it themselves, you can push it to them through an app setup policy in the Teams admin center. + +> [!WARNING] +> When you push SuperOffice for Teams through an app setup policy, Teams sends a proactive welcome message from the SuperOffice for Teams bot to all users included in that policy. This means users may receive an unsolicited Teams message, such as "Hello [name]. Welcome to SuperOffice for Teams!", even if they have not opened the app themselves yet. + +To push the app to users: + +1. Go to the Teams admin center. +1. Open **Teams apps > Setup policies**. +1. Select an existing policy or create a new one. +1. Add **SuperOffice for Teams** under **Installed apps**. +1. Optional: Pin the app to the app bar so users can find it more easily. +1. Save and apply the policy to the relevant users. + +Keep in mind that apps installed this way are managed by the administrator. Users will not be able to remove the app themselves. Only an administrator can uninstall it or remove it from the setup policy. + +If you want users to stay in control of their own installation, skip this step and let them install the app themselves from **Built for your org** during the pilot. + +| Deployment method | Where users find the app | Users can uninstall | +|---|---|---| +| Admin uploads the app and grants consent only | Built for your org in the Teams app store | Yes | +| Admin also pushes the app through a setup policy | Added by your org in Manage your apps | No - an admin must remove it | + + +[1]: https://superofficeforteams.superofficeapps.com +[2]: https://admin.teams.microsoft.com/policies/manage-apps +[5]: get.md + + +[img1]: media/superoffice-for-teams-portal-download-app.png \ No newline at end of file diff --git a/integrations/superoffice-for-teams/get.md b/integrations/superoffice-for-teams/get.md new file mode 100644 index 0000000000..81c11c9b5b --- /dev/null +++ b/integrations/superoffice-for-teams/get.md @@ -0,0 +1,117 @@ +--- +uid: teams-get +title: Get SuperOffice for Teams +description: How to install SuperOffice for Teams, find the bot, and sign in as a user. +keywords: SuperOffice for Teams, Teams, install, sign in, bot, user +author: schildea +date: 07.05.2026 +content_type: howto +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Get SuperOffice for Teams + +## Install the app yourself + +If your admin has uploaded and approved SuperOffice for Teams but hasn't pushed it to you automatically, you can install it yourself. There are two things to set up: the app for your personal chats (which also gives you the bot for signing in) and the app for any standard channels where you want to archive messages and files. + +### Add SuperOffice for Teams from the app store + +1. In Teams, click **Apps** in the left sidebar. +1. Find SuperOffice for Teams under **Built for your org** (during the pilot) or by searching in the app store. +1. Click **Open**. +1. A dialog appears asking how you'd like to use the app. You have two options: + * Click **Open** to add the app to your personal scope – this sets up the bot chat and lets you use SuperOffice for Teams in your 1:1 and group chats. + * Select a **channel** from the list below to add the app to that channel – this lets you archive messages and files in that channel. +1. You'll see a welcome message from the bot. From here, you can sign in with SuperOffice for Teams to get started. + +You can come back to this dialog at any time to add SuperOffice for Teams to more channels. + +![SuperOffice for Teams app tile under Built for your organisation in the Teams app store -screenshot][img1] + +![SuperOffice for Teams app tile under Built for your organisation in the Teams app store -screenshot][img2] + +### Add SuperOffice for Teams to a channel later + +If you've already installed the app for your personal chats and want to add it to a channel afterward: + +1. Go to the channel where you want to use SuperOffice for Teams. +1. Click the **+** button or the channel name or in the channel header. +1. Select **Apps** from the menu. +1. Search for SuperOffice for Teams, or click **Get more apps** to find it. +1. Click the **Open** button on the app tile. +1. Select the channel and confirm by clicking the **Go** button. + +Once added, SuperOffice for Teams becomes available in the channel you previously selected. + +![SuperOffice for Teams dialog with a selected channel and Go button -screenshot][img3] + +## Already have the app? + +If your admin has pushed SuperOffice for Teams to you via a setup policy, you'll find it already installed – either in your app bar on the left or under **Added by your org** in Manage your apps. You don't need to do anything to install it. Just open it and sign in. + +## Uninstalling the app + +How you remove the app depends on how it was installed. + +If you installed it yourself from **Built for your org**, go to **Manage your apps** in Teams, find SuperOffice for Teams, and remove it from the **...** menu. + +If the app was pushed by your admin, you won't be able to remove it yourself. Teams will show a message saying you don't have permission. Contact your Microsoft 365 administrator if you have any questions. + +![Uninstall option for SuperOffice for Teams in the Teams app menu -screenshot][img4] + +## The SuperOffice for Teams bot and user sign-in + +SuperOffice for Teams uses a simple bot in Teams to help you sign in and out. It is not a general help chatbot. + +### Where to find the bot + +After the app is added, you can find SuperOffice for Teams from the **...** menu in the left app rail. Once you click it, you can pin it for easy access (right-click the icon and select **Pin**). Unpinning works the same way. + +![Pin option for the SuperOffice for Teams bot in the Teams app menu -screenshot][img5] + +You can also access the bot chat from your chat list. If you lose your bot chat, start a new conversation by selecting the **New message** icon and typing **teams** in the **To:** box. Then select **SuperOffice for Teams** from your contact list. + +As soon as the app is installed, the bot automatically opens a conversation and invites you to get started. You don't need to go looking for it – it comes to you. The welcome message reads: + +"Hello [your name]. Welcome to SuperOffice for Teams! You can use the buttons below to log in, or choose Help if you want to know more." + +## What the bot does + +The bot handles sign-in and sign-out only. It does not answer general "how do I?" questions. + +In the bot chat, you will see the available buttons, depending on your sign in status: + +* **Sign In:** Starts the SuperOffice sign-in flow. +* **Logout:** Signs you out of SuperOffice for Teams. +* **Help:** Shows a message with a link to the SuperOffice for Teams knowledge base and documentation. + +## Signing in + +You must be signed in before you can archive anything. + +Open **SuperOffice for Teams** from the left rail to start your bot chat, then select **Sign In**. + +Signing in is a two-step process: + +1. **Sign in with Microsoft** – This gives SuperOffice for Teams permission to read your Teams chats and channels on your behalf via Microsoft Graph. This is separate from your Teams session and is required for the app to function. +1. **Sign in with SuperOffice** – This connects your SuperOffice Online account, so the app knows where to save your archived content. + +Once both steps are complete, SuperOffice for Teams remembers your session, so you will not need to sign in again every time. + +## When you are not signed in + +If you try to use **SuperOffice for Teams** while signed out, you will see a message that you are not signed in. + +Select **Open Chat** to go to the **SuperOffice for Teams** bot, then select **Sign In**. + + + + +[img1]: media/teams-app-store-built-for-your-org.png +[img2]: media/teams-app-added-successfully-open-or-select-channel.png +[img3]: media/teams-select-channel-and-go-dialog.png +[img4]: media/teams-uninstall-superoffice-for-teams-app.png +[img5]: media/teams-pin-superoffice-for-teams-bot.png \ No newline at end of file diff --git a/integrations/superoffice-for-teams/includes/not-supported.md b/integrations/superoffice-for-teams/includes/not-supported.md new file mode 100644 index 0000000000..4f8f26af41 --- /dev/null +++ b/integrations/superoffice-for-teams/includes/not-supported.md @@ -0,0 +1,2 @@ +> [!NOTE] +> This feature is not supported in the current pilot. Share your feedback with SuperOffice if it is important to you. \ No newline at end of file diff --git a/integrations/superoffice-for-teams/index.md b/integrations/superoffice-for-teams/index.md new file mode 100644 index 0000000000..03ce8b6c5e --- /dev/null +++ b/integrations/superoffice-for-teams/index.md @@ -0,0 +1,79 @@ +--- +uid: teams-overview +title: SuperOffice for Teams +description: Save Microsoft Teams conversations and files straight into SuperOffice – so important customer chats don't get lost. +keywords: SuperOffice for Teams, Teams, Microsoft Teams, archive, chat, integration +author: schildea +date: 07.05.2026 +content_type: overview +category: integration +topic: SuperOffice for Teams +language: en +--- + +# SuperOffice for Teams + +Save your Microsoft Teams conversations and files straight into SuperOffice – so important customer chats don't get lost. + +## What is SuperOffice for Teams? + +SuperOffice for Teams connects your Microsoft Teams conversations with your CRM. Instead of searching through channels and chats to find what a customer said last week, you save the conversations and channel files to SuperOffice, right where it belongs. + +With SuperOffice for Teams, you can: + +* Save messages from chats and standard channels to SuperOffice. +* Save a single file from a message in a standard channel. +* Archive a date range of a chat, such as Today, Yesterday, Last 7 days, or a custom range. +* Optionally generate an AI summary so you can quickly catch the essence later in SuperOffice – without rereading the full chat. AI Labs must be activated to use this feature. + +Your conversations are stored as .EML files in SuperOffice, so they're easy to preview and share. + +## Who is it for? + +SuperOffice for Teams is for anyone who talks to customers or partners in Teams and wants that history visible in SuperOffice. This typically includes sales representatives, account managers, support teams, customer success teams, and project teams. + +## Where SuperOffice for Teams works – and where it doesn't + +Microsoft controls where Teams apps can run. SuperOffice for Teams works in chats between managed users and in standard channels. It does not work in private channels, shared channels, or in direct chats with unmanaged personal accounts. + +| Where you are | Who's in the conversation | Save message | Save files | Notes | +|---|---|---|---|---| +| 1:1 chat | Two managed users (both belong to an organization) | Yes | No | File attachments are not supported in chats. | +| Group chat | All managed users | Yes | No | If even one participant is external/unmanaged, app usage may be blocked by Teams. | +| Meeting chat | All managed users | Yes | No | Meeting chats behave like group chats. The same external-user restrictions apply. | +| Standard channel | Team members (including guests added to the team) | Yes | Yes | This is the only context where you can save files. External users must be added to the team as guests. | +| Private channel | Team members | No | No | Microsoft now supports this – not in current pilot. Share your feedback. | +| Shared channel | Team members | No | No | Microsoft now supports this – not in current pilot. Share your feedback. | +| 1:1 chat with unmanaged user | Managed user and an unmanaged user (@hotmail, @live, etc.) | No | No | Teams blocks app usage in direct chats with unmanaged accounts. | + +A **managed user** has a Teams account provided by an organization, such as anna@yourcompany.com. An **unmanaged user** has a personal account, such as anna@hotmail.com or anna@live.com. You can usually spot an unmanaged user by the "External" banner in Teams; hover over the banner for more information. + +A **guest** is an external user who has been invited to your team. Guests have a "Guest" banner next to their name. Because guests are formally invited through your organization's tenant, SuperOffice for Teams can work with them in standard channels. + +> [!NOTE] +> File archiving is only available in standard channels. SuperOffice for Teams disables file uploading and attaching in chat contexts. + +## Related topics + +* [Requirements][1] +* [Deploy SuperOffice for Teams (administrators)][2] +* [Get SuperOffice for Teams (users)][3] +* [Archive a conversation][4] +* [Save a file from a channel][5] +* [AI summaries][6] +* [Preferences][7] +* [Permissions and security][8] +* [Troubleshooting][9] +* [Known limitations][10] + + +[1]: requirements.md +[2]: deploy.md +[3]: get.md +[4]: archive-conversation.md +[5]: archive-file.md +[6]: ai-summary.md +[7]: preferences.md +[8]: security.md +[9]: troubleshooting.md +[10]: limitations.md \ No newline at end of file diff --git a/integrations/superoffice-for-teams/limitations.md b/integrations/superoffice-for-teams/limitations.md new file mode 100644 index 0000000000..5e7e318d3c --- /dev/null +++ b/integrations/superoffice-for-teams/limitations.md @@ -0,0 +1,27 @@ +--- +uid: teams-known-limitations +title: Known limitations in SuperOffice for Teams +description: Current known limitations in SuperOffice for Teams. +keywords: SuperOffice for Teams, Teams, limitations, known issues +author: schildea +date: 07.05.2026 +content_type: reference +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Known limitations in SuperOffice for Teams + +* **Bot scope:** The bot only handles sign-in and sign-out. It doesn't answer general questions. +* **File selector:** Supports single-file selection per save. Multi-select is planned. +* **No overwrite:** Saving the same file again always creates a new document. +* **Long chats:** Very long chat histories can impact performance. Limits may be introduced. +* **Private and shared channels:** Not supported due to Microsoft Teams platform restrictions (subject to change by Microsoft). +* **Unmanaged users:** Archiving is not supported in 1:1 chats with personal/unmanaged accounts. +* **File archiving in chats:** File uploading and attaching is disabled in chat contexts by SuperOffice for Teams. + +> [!NOTE] +> This documentation reflects the current pilot version of SuperOffice for Teams. Features and behavior may change based on feedback and future releases. + + \ No newline at end of file diff --git a/integrations/superoffice-for-teams/media/superoffice-for-teams-portal-download-app.png b/integrations/superoffice-for-teams/media/superoffice-for-teams-portal-download-app.png new file mode 100644 index 0000000000..98599bcbc7 Binary files /dev/null and b/integrations/superoffice-for-teams/media/superoffice-for-teams-portal-download-app.png differ diff --git a/integrations/superoffice-for-teams/media/teams-app-added-successfully-open-or-select-channel.png b/integrations/superoffice-for-teams/media/teams-app-added-successfully-open-or-select-channel.png new file mode 100644 index 0000000000..e2b0b09ecc Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-app-added-successfully-open-or-select-channel.png differ diff --git a/integrations/superoffice-for-teams/media/teams-app-store-built-for-your-org.png b/integrations/superoffice-for-teams/media/teams-app-store-built-for-your-org.png new file mode 100644 index 0000000000..ddefe1191e Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-app-store-built-for-your-org.png differ diff --git a/integrations/superoffice-for-teams/media/teams-app-store-open.png b/integrations/superoffice-for-teams/media/teams-app-store-open.png new file mode 100644 index 0000000000..e2b0b09ecc Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-app-store-open.png differ diff --git a/integrations/superoffice-for-teams/media/teams-archive-form.png b/integrations/superoffice-for-teams/media/teams-archive-form.png new file mode 100644 index 0000000000..a46d41823c Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-archive-form.png differ diff --git a/integrations/superoffice-for-teams/media/teams-archive-success.png b/integrations/superoffice-for-teams/media/teams-archive-success.png new file mode 100644 index 0000000000..c6f55d1cd7 Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-archive-success.png differ diff --git a/integrations/superoffice-for-teams/media/teams-archive-what-to-include.png b/integrations/superoffice-for-teams/media/teams-archive-what-to-include.png new file mode 100644 index 0000000000..260d1b0c7f Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-archive-what-to-include.png differ diff --git a/integrations/superoffice-for-teams/media/teams-channel-selector-go.png b/integrations/superoffice-for-teams/media/teams-channel-selector-go.png new file mode 100644 index 0000000000..1ebb91e6a6 Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-channel-selector-go.png differ diff --git a/integrations/superoffice-for-teams/media/teams-compose-bar-picker.png b/integrations/superoffice-for-teams/media/teams-compose-bar-picker.png new file mode 100644 index 0000000000..b3f8c9d64b Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-compose-bar-picker.png differ diff --git a/integrations/superoffice-for-teams/media/teams-message-menu-sofo.png b/integrations/superoffice-for-teams/media/teams-message-menu-sofo.png new file mode 100644 index 0000000000..2f55ffec93 Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-message-menu-sofo.png differ diff --git a/integrations/superoffice-for-teams/media/teams-pin-superoffice-for-teams-bot.png b/integrations/superoffice-for-teams/media/teams-pin-superoffice-for-teams-bot.png new file mode 100644 index 0000000000..88a0fcd322 Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-pin-superoffice-for-teams-bot.png differ diff --git a/integrations/superoffice-for-teams/media/teams-preferences.png b/integrations/superoffice-for-teams/media/teams-preferences.png new file mode 100644 index 0000000000..429f33c64d Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-preferences.png differ diff --git a/integrations/superoffice-for-teams/media/teams-select-channel-and-go-dialog.png b/integrations/superoffice-for-teams/media/teams-select-channel-and-go-dialog.png new file mode 100644 index 0000000000..1ebb91e6a6 Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-select-channel-and-go-dialog.png differ diff --git a/integrations/superoffice-for-teams/media/teams-uninstall-superoffice-for-teams-app.png b/integrations/superoffice-for-teams/media/teams-uninstall-superoffice-for-teams-app.png new file mode 100644 index 0000000000..ddf094c8c1 Binary files /dev/null and b/integrations/superoffice-for-teams/media/teams-uninstall-superoffice-for-teams-app.png differ diff --git a/integrations/superoffice-for-teams/preferences.md b/integrations/superoffice-for-teams/preferences.md new file mode 100644 index 0000000000..b13c540ee9 --- /dev/null +++ b/integrations/superoffice-for-teams/preferences.md @@ -0,0 +1,33 @@ +--- +uid: teams-preferences +title: Preferences in SuperOffice for Teams +description: How to set your default archiving options in SuperOffice for Teams. +keywords: SuperOffice for Teams, Teams, preferences, defaults, settings +author: schildea +date: 07.05.2026 +content_type: reference +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Preferences in SuperOffice for Teams + +Each user can set default options that prefill the archive forms. You can always change them per save. + +Click the **Preferences** button in the bottom-left of the pop-up window to access your defaults: + +* Default document template for chats. +* Default document template for files. +* Include deleted message notices (yes or no). +* Include emoji reactions (yes or no). +* Include files – attach to .EML (yes or no). +* Mark as completed by default. +* Generate AI summary by default (requires AI Labs). + +![The Preferences screen showing all available default settings -screenshot][img1] + + + + +[img1]: media/teams-preferences.png \ No newline at end of file diff --git a/integrations/superoffice-for-teams/requirements.md b/integrations/superoffice-for-teams/requirements.md new file mode 100644 index 0000000000..396708f8a7 --- /dev/null +++ b/integrations/superoffice-for-teams/requirements.md @@ -0,0 +1,25 @@ +--- +uid: teams-requirements +title: Requirements for SuperOffice for Teams +description: What you need before you can use SuperOffice for Teams. +keywords: SuperOffice for Teams, Teams, requirements, prerequisites +author: schildea +date: 07.05.2026 +content_type: reference +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Requirements for SuperOffice for Teams + +Before you start, make sure the following requirements are met: + +* Microsoft Teams (desktop or web). +* A SuperOffice Online user account with permission to create activities and documents. +* A registered tenant and granted admin consent. This is usually handled once by a Microsoft 365 or SuperOffice administrator. + +See [Deploy SuperOffice for Teams][1] for the full setup steps. + + +[1]: deploy.md \ No newline at end of file diff --git a/integrations/superoffice-for-teams/security.md b/integrations/superoffice-for-teams/security.md new file mode 100644 index 0000000000..afa4c72fc9 --- /dev/null +++ b/integrations/superoffice-for-teams/security.md @@ -0,0 +1,28 @@ +--- +uid: teams-security +title: Permissions and security in SuperOffice for Teams +description: Microsoft Graph permissions requested by SuperOffice for Teams and how they are used. +keywords: SuperOffice for Teams, Teams, permissions, security, Microsoft Graph, privacy +author: schildea +date: 07.05.2026 +content_type: reference +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Permissions and security in SuperOffice for Teams + +SuperOffice for Teams requests a limited set of Microsoft Graph permissions, following the principle of least privilege. Permissions are delegated, which means SuperOffice for Teams cannot access data autonomously. The app only asks for the minimum access it needs: + +* Read names and descriptions of channels. +* Read channel members. +* Read channel messages. +* Read chat messages. +* Read files the user can access. +* Read items in site collections. +* Read basic user profiles. + +These permissions are maintained and validated by Microsoft. + + \ No newline at end of file diff --git a/integrations/superoffice-for-teams/toc.yml b/integrations/superoffice-for-teams/toc.yml new file mode 100644 index 0000000000..b91c3e5979 --- /dev/null +++ b/integrations/superoffice-for-teams/toc.yml @@ -0,0 +1,24 @@ +### YamlMime:TableOfContents +items: +- name: Introduction + href: index.md +- name: Requirements + href: requirements.md +- name: Deploy (administrators) + href: deploy.md +- name: Get (users) + href: get.md +- name: Archive a conversation + href: archive-conversation.md +- name: Save a file from a channel + href: archive-file.md +- name: AI summaries + href: ai-summary.md +- name: Preferences + href: preferences.md +- name: Permissions and security + href: security.md +- name: Troubleshooting + href: troubleshooting.md +- name: Known limitations + href: limitations.md \ No newline at end of file diff --git a/integrations/superoffice-for-teams/troubleshooting.md b/integrations/superoffice-for-teams/troubleshooting.md new file mode 100644 index 0000000000..669b88ddf4 --- /dev/null +++ b/integrations/superoffice-for-teams/troubleshooting.md @@ -0,0 +1,48 @@ +--- +uid: teams-troubleshooting +title: Troubleshooting SuperOffice for Teams +description: Solutions to common issues in SuperOffice for Teams. +keywords: SuperOffice for Teams, Teams, troubleshooting, errors, sign-in, consent +author: schildea +date: 07.05.2026 +content_type: troubleshooting +category: integration +topic: SuperOffice for Teams +language: en +--- + +# Troubleshooting SuperOffice for Teams + +## "Save files" button is disabled + +SuperOffice for Teams didn't detect any files in the selected conversation. Make sure you're in a standard channel and that the file is still accessible. + +## "You are not signed in" + +Click the **Open Chat** button to go to the bot chat, then click **Sign In**. If the sign in button is missing, type **Sign In** or **Help** in the bot chat to trigger it. + +## "Action was forbidden. Make sure to add SuperOffice for Teams to the apps of the Team." + +SuperOffice for Teams has to be added to a team (channel) to work. If the application was not found in the team, this message is shown. + +## SuperOffice for Teams is missing from the message menu + +Teams blocks app usage in certain contexts, including private channels, shared channels, and 1:1 chats with unmanaged personal accounts. Check the [compatibility overview][1] to confirm whether SuperOffice for Teams is supported in the conversation you are using. + +SuperOffice for Teams can also be hidden from the message menu when a message was sent as a reply to both a thread and the channel. If you right-click that message from the channel view, SuperOffice for Teams may not appear. This happens because the message is technically stored as a child message in the thread, not as a standalone channel message. + +To use SuperOffice for Teams in this case, open the thread and right-click the message from inside the thread instead. + +## Consent or permission errors + +Ask your Microsoft 365 administrator to verify that tenant-level consent was granted and that no permissions have been revoked. See [Deploy SuperOffice for Teams][2]. + +## "Generate Summary" is disabled + +AI Labs must be activated for your SuperOffice tenant. Contact your SuperOffice administrator. + + +[1]: index.md +[2]: deploy.md + + diff --git a/integrations/toc.yml b/integrations/toc.yml index ba77686f9c..daf1e3ede3 100644 --- a/integrations/toc.yml +++ b/integrations/toc.yml @@ -19,6 +19,9 @@ items: - name: SuperOffice for Outlook href: superoffice-for-outlook/toc.yml topicHref: superoffice-for-outlook/index.md +- name: SuperOffice for Teams + href: superoffice-for-teams/toc.yml + topicHref: superoffice-for-teams/index.md - name: Video meetings href: video-meetings/toc.yml topicHref: video-meetings/index.md