> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opengeni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

> Give tasks to your Opengeni agents from Microsoft Teams: setup, account linking, commands, your data and support.

The Opengeni app for Microsoft Teams lets you give tasks to your Opengeni
agents from Teams. Send Opengeni a message in a 1:1 chat and it works on the
task with your Opengeni access, then replies in the same chat. Where your
organization has turned them on, you can also mention **@Opengeni** in a group
chat or a channel.

Opengeni is an AI agent. Its replies are generated by AI and can be wrong, so
check them before you rely on them.

## Requirements

* **An Opengeni account in the organization that connected Teams**, with
  permission to start chats in a workspace Teams can use: the connected
  workspace, or, where your organization lets Teams reach more workspaces, any
  of those you belong to. Ask an Opengeni administrator to invite you.
  Installing the Teams app does not create an account.
* **A Microsoft 365 work or school account** in Teams. Personal Microsoft
  accounts can't connect to Opengeni.
* **Your organization connected once.** An administrator connects your
  Microsoft 365 organization to Opengeni from a shared workspace. See
  [Connect your organization](#connect-your-organization).
* **Your own Teams account linked** to your Opengeni account. See
  [Link your account](#link-your-account).
* **Where it works.** 1:1 chats work as soon as your organization is connected
  and your account is linked. Group chats and channels work only where they
  have been turned on for your organization; email
  [support@opengeni.ai](mailto:support@opengeni.ai) to ask about them.

## Connect your organization

Each Microsoft 365 organization is connected once, from one shared Opengeni
workspace, to that workspace's Opengeni organization. Group chats and channels
use that workspace; 1:1 chats can also use the other workspaces your
organization lets Teams reach. The person who connects it needs:

* the **Global Administrator** or **Teams Administrator** role in Microsoft 365,
  and
* an Opengeni account that is an administrator of the shared workspace that
  you connect from.

To connect:

1. In Teams, choose **Apps**, search for **Opengeni** and choose **Add**. If
   your organization restricts apps, a Teams administrator first allows
   Opengeni in the Teams admin center (**Teams apps** > **Manage apps**).
2. Send Opengeni any message in a 1:1 chat. It replies with a button to
   connect your organization.
3. Choose the button and sign in to Opengeni.
4. Sign in with your Microsoft work account when asked. Opengeni checks that it
   is the same account you use in Teams and that it has one of the
   administrator roles above.
5. Choose the shared workspace to connect from, and choose
   **Connect workspace**.

Your organization is now connected and your own Teams account is linked to
your Opengeni account. Everyone else links their own account the first time
they message Opengeni.

People who message Opengeni before their organization is connected get the
same **Connect your organization** button; anyone who isn't an administrator is
asked to have their Microsoft 365 or Teams administrator message Opengeni and
connect it. Send `help` at any time to get the button again.

## Link your account

1. In Teams, open a 1:1 chat with Opengeni and send a message.
2. Choose **Link account**. Opengeni opens in your browser.
3. Sign in to Opengeni if asked, check the details shown, and choose
   **Sign in with Microsoft**.
4. Sign in to Microsoft with the account you use in Teams. This proves the
   Teams account is yours; Opengeni asks only for your basic profile.
5. Go back to Teams and send your request again.

The link is tied to the Teams account it was sent to and links it to the
Opengeni account you are signed in with. It works only for someone who signs in
to Microsoft as that Teams account; anyone else is told whose link it is and
nothing is linked. Links expire after 10 minutes or once used; send Opengeni a
new message to get a new one. To link from a group chat or channel, message
Opengeni directly first; it never posts account links in shared conversations.

## Use Opengeni in Teams

* **1:1 chats.** Send a message describing what you need. When a new task
  starts, Opengeni replies with a link to follow it in Opengeni, then sends its
  answer in Teams when it finishes. Your 1:1 chats are private to you. They are
  saved in the workspace they use, visible only to you: by default your
  Personal workspace in Opengeni when your organization uses Personal
  workspaces, and otherwise the connected workspace. See
  [Workspaces and agents](#workspaces-and-agents).
* **Group chats and channels.** Mention **@Opengeni**. Only messages that
  mention it start work. In a channel, Opengeni replies in the thread, and a
  later mention in the same thread continues the same task. Everyone in a group
  chat must have linked their account and have access to the connected
  workspace, or Opengeni does not start work there. If a group chat's members
  change, the next mention starts a new Opengeni chat. These chats are saved in
  the connected workspace and are visible to its members.
* **Approvals and questions.** When a task needs your approval or an answer,
  Opengeni sends a link to the task in Opengeni. Approve or answer there, signed
  in to your Opengeni account; this is never done in Teams.

Opengeni uses the same tools, connections and Knowledge in Teams as in the
Opengeni app, within your own access.

## Workspaces and agents

Where your organization lets Teams reach more than one workspace, your 1:1
chat can start work in any of those workspaces you belong to, and you can ask
any agent there that you're allowed to use.

* **Where a chat starts.** Opengeni uses your Personal workspace, or your only
  workspace. If it can't tell, it shows a card with your workspaces and agents,
  and your message waits until you pick one.
* **Switch.** Send `switch` to see the list and pick another workspace or
  agent, or `switch Design` to pick one by name. New messages go there until
  you switch again.
* **One message elsewhere.** Start a message with `in Design:` to send just
  that message to the Design workspace. It continues your chat there, and its
  reply starts with the workspace's name.
* **Ask an agent.** Start a message with an agent's name and a colon
  (`Researcher: …`) or with `+researcher`. Later messages go to the same agent
  until you switch. Start with `Opengeni:` to go back to the main assistant.
* **Agents for everyone.** An agent whose **Who can use it** is **Anyone in
  your organization** also answers full members of your Microsoft Teams
  organization who aren't in its workspace, in 1:1 chats. Guests can't use
  it. The chat runs as the agent and its workspace's members can see it;
  Opengeni says so on the first reply.
* **Where a reply came from.** An agent's replies start with its name and
  workspace, and the first reply in a workspace says where the chat is saved.
* **Lost access.** If you can no longer use a workspace or agent, Opengeni says
  so and starts nothing. It never answers from another workspace instead. Send
  `switch` to choose again.

An organization owner or administrator chooses which workspaces Teams can
reach. In Opengeni, open **Capabilities** in the connected workspace, find the
card with your Teams app's name, and under **Available in Opengeni** choose all
workspaces or selected ones, and whether Personal workspaces are included. The
connected workspace is always included. Group chats and channels always use the
connected workspace.

## Commands

Type a command in a 1:1 chat with Opengeni, or pick it from the command menu
above the message box.

| Command | What it does |
| - | - |
| `help` | Shows what Opengeni can do in Teams and how to get started, without starting a task. |
| `switch` | Lets you choose the workspace or agent your new messages go to. |
| `link` | Links your Teams account to your Opengeni account, or says it is already linked. |
| `unlink` | Unlinks your Teams account from your Opengeni account, after you confirm. |

`disconnect` works the same as `unlink`. The menu also offers a few prompt
starters, such as **Research a topic**; they are ordinary requests that start a
task. In a group chat where Opengeni is turned on, mention **@Opengeni** with
`help`.

## AI-generated replies and feedback

Opengeni's replies in Teams are written by AI and are labelled as AI-generated.
Where Teams shows feedback buttons on a reply, use them to tell us whether the
reply helped. You can also email [support@opengeni.ai](mailto:support@opengeni.ai)
to report a wrong, harmful or unexpected reply; include the time and the chat
it was in.

## Your data

What Opengeni keeps from Teams:

* **Your account link.** Your Microsoft 365 organization (tenant) ID and your
  Microsoft Entra object ID, linked to your Opengeni account.
* **Messages to Opengeni and its replies.** A message you send to Opengeni, or a
  mention of it, and Opengeni's replies become part of an Opengeni chat and are
  kept like any other Opengeni chat. Your message is sent to the AI model that
  runs the task, as described in the [privacy policy](https://opengeni.ai/privacy).
* **Delivery records.** A copy of each Teams message Opengeni received and each
  reply it sent, with its delivery status. They make sure a task is never
  started twice or a reply sent twice, and help investigate a missing reply.
  Deleting the Opengeni chat does not delete them; ask
  [support@opengeni.ai](mailto:support@opengeni.ai) to delete them.
* **Group chat members.** When Opengeni is mentioned in a group chat, it reads
  the member list from Teams and stores the members' Microsoft Entra object IDs
  with that chat.
* **Conversation context, in group chats and channels where it is turned on.**
  So that a mention can be answered with what was said before it, Opengeni
  keeps the recent messages people post there: up to 4,000 characters of text,
  whether the message had attachments, the sender's display name and Microsoft
  Entra object ID, and the time. It keeps at most the newest 100 messages per
  channel thread or group chat. Messages are used for seven days after
  Opengeni receives them; after that they are no longer used and are deleted
  as new messages arrive. When a message is edited in Teams, Opengeni keeps the
  new text, and when it is deleted, Opengeni deletes it too. When someone joins
  a group chat, the messages kept for that chat are deleted. Files and images
  are never downloaded, and messages from 1:1 chats, from bots, and from chats
  where Opengeni is not turned on are never kept this way. When Opengeni
  answers a mention, the earlier messages it uses are sent to the AI model with
  that mention and saved in that Opengeni chat, where everyone in the connected
  workspace can see them.

Apart from conversation context in the group chats and channels where it is
turned on, the Teams app does not read your Teams messages, files or other
Microsoft 365 data. A separate **Microsoft Teams** integration, which each
person can connect in Opengeni, lets agents read, search and send Teams
messages and look up colleagues with that person's Microsoft permissions. Some
of its permissions need administrator consent. It is set up and removed
independently of the Teams app.

Opengeni does not use your Teams data for advertising or to train AI models,
and the models paid with Opengeni credits don't train on it. If your workspace
uses its own AI subscription, that provider's training settings apply. See the
[privacy policy](https://opengeni.ai/privacy) for how Opengeni handles personal
data, where it is stored, and the providers that process it.

## Unlink, disconnect or remove the app

* **Unlink your account.** Send `unlink` (or `disconnect`) in your 1:1 chat with Opengeni, or
  in Opengeni open **Capabilities** in the connected workspace, find the
  card with your Teams app's name and the Teams logo and choose **Unlink account**. Opengeni stops accepting
  work from your Teams account until you link it again, and replies that were
  not yet sent are dropped. This deletes your account link, and group chats you
  are in stop accepting work until you link again. Your Opengeni chats and the
  delivery records stay.
* **Disconnect your organization.** A workspace administrator opens
  **Capabilities**, finds the card with your Teams app's name and chooses **Disconnect bot**.
  Opengeni stops accepting work from your organization's Teams, drops messages
  and replies not yet delivered, and deletes the conversation context it kept.
  Tasks already running continue in Opengeni. Existing chats, account links and
  delivery records stay, so people remain linked if you reconnect. Reconnecting
  uses the same workspace.
* **Remove the app from Teams.** In Teams, choose **Apps** > **Manage your
  apps**, find Opengeni and choose **Uninstall**, or remove it from a group
  chat or team in that conversation's apps settings. A Teams administrator can
  remove or block it for the whole organization in the Teams admin center.
  Removing the app does not delete your data in Opengeni: unlink or disconnect
  first, and delete chats in Opengeni or ask
  [support@opengeni.ai](mailto:support@opengeni.ai) to delete your data.

## Limitations

* Opengeni ignores Teams messages that include files, images or other
  attachments, and does not reply to them. Send your request as text only, and
  attach files in the Opengeni app instead.
* Approvals and private questions are answered in Opengeni, not in Teams.
* Group chats and channels work only where they have been turned on for your
  organization, and only for messages that mention Opengeni. Group chats can
  have at most 250 people, all with linked accounts.
* Conversation context covers standard channels and group chats only, not
  private or shared channels, and never messages posted before it was turned
  on.
* One Microsoft 365 organization connects to one Opengeni organization, from one
  shared workspace. Group chats and channels use that workspace; 1:1 chats can
  use the workspaces your organization lets Teams reach. Moving the connection
  to another workspace is not supported.
* Long replies may arrive as several Teams messages.
* If Teams did not confirm that a reply arrived, Opengeni does not send it
  again, so it cannot appear twice. Open the task link to see the full answer in
  Opengeni.

## Troubleshooting

* **Opengeni doesn't reply at all.** Opengeni may not be turned on for that
  group chat or channel, the message may have had an attachment, or your
  Opengeni account may not be allowed to start chats in the workspace the chat
  uses. Ask your Teams or Opengeni workspace administrator, or email support.
* **Opengeni keeps asking you to link your account.** Open the link from your
  latest 1:1 message with Opengeni and finish linking, signed in to your
  Opengeni account in the organization that connected Teams.
* **"I couldn't verify this chat's access."** Everyone in the group chat needs a
  linked Opengeni account and access to the connected workspace.
* **"Opengeni could not start this task."** Check that you still have access to
  the workspace the chat uses and can start chats there.
* **"You can no longer start chats in … from Teams."** You lost access to that
  workspace, or an administrator removed it from the workspaces Teams can
  reach. Send `switch` to choose another.

## Support

Email [support@opengeni.ai](mailto:support@opengeni.ai) with what you tried, what
happened, and roughly when. Opengeni is made by Cloudgeni AS, Norway. See the
[terms of service](https://opengeni.ai/terms) and the
[privacy policy](https://opengeni.ai/privacy).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.