Skip to main content
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.
  • Your own Teams account linked to your Opengeni account. See 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 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.
  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.
  • 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. 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 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.
  • 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 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 for how Opengeni handles personal data, where it is stored, and the providers that process it.
  • 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 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 with what you tried, what happened, and roughly when. Opengeni is made by Cloudgeni AS, Norway. See the terms of service and the privacy policy.