To enable Harper to automatically monitor and respond to emails, we’re asking you to set up an integration with Microsoft Outlook. This will allow Harper to manage incoming messages on behalf of your organization. If you have any questions about these steps, please contact your Wisq Customer Success Manager for assistance.
What This Integration Does
Once configured, Wisq will:
- Monitor specified inbox(es) for all incoming messages
- Automatically create or continue email threads as needed
- Delegate or hand off email messages if necessary
- Replies come from Harper (harper@[customername].com)
How We Access Mailboxes (and What We Don't)
We use Application Access via Microsoft Graph, which means:
- No individual users need to log in or re-authenticate every 90 days
- There are no popup logins, tokens to manage, or session expirations
- We only access inboxes you explicitly configure in our web app
We do not access all mailboxes in your organization. Even though application permissions allow broad access by default, our service only reads from and writes to the email addresses you add in our dashboard. You may further restrict access via Microsoft’s Application Access Policies, please see Step 4 below.
Setup Steps
1. Set Up Harper’s Email Address
Following your organization’s procedures to create a new account, please set up a harper@[customername].com email address.
2. Admin Consent (One-Time Setup by Global Admin)
A Microsoft 365 Global Administrator must grant consent for our application to access Microsoft Graph on behalf of your organization. That Global Administrator must also be a Wisq Space Administrator and logged in.
- Login to Wisq App.
- Click on the link: https://login.microsoftonline.com/common/adminconsent?client_id=71185fc2-6a11-4ece-bf15-67bb7f929c71&redirect_uri=https://api.wisq.com/api/externalChannels/outlook/authorize
3. Set Up Mailboxes in Wisq
After admin consent is complete:
- Go to the Admin Console. Click on the Configure tab.
- Go to Emails (under Tools).
- Add the email addresses you want our system to monitor and respond from
- Complete the following fields:
- Provider: Select your company’s email provider from the dropdown
- Inbox Type: When configuring harper@[customername].com, select Individual
- If Harper will also sit in a shared inbox at your organization, we will come back later to configure that address.
- Email Address: Please enter the address you’ve created for Harper at your organization
- Response Template: Harper’s formatted email signature - our team is happy to help with formatting.
- Enable Email: Toggle to the right to enable. If disabled, Harper will not send emails.
- Please be sure to Save
Once enabled and saved, Wisq/Harper will automatically:
- Set up Graph API subscriptions for new message notifications
- Fetch message content and metadata securely
- Respond to messages or threads
4. (Optional) Restrict Access to Only Specified Mailboxes
Although our app only uses the mailboxes you configure, you can enforce this at the tenant level by applying an Application Access Policy. Learn more about Role Based Access Control and configuration instructions here: https://learn.microsoft.com/en-us/exchange/permissions-exo/application-rbac