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.
- 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).
- Send Opengeni any message in a 1:1 chat. It replies with a button to connect your organization.
- Choose the button and sign in to Opengeni.
- 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.
- Choose the shared workspace to connect from, and choose Connect workspace.
help at any time to get the button again.
Link your account
- In Teams, open a 1:1 chat with Opengeni and send a message.
- Choose Link account. Opengeni opens in your browser.
- Sign in to Opengeni if asked, check the details shown, and choose Sign in with Microsoft.
- 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.
- Go back to Teams and send your request again.
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.
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
switchto see the list and pick another workspace or agent, orswitch Designto 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 withOpengeni: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
switchto choose again.
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.
Unlink, disconnect or remove the app
- Unlink your account. Send
unlink(ordisconnect) 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
switchto choose another.