Skip to main content

Connecting apps when you belong to several groups

This guide gives guidance for Connectors and Connected apps, Threads, the OnEarly Agent and People & Groups.

The question​

Most people belong to more than one group in OnEarly, such as a family, a care team or an employer. Each group may come with its own accounts: an email address, a calendar, a document store. Where should each connector live, so that the people who should be able to use an account through the OnEarly Agent can, and nobody else?

Where a connector can live​

A connector belongs either to you or to a group.

Personal connectorGroup connector
Added underAccount → ConnectorsGroup settings → Integrations, by a group admin
Belongs toYouThe group
Used byYour OnEarly AgentThe OnEarly Agent of each of the group's admins
In which threadsEvery thread you start, unless a group connector for the same service takes its placeOnly threads started in that group
Who can see it is connectedYouThe group's admins, under Group settings → Integrations
When you leave the groupStays connectedYou can no longer use it. It stays with the group.

A few rules sit behind this table:

  • Admins only. A group admin is a member whose role includes manage-group (see Group permissions). Members without it can't use the group's connectors, and can't see them.
  • Only in the group's threads. A group connector is used only in a thread started in that group with Start in a group. In your personal threads, and in threads started in other groups, it isn't there.
  • The group's account comes first. In a thread started in a group you administer, the group's connector for a service is used instead of your own connector for that service. If the group has a Google Calendar connector, for example, the Agent uses the group's calendar in that thread, not yours. Your connectors for other services stay available.
  • Your connectors stay yours. Group admins can't see or use your personal connectors. Group settings → Integrations lists only the group's own.

Of the three ways of acting, connectors match two: yours (USER) and the group's (GROUP). There is no connector that belongs to you only as a member of one group (GROUP_MEMBER).

The rule of thumb​

Ask two questions about each account.

  1. Whose account is it? If the sign-in is yours, it is a personal connector. If the account belongs to the group, such as a shared family calendar or a team mailbox, it is a group connector.
  2. Who should use it through the Agent? Only you, wherever you are: personal. The group's admins, when working in the group: group.
Whose accountWho uses it through the AgentWhere it lives
YoursYou, in every threadPersonal connector
The group'sThe group's admins, in threads started in that groupGroup connector

If members who aren't admins also need an account, a group connector won't reach them. Each of them connects it, or their own account that can see it, as a personal connector.

Worked example​

You have a personal Gmail account and a work Outlook account, and you share a family Google Calendar with your partner. In OnEarly you belong to a Family group and a Work group.

AccountWhere to connect itWhy
Personal GmailPersonal connector, under Account → ConnectorsIt is yours alone. It follows you into every thread, and no group can see it.
Family Google CalendarGroup connector on the Family group, added by you or your partner as an adminThe calendar belongs to the family. It stays with the group if either of you leaves, and the Agent uses it in threads started in the Family group.
Work OutlookPersonal connector, under Account → ConnectorsThe mailbox is yours, not your employer's. As a group connector on the Work group, every admin of that group could use it through their Agent. No connector belongs to you only within one group, so personal is the right place today.

Each choice has trade-offs.

  • The family calendar isn't in your personal threads. Ask about it in a thread started in the Family group. There, it also takes the place of any Google Calendar you connected yourself. If you would rather have the family calendar everywhere, connect the Google account that can see it as a personal connector instead; it then goes with you, not the family, if you leave.
  • Only Family admins can use the family calendar. If your partner isn't an admin of the Family group, their Agent can't use it. Make them an admin, or have them connect it personally.
  • Your work mailbox is in family threads too. A personal connector is available in every thread, so the Agent can read your work email when you ask about something in a family thread. Say which account you mean when it matters.
  • Nothing removes the work connector when you leave the Work group. Disconnect it yourself (see below).

Practical steps​

  • Start a thread where the work belongs. Use Start in a group for anything about a group, so the Agent can use the group's connectors (if you administer it) and its skills. Use Back to just you for anything personal. See Start a thread.
  • Name each account. Choose Rename on a connector under Account → Connectors, for example "Work Outlook", so you can tell two accounts of the same service apart.
  • Check which account sends. When you have more than one email account, the Agent asks which to use before it sends or writes, unless you said. The email draft card shows the account on its From: line, and with several accounts you can choose another before you send. See Approvals before it acts for you.
  • Disconnect when you leave. When you leave a group, open Account → Connectors and choose Disconnect on any personal connector you added for that group's work. Disconnecting removes the connection from OnEarly. To end OnEarly's access at the service too, remove OnEarly in that account's own settings.
  • Prefer read-only services for documents. Google Drive and OneDrive connectors are read-only, so the Agent can find and read files there but never change them.
  • Narrow what your own software can do. Per-tool switches are on API keys, not on connectors. To let a key read Gmail but not send from it, switch on only the tools you need under Connected accounts when you create the key. See Key permissions.

What we're working on​