Skip to content

Connect a mailbox

A connected mailbox is an email account, such as support@yourcompany.com, that Ronja reads, replies from and sends new mail from, all as that address. The person on the other end sees mail from that address, not from Ronja.

You manage mailboxes on the Mailboxes page, in the admin sidebar’s Integrations group. Both Gmail and Outlook connect. A mailbox is not the address that sends Ronja’s notifications, nor the address that triggers an automation; see What’s the difference?.

The connected mailbox is whichever account you sign in as, so sign in as the mailbox itself, such as support@yourcompany.com, not as yourself. The card names the address it connected (Ronja reads and replies as this address); if it’s the wrong one, Disconnect it and connect again.

Two kinds of address have no inbox to sign in to, and can’t be connected:

  • A Google Group. Convert it to a Google Workspace user with Gmail turned on, and connect that.
  • A Microsoft shared mailbox. Connect a licensed user mailbox instead, for example a licensed account given that address.
  1. Open Mailboxes and click Connect a mailbox.
  2. Choose Gmail or Outlook, then click Connect Gmail or Connect Outlook.
  3. In the popup, sign in as the mailbox itself. Use a private window if you are already signed in as someone else.

The mailbox appears on the page with its address. If the account has no inbox Ronja can read, the card says what to do (see When a mailbox isn’t connected).

There is no label to set up. Ronja files a message she has dealt with, marked read, under a label of her own, and questions she asks under a second. She won’t add or remove either on anyone’s instruction; ask her to use a label of your own.

Connecting happens only in the browser, and Disconnect and the card’s settings (Compose recipients, Watched label, Daily send limit) refuse an API token, the CLI and automations. See Actions the API can’t take.

A non-admin sees an admin-only notice on the Mailboxes page; their work reaches a mailbox only through an automation, Saved Agent or workflow an Admin attached it to. Detaching it stops future runs, but doesn’t take back anything already read into chats, which can be shared. To cut a mailbox off fully, disconnect it.

What Ronja can do with a connected mailbox

Section titled “What Ronja can do with a connected mailbox”

Ask her in a chat, or have an automation do it unattended:

She can Notes
Read it Search the mailbox, or read one thread in full. A text search covers the subject and body on Gmail, but only the subject on Outlook.
Open attachments See Attachments.
Reply in the thread As the mailbox address. The recipient is always the original sender.
Send new email As the mailbox address, optionally copying people in. Where it may go is set by Compose recipients.
Triage Mark a message read, and add or remove labels, for example to set one aside for a person.
Ask a colleague a question from it Gmail only. See Let a saved agent ask a person.

A new email can carry up to 10 files and 25 MB in total from Gmail, or about 3 MB per message from Outlook (Microsoft’s limit). One over the limit is refused before it is sent, naming the limit. Formatting goes out as HTML with a plain-text version alongside.

If you don’t say which address to send from, Ronja asks once per chat: a connected mailbox or her own. With none connected, she asks whether an Admin should connect one, or whether to send from her own address instead.

In a chat, she asks for your approval before a reply or new email leaves, showing the recipients (including anyone copied in), the subject and the message, and for a new email the mailbox it is sent from. An automation can send without that pause (Answering mail unattended).

Ronja never treats an email’s contents as instructions, and acts only on threads she was asked to look at.

Ask for a message’s attachments and Ronja pulls them in as files she can read:

  • Up to 20 per message, 25 MB each and 100 MB per message, and 50 in one search, in a chat as on a trigger. She names what she skipped, and counts inline images rather than fetching them.
  • They land in Files, seen only by you and your Admins, and are kept 1 year unless moved into a folder.
  • In a chat, she only fetches from a thread a search turned up in that chat. An automation on the Mailbox trigger reads the attachments of the message it was handed.
  • A zip isn’t unpacked: she lists what’s inside, and you ask for the file you want. A small zip arriving on a Mailbox trigger is unpacked.
  • From Outlook, a OneDrive or SharePoint link, or a forwarded message inside another, has no file, and Ronja says so.

Ask Ronja in a Build mode chat to have a workflow send as a connected mailbox, so a nightly report comes from your address. Sending is all a workflow can do with a mailbox: reading, replying and triage stay with the agent.

Attaching a mailbox to a workflow requires an Admin: a non-admin’s save of a workflow that sends as a mailbox is refused, telling them to ask an Admin. A workflow’s sends obey the mailbox’s Compose recipients and Daily send limit.

Compose recipients — who Ronja can send new mail to

Section titled “Compose recipients — who Ronja can send new mail to”

Compose recipients on the mailbox card limits where new mail from the mailbox may go. Add whole domains (acme.com) or exact addresses (vip@partner.com). A domain matches exactly: acme.com admits alice@acme.com but not alice@mail.acme.com.

The list is New mail can go to
Empty (the default) Anyone your email provider allows, from a chat (where you approve each send), an automation or a workflow.
Set From an automation or a workflow, only addresses on the list. An Admin’s own sends from a chat aren’t limited, because each is approved.

The list also covers people copied in; questions Ronja emails from the mailbox, always as for an automation, so a list narrowed to your customers’ domains refuses a question to your own colleague; and everything a Mailbox-triggered automation sends as new mail, including from Ronja’s own address. Replies are never limited by it: a reply goes back to whoever wrote in.

