Connect an agent's Microsoft 365 mailbox

Sign in each agent's mailbox and its supervisor's mailbox so the agent can work with Outlook mail and calendar.

Before you start

  • Your company's Microsoft Entra app is set up in Boatwork, and the agent is allowed under Agent access.
  • The sign-in for the agent's own mailbox and for the supervisor's mailbox.
  • If your Microsoft tenant asks for admin approval, your IT administrator on a call or screen share, so they can approve it live.

Tip: use a private or incognito browser window, so Microsoft does not sign you in with the wrong account automatically.

Connect the agent mailbox

  1. On your company's Overview, click the agent's name. In the agent's left menu, click Connectors, then Microsoft 365.

  2. Next to Agent mailbox, click Connect agent mailbox.

    Agent's Microsoft 365 page with Connect agent mailbox and Connect supervisor mailbox highlighted
    The agent's Microsoft 365 page
  3. Microsoft opens. Sign in as the agent's mailbox. The account you finish signing in with must be the agent's mailbox.

  4. If Microsoft shows Need admin approval or asks an administrator to approve, your IT administrator signs in and approves it. You return to Boatwork when it finishes.

Connect the supervisor mailbox

The supervisor is the person the agent works for. Connect their mailbox when the agent should work with the supervisor's mail, calendar or OneDrive.

  1. Next to Supervisor mailbox, click Connect supervisor mailbox.

  2. Sign in as the supervisor. Your IT administrator approves if Microsoft asks.

Check the connection

  1. On the agent's Microsoft 365 page, Agent mailbox and Supervisor mailbox both say Connected.

  2. Repeat for each agent. The company Connectors → Microsoft 365 page lists every agent mailbox under Agent mailboxes.

Reconnect a mailbox

If every mailbox in your company shows Needs reconnecting at the same time, the Entra client secret has most likely expired. Renew the client secret; the mailboxes then reconnect on their own.

If only one mailbox is affected, open the agent's Microsoft 365 page, click Re-authorize (agent mailbox) or Connect supervisor mailbox, and sign in again as above.

Troubleshooting

You seeWhat to do
"The signed-in account doesn't match … mailbox"Microsoft finished with the wrong account. Use a private window and sign in as the agent's mailbox.
"That mailbox is already connected to the other slot"The same mailbox is on both Agent and Supervisor. Disconnect it from one, or use a different mailbox.
"Need admin approval"Your IT administrator approves the request, or grants admin consent for the app.
No Connect agent mailbox buttonAllow the agent under Agent access on the company Microsoft 365 page.