Connecting integrations
Integrations let agents work in the systems you already use, such as your mailbox, calendar, file storage or code repositories. Everyone connects their own account. Your administrator decides which integrations you see.
Browse the catalog
- Click Integrations in the sidebar.
- Narrow the list with the filters All, Connected or Needs setup. Built by me is grayed out and shows Coming soon when you hover over it.
- Type a term into the Search integrations... box. It searches name, vendor and description.
- Click a tile to open its detail page. Tiles marked Needs setup open too.
Enlarge figure
Enlarge figureDepending on your instance, you'll find tiles for Gmail, Google Calendar, Google Drive, Google Docs, Google Sheets, Google Tasks and Google Contacts; for Outlook Email, Outlook Calendar, Microsoft Teams, SharePoint, OneDrive and Excel; for GitHub, GitLab, Slack, FILERO DMS, E-Mail (IMAP/SMTP) and MCP Utilities; and for any custom connectors your administrator has added. MCP Utilities provides date, math and encoding helpers and needs no sign-in. Product names belong to their owners.
What the tile labels mean
| On the tile | Meaning |
|---|---|
| Connect | The integration is set up and you can connect your account. |
| Connected | Your account is connected and agents can use the integration. MCP Utilities needs no account and always shows Connected. |
| Needs setup | Your administrator has to set the integration up first. Until then you can't connect an account. |
| Beta | The integration is marked as beta. Your administrator can turn the label on or off per integration. |
If an integration is missing entirely, your administrator has switched it off or made it available only to certain groups or tenants. If Integrations is missing from the sidebar, the area isn't enabled on your instance.
Connect an account through the provider
This is how you connect Google, Microsoft, GitHub, GitLab, Slack and custom connectors your administrator has added. You sign in on the provider's own page, not in Intra AI.
- Open the tile. Actions lists what the integration can do, and each action is tagged Read-only, Makes changes, Deletes data or Unclassified.
- In the Connections section, click Add connection.
- The dialog tells you that you'll be redirected to the provider. Click the button, for example Connect with Google.
- Sign in with the provider and grant the permissions it asks for.
- You come back to the tile's detail page. It now shows Connected, and your account is listed under Connections.
If the connection fails, a red notice at the top of the detail page gives the reason. Click Dismiss to close it.
If the Connections section shows a notice instead of the button, the integration hasn't been set up on your instance yet. Ask your administrator.
Enlarge figureFILERO DMS has its own setup wizard, covered in Connecting FILERO DMS.
Connect the Microsoft tiles
A Microsoft tile that isn't connected yet shows a Before you connect panel. It walks through the sign-in steps and lists every permission this tile asks for. On Outlook Calendar it also lists What you can do once connected.
Each Microsoft tile requests its own set of permissions. A tile only shows Connected once your default Microsoft account has granted at least that tile's permissions. Tiles that need the same permissions connect together: connecting SharePoint also connects OneDrive and Excel. So if you connected Outlook Email and now need Teams, open the Teams tile and connect again with the same Microsoft account. Permissions marked "admin consent" also need approval from your company's Microsoft administrator.
The note at the bottom of the panel says one connection covers every Microsoft tile. Don't rely on it. What counts is whether the tile itself shows Connected.
Connect a mailbox with E-Mail (IMAP/SMTP)
E-Mail (IMAP/SMTP) connects a mailbox on your own mail server. Agents can search it, read messages, create drafts and send mail. By default the agent asks you before it sends anything, unless whoever built the agent set sending to run without asking. See "Keep write actions in check" below.
- Open the E-Mail (IMAP/SMTP) tile and click Add connection.
- Under Mail server, pick a preset your administrator created, or Custom server (IMAP/SMTP).
- Enter your Email address and Password. If your mail server offers app passwords, use one. Fill in Username only if it differs from the address.
- For a custom server, enter IMAP server, IMAP port (993 or 143), SMTP server and SMTP port (465 or 587), the same values you would use in Outlook. The connection is always encrypted.
- Click Save. The message "Connection saved." confirms it.
To add another mailbox, click Add connection again.
Manage connected accounts
On a connected tile, the Connections section has one row per account. Each row shows the address, how many permissions you granted and when the sign-in was last refreshed. The first account you connect becomes your Default.
- Set as default makes another account the default. Agents use it when neither the conversation nor the agent names an account.
- Disconnect removes the account. Intra AI asks you to confirm first.
Google, Microsoft, FILERO DMS and E-Mail (IMAP/SMTP) can hold several accounts. Add one with a button such as Connect another Google account. GitHub, GitLab, Slack and custom connectors hold one account per person, so signing in again replaces the existing connection, even with a different account.
If a row says Sign-in required, your sign-in has expired, and agents and workflows can't use the account until you sign in again. For Microsoft accounts you also get a notice in Messages and announcements. Click Connect another Google account (Connect another Microsoft account on Microsoft tiles, Add connection on E-Mail) and sign in with the same account. Intra AI renews the existing connection instead of adding a second one.
After you disconnect, agents and conversations that used the account fall back to the account chip on their next message. Synced folders from the account stop updating, and they're removed after 60 days unless you reconnect. Disconnecting applies to the whole account: a Microsoft account you disconnect on one tile is gone from every Microsoft tile.
Note: Disconnecting removes the account from Intra AI. Intra AI doesn't show whether access was also revoked at the provider. If in doubt, check the app permissions in your account settings with that provider and remove the access there.
Choose the account in a conversation
If an agent needs an integration you haven't connected, the area above the message box shows "... needs access to ..." before your first message. Connect opens the right tile. If it says "Your administrator needs to set this up" instead, you can't connect that integration yet.
When an agent uses Microsoft, Google, FILERO DMS or E-Mail (IMAP/SMTP), the conversation shows a chip with the active account above the message box.
- If you've connected more than one account, click the chip.
- Pick the address the agent should work with. Your choice applies to this conversation.
- The same menu has Connect another account, which takes you to Integrations. With only one account the chip has no menu, so connect another one directly under Integrations.
Intra AI picks the account in this order: your choice in the conversation, then the agent's account binding, then your default account. If none of these applies, you're asked.
Bind an account to an agent
If one of your agents should always work through the same address, such as a shared mailbox, bind that account to it.
- Open the agent in the builder and turn on Expert mode.
- Go to the Tools step and find Account binding.
- Pick the account, or keep No fixed account (chip, else default or ask).
Account binding only appears on private agents you haven't shared, and only when you've connected more than one account with that provider. The setting applies to you alone. To give an agent actions from an integration, see Tools, knowledge and sub-agents.
Synced folders
Google Drive and FILERO DMS can keep whole folders up to date. On the tile, the Synced folders section lists those folders and how many files each holds. They also appear in Files.
Connect the account first. Sync a folder lets you pick a folder right on the tile, and Manage in Files takes you to folder management in Files. Managing files has the details. If your instance doesn't offer folder sync for this integration, the section shows a notice instead.
Keep write actions in check
An agent always works with the connected accounts of the person using it, never with the accounts of the person who built it. Read-only actions run without asking.
For every action that creates, changes, sends or deletes something, whoever builds the agent chooses a behavior under What the agent may do on its own in the Tools step: always ask before running or run without asking. With run without asking they can add a justification. The agent may then only write inside a procedure it already has. The builder currently can't create one, so an agent without a procedure can't be finished until the action is set to always ask before running. On a shared agent, that choice applies to everyone who uses it. Your instance may also have running without asking switched off entirely, or specific tools may always ask.
In the conversation, such an action pauses and shows a card, for example "Send this message?". Check the recipients, subject and body before you approve it. An action that ran without a card carries the label Ran without confirmation. Tools in chat: confirmations and errors explains the card in full.
Warning: An approved action takes effect directly in the connected system. Intra AI can't take back an email that was sent or an entry that was deleted.
Troubleshooting
- "You declined the permission request at Google, so nothing was connected.": Start the connection again and accept the permissions.
- "The connection attempt expired or was started in another tab." or "This connection was started in a different browser or window.": Click Add connection again in the same window.
- "This integration is not configured yet. Ask an admin to set the OAuth client.": The tile is visible, but your administrator hasn't finished setting up sign-in with the provider.
- "The IMAP server rejected the login – check the password.": Check the password. If your mail server requires an app password, use that instead.
- "Mail server not reachable (IMAP)." or "Mail server not reachable (SMTP).": Check the server name and port.
- "... must resolve to a public internet address." on IMAP server or SMTP server: A server you enter yourself must have a public internet address. If your mail server is only reachable inside your company network, ask your administrator to set it up as a preset.
- The agent uses the wrong account: check the account chip in the conversation, then the agent's account binding, then your default account.
- An integration is missing from the catalog: ask your administrator whether it's available to your group or tenant.