New mail and questions must also pass your organization’s Agent email policy (Governance → Organization rules): people in your organization always pass, and an outside address depends on whether it is Members only, Members + allowed domains or Anyone. An address must pass both.

You can ask Ronja to copy people into a new email, from a connected mailbox or from her own address:

  • They pass the same checks as the main recipients, including the mailbox’s Compose recipients, and count toward the daily budget. One email reaches at most 20 people, counting main recipients and copied-in people together.
  • If every copy is refused, the email still goes to its main recipients and Ronja says so. If the main recipients are refused, nothing is sent.
  • There is no Bcc, and a reply is never copied to anyone new.

Daily send limit — how much mail a mailbox may send

Section titled “Daily send limit — how much mail a mailbox may send”

Daily send limit on the card is the most recipients the mailbox may email in a rolling 24 hours; one email to ten people counts as ten. Leave it empty for the default of 500, or set up to 10,000. It covers all mail sent as the mailbox, whoever or whatever asked: an Admin in a chat, a Saved Agent, an automation, a workflow, and questions Ronja emails from it. Each mailbox has its own, separate from the organization-wide cap on mail from Ronja’s own address.

Watched label — which mail Ronja looks at

Section titled “Watched label — which mail Ronja looks at”

Watched label on the card limits which mail Ronja watches. Leave it empty for all incoming mail, or enter a name to watch only mail filed under it: a label on Gmail; on Outlook, a folder, or else a category. A change applies to mail from then on.

To have Ronja work the mailbox on her own, use an automation with a Mailbox trigger that runs a Saved Agent. It fires when new mail arrives, one run per message.

  1. Ask Ronja for the automation in a chat (see Schedule an automation).
  2. Choose the Mailbox trigger, and pick this mailbox as the Watched mailbox. Attaching a mailbox is Admin only.
  3. Optionally, narrow what fires it under Filters (optional): sender domains (matched exactly), sender addresses, subject terms, or attachments only. Leave them blank to run on every new message.
  4. Give the Saved Agent this mailbox as a reference, and pre-approve the reply if it should send without a person (References and pre-approved actions). Without the reference the automation runs but can’t read, reply to or triage the mailbox; Ronja warns you when you save it.

A Watched label applies first; the filters narrow one automation within it. Expect:

  • Only new mail fires it, minutes after it lands, however narrow your filters are, and Ronja looks back only 6 hours (Mailbox). If checks fail for longer (an outage, a mailbox that needs reconnecting, your provider rate-limiting the account), treat that period’s mail as needing a person.
  • Spoofed mail isn’t answered. An automated reply is never sent to a message that fails sender authentication; it is left for a person.
  • A search looks back a week. An automation searching the mailbox without naming an age searches the last 7 days. To reach older mail, say so in its instructions, such as “search the last 60 days”.

For a periodic sweep, such as a morning summary, use a Schedule trigger; it runs at most once an hour.

A question Ronja emails a colleague from this mailbox becomes a thread in it, filed with its follow-ups under a label of hers. Automations never see those threads, so none answers the colleague as if they were a customer, and an automation’s reports leave them out; a reply goes to the waiting run and starts no new one. You still see them, left unread.

Ronja checks a waiting question’s thread until it is answered or times out, every couple of minutes at first and less often as hours pass; nothing else is read on that schedule. See Let a saved agent ask a person.

A mailbox that isn’t working stays on the page with an amber note on its card.

The card says What happened What to do
That account has no mailbox No inbox of its own: on Google, likely a Group or Gmail is off; on Microsoft, no mailbox licence, or a shared mailbox. Sign in as a Workspace user with Gmail on, or a licensed Microsoft 365 user.
That mailbox is already connected The account is already connected here. Disconnect this duplicate; the original keeps working. To re-authorize the original, use Reconnect on its card.
Reconnected as a different account You signed in as another account during Reconnect. Sign out, or use a private window, and reconnect as the address the mailbox shows.
Ronja could not verify this mailbox The check failed, usually briefly. Click Reconnect in a few minutes.
Connecting was never finished The popup was closed. Click Reconnect to finish, or Disconnect to clear it.
A reconnect was never finished A Reconnect popup was closed, so Ronja paused the mailbox to be safe. Click Reconnect and finish as the same address.

Reconnect re-runs the sign-in and must use the same address; it never moves a mailbox to another account. Use it when the card reads Needs reconnect. On a healthy mailbox it changes nothing, but if you close its popup without finishing, the mailbox pauses after about 15 minutes. Pending means a connection was started but hasn’t come back yet.

  1. Click Disconnect on the mailbox card.
  2. Confirm.

Ronja deletes the stored credential, withdraws her access where the provider allows it, and stops reading and replying at once. Mail already sent stays sent, and nothing in the mailbox changes.

Every automation on a Mailbox trigger watching it is switched off, saying why. Connecting the address again makes a new mailbox: in each automation, pick it in the trigger, save, and switch it on (a plain re-enable is refused while it points at the old one). Mail that arrived while it was off isn’t worked.

To finish removing access at the provider:

  • Gmail: Ronja asks Google to withdraw access. If Google doesn’t confirm, Ronja tells you so and shows the manual step: remove Ronja under Google Account → Security → Your connections to third-party apps & services.
  • Outlook: Microsoft lets no app withdraw its own access. Ronja can no longer use the mailbox; as an optional tidy-up, remove the authorization at myapplications.microsoft.com → Ronja → Revoke permissions.