To enable Harper to send and receive emails, Wisq integrates directly with Google. This allows Harper to communicate as a member of your HR team - responding to employees from a recognized, trusted email address at your organization.
Setting up the integration involves two main parts: creating a dedicated email address for Harper, and connecting that mailbox to Wisq.
If you have any questions about these steps, please contact your Wisq Customer Success Manager for assistance.
What Harper's Email Address Is Used For
Once configured, Harper's email address serves two purposes:
Outbound communications from Harper. When Harper needs to hand off a conversation or send a workflow notification, those emails will come from Harper's address. This ensures employees know the message is from Harper, not a generic inbox, and helps ensure deliverability within your organization.
Inbound emails to Harper. Employees can email Harper directly, and it works just like messaging her in the Wisq platform or through Slack/Teams. If an employee emails Harper, that conversation will appear in Wisq when they log in.
Shared Inboxes
In addition to Harper's dedicated mailbox, Wisq can also be configured to allow Harper to participate in shared inboxes at your organization - for example, hr@yourcompany.com. This means Harper can monitor and respond to messages sent to shared HR inboxes, giving employees a seamless experience regardless of how they reach out.
Shared inbox configuration is typically set up as a separate step after Harper's dedicated mailbox is live. We recommend starting with Harper's individual mailbox first, then expanding to shared inboxes once you've had a chance to review how Harper handles your scenarios. Your Wisq Customer Success Manager will guide you through this when the time comes.
How Wisq Accesses Mailboxes (and What We Don't)
Wisq connects to mailboxes using Application Access via Google Workspace Domain-Wide Delegation. This approach was chosen specifically to minimize friction for your IT team:
- No individual users need to log in or re-authenticate
- No popup logins, tokens to manage, or session expirations
- Access is limited to only the mailboxes you explicitly configure in the Wisq platform
Wisq does 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 specific email addresses you add in the Wisq platform. You may revoke access at any time from the Google Admin Console.
Prerequisites
- Google Workspace Admin privileges
- Ability to create new email accounts in your organization
- Access to Wisq Admin Console
Setup Steps
1. Create Harper’s Email Address
Following your organization’s procedures to create a new account, please set up a harper@yourcompany.com or harperai@yourcompany.com email address. (Please make sure your HR team has communicated and shared the address they would like you to create).
2. Notify Wisq Team
Contact your Wisq Customer Success Manager that Harper's email address has been created.
⚠️ Important: Wisq must complete configuration before you can proceed to Step 3. We will notify you (typically within 1 business day) when you can continue.
3. Google Admin Consent (One-Time Setup by Google Admin)
A Google Admin must grant consent for our application to access Gmail on behalf of your administration.
- In Google Admin, go to Security → Access and data control → API controls → Domain wide delegation → MANAGE DOMAIN WIDE DELEGATION
- Select Add new → Enter the Wisq client ID 104611147626225455461
- Enter the following OAuth scopes:
- Verify Configuration: Confirm the new entry appears in your Domain-wide delegation list
4. Configure Harper's Mailbox in Wisq
After admin consent is complete:
- Go to the Admin Console. Click on the Configure tab.
- Go to Emails (under Tools).
- Click Add email. Initially, we will only add Harper's dedicated email address here. If the Shared Inbox functionality is used, we will configure that at a later time.
- Complete the following fields:
- Provider: Select your company’s email provider from the dropdown. This will be 'Gmail'.
-
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: Enter Harper's email address
- Response Template: Harper's formatted email signature - your Wisq Customer Success Manager can help with formatting
- Enable Email: Toggle on to enable.
- Please be sure to Save
- Complete the following fields:
Once complete, Wisq will look like the below screenshot:
Now, Wisq/Harper will automatically:
- Create watch subscriptions for new emails
- Fetch message content and metadata securely
- Respond to messages or threads
-
Setup stays active until your admin revokes access.
Questions?
Contact your Wisq Customer Success Manager for assistance with any of these steps.
FAQ
Q: Do you access all our Gmail accounts?
A: No. We only access the accounts you configure in our web app.
Q: Will my users need to log in?
A: No. This integration uses domain-wide delegation and does not require individual logins.
Q: Can we revoke access?
A: Yes. You can remove our service account from the Admin Console anytime.
Q: Is this secure?
A: Yes. We use Google’s official service account + domain-wide delegation mechanism. All access is logged and restricted to configured mailboxes.