Connect an integration
Use this guide to connect the services available under Settings → Integrations: Email, WhatsApp, and Google Calendar. Each has its own section below, with related settings and the place to use the connection.
This topic covers the Integrations page at /user-profile-settings/integrations, linked from Settings → Integrations.
Who can do this
Owners and Admins can access integration settings. Other users need the relevant Integrations permissions; viewing and editing are separate permissions. The available connection options also depend on the integration.
Before you begin
- Confirm with your workspace Owner or Admin that the required service and access are available.
- Have admin access to the external account (Google Workspace, WhatsApp Business, SMTP credentials).
- Allow browser pop-ups for provider sign-in flows (Gmail, Outlook, Google Calendar).
- Know your plan limits—especially WhatsApp instances (connecting multiple numbers may require an upgrade).
In this guide
Each integration shows its available connection options and status on this page. After connecting one, check the related Inbox channel, email feature, or Calendar.
Open Integrations
- Open Settings (
/settings). - Under the Integrations card, select Email, WhatsApp, or Google Calendar (all route to the same page).
- Or navigate directly to
/user-profile-settings/integrations. - Review integration cards:
| Card | Provider | Enables |
|---|---|---|
| Gmail, Outlook, or SMTP | Connect an email account for supported workspace email features | |
| Workspace WhatsApp connection | WhatsApp conversations in Inbox | |
| Google Calendar | Schedule meetings, availability, invites |
Each card shows the connection options available for that integration.
Connect Email
Email provider options
| Method | Best for |
|---|---|
| Gmail (OAuth) | Individual reps on Google Workspace or Gmail |
| Outlook (Microsoft 365 / Outlook.com) | Sign in with a Microsoft email account |
| SMTP | Custom mail servers, transactional providers, Mailgun-style SMTP |
Procedure — Gmail
- On Integrations, select Email → Connect.
- Choose Gmail (if prompted).
- Complete Google sign-in in the pop-up window.
- Grant permissions requested by SWS Agent.
- Return to Integrations—the Email card shows connected.
Procedure — Outlook
- Select Email → Connect.
- Choose Outlook or the Microsoft sign-in option.
- Sign in to the Microsoft account and review the requested access.
- Return to Integrations and confirm the Email connection status.
Procedure — SMTP
- Select Email → Connect → SMTP.
- Enter SMTP host, port, username, password, and from-address as shown.
- Save the connection. If the page offers a Test button, run it to check the settings.
Verify:
- Email card status = connected
- Open a Contact → send or log an email action
- Check Inbox for sync (may take a few minutes on first connect)
Connect WhatsApp
- Open Settings → Integrations and select WhatsApp.
- Review the connection options shown for your workspace and complete the available connection steps.
- Return to Integrations and check the WhatsApp connection status.
- To adjust how WhatsApp works across the workspace, open Communications settings.
- To create reusable WhatsApp messages, open Settings → Templates → WhatsApp Templates.
- To read and reply to conversations, open Inbox → WhatsApp.
If WhatsApp does not appear in Inbox, check the connection status and your Inbox channel access.
Connect Google Calendar
- Select Google Calendar → Connect.
- Sign in with the Google account that should own meeting bookings.
- Grant calendar permissions.
- Return to Integrations—Calendar shows connected.
Verify:
- Open Calendar (
/calendar) and confirm events sync - Create a test booking link if you use Appointment types
After connecting — workspace checklist
| Channel | Next step |
|---|---|
| Email domains before bulk campaigns | |
| Communications settings and WhatsApp templates | |
| Calendar | Appointment types + Calendar links |
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| OAuth window closes instantly | Pop-up blocker | Allow pop-ups for SWS Agent domain |
| Wrong provider account connected | Signed into the wrong provider account in browser | Sign out of the provider and reconnect with the intended account |
| WhatsApp is missing from Inbox | Channel connection or access | Check the WhatsApp status above and your Inbox channel access |
| Connected but Inbox empty | Sync delay or wrong folder | Wait 5–10 min; check Inbox folders |
| Microsoft sign-in fails | Wrong Microsoft account or access not granted | Retry with the intended Microsoft account and complete the consent prompt |
| SMTP auth failed | Wrong port/TLS or password | Verify SMTP settings with IT |