Skip to content

SaaS Integrations ​

Overview ​

Connect your company's SaaS tools — HR systems, CRM, ticketing, communication — so the AI understands your organization. Data is PII-filtered before it reaches the AI, source-attributed in responses, and fully audit-logged.

INFO

SaaS Integrations require a Personal or higher subscription. Real-time webhooks, connector actions, and cross-connector intelligence require Business+. Unified API connectors (50+ platforms) require Enterprise.

Why Connect Your SaaS Tools? ​

Your AI is only as smart as what it knows. Without connectors, the AI has no context about your team, customers, or projects. With connectors, questions like "Who's on the engineering team?" or "What's Alice's role?" just work — with source attribution so you know where the answer came from.

How It Works ​

  1. Choose a connector from the catalog in Settings → SaaS Integrations
  2. Authorize via OAuth — a consent dialog explains exactly what data will be synced and what PII fields (SSN, salary, DOB) are never synced
  3. Data syncs automatically on a configurable schedule (or in real-time via webhooks on Business+ plans)
  4. AI uses your organization's context in every conversation, with source attribution like [Source: Rippling, synced 2h ago]

Getting Started: Connect Rippling ​

  1. Navigate to Settings → SaaS Integrations
  2. Find Rippling in the connector catalog under "HRIS"
  3. Click "Connect" — a consent dialog appears explaining data access
  4. Click "Connect to Rippling" — an OAuth popup opens
  5. Authorize GhostAI in Rippling
  6. The popup closes and your first sync begins automatically
  7. When complete, you'll see "127 employees synced" with a suggestion: "Try asking: 'Who's on the engineering team?'"

Supported Connectors ​

ConnectorCategoryTypeTierStatus
RipplingHRISDirectPersonal+Available
Merge HRISHRIS (50+ platforms)Unified APIEnterpriseAvailable
SlackCommunicationDirectPersonal+Coming Soon
JiraTicketingDirectPersonal+Coming Soon
SalesforceCRMDirectPersonal+Coming Soon
NotionKnowledgeDirectPersonal+Coming Soon

Sync Modes ​

  • Scheduled Polling (all tiers): Data syncs on a configurable interval (default: every 60 minutes). Check sync status in the connection detail view. Trigger a manual sync anytime with the "Sync Now" button.
  • Real-Time Webhooks (Business+): Configure webhooks so changes in your SaaS tool (new employee, updated record) are pushed to GhostAI within seconds. Setup instructions are provided per connector in the Webhooks tab.

What Data Gets Synced? ​

Rippling — Synced Fields (safe for AI memory):

FieldExample
NameAlice Smith
Emailalice@acme.com
DepartmentEngineering
TitleSenior Engineer
RoleIC4
TeamPlatform
ManagerBob Jones
Work LocationSan Francisco
Employment TypeFull-time
Start Date2024-01-15
StatusActive

Rippling — NEVER Synced (PII-filtered):

FieldWhy
SSNSensitive PII
Salary / CompensationSensitive PII
Date of BirthSensitive PII
Home AddressSensitive PII
Bank Account InfoFinancial PII
Tax IdentifierSensitive PII
Emergency Contact PhoneSensitive PII
Personal PhoneSensitive PII

The raw data (including filtered fields) is stored AES-256-GCM encrypted in the connector records table for admin use. Only the safe fields above are written to AI memory.

Data Visibility & Access Control ​

Each connection has a visibility scope:

  • Organization-wide (default): All org members see this data in their AI sessions
  • Group-restricted: Only members of a specific group see this data
  • User-only: Only the connecting user sees this data

Admins can change visibility in the connection settings. The visibility scope maps directly to the memory scope used when writing to the AI memory system.

Source Attribution ​

When the AI uses connector-sourced data, responses include attribution:

Based on your Rippling data, the Engineering team has 23 members:
- Alice Smith (Senior Engineer, Platform team, SF)
- Bob Jones (Engineering Manager, Platform team, SF)
- ...

[Source: Rippling, synced 2h ago]

If data is older than 24 hours, the AI adds a staleness caveat.

Entity Resolution ​

Business+ Feature

Cross-connector intelligence requires a Business or Enterprise subscription.

When you connect multiple tools, GhostAI automatically matches entities across them. Alice from Rippling + Alice from Salesforce = one unified profile. The AI gets a complete picture without you doing anything.

Connector Actions ​

Business+ Feature

Connector actions require a Business or Enterprise subscription.

Some connectors support write operations that the AI can invoke during conversation — creating Jira tickets, sending Slack messages, updating Salesforce records. Actions that modify external systems require your confirmation before executing.

Security & Privacy ​

  • Token Encryption: OAuth tokens are encrypted with AES-256-GCM using per-organization encryption keys
  • PII Field Filtering: Sensitive fields (SSN, salary, DOB, home address) are never written to AI memory
  • Webhook Verification: Inbound webhooks are verified via connector-specific signature validation
  • Audit Logging: Every connector operation (connect, sync, disconnect, action) is logged
  • GDPR Consent: A consent dialog records admin approval before OAuth, with timestamp stored for compliance
  • Access Control: Per-connection visibility scoping ensures data reaches only authorized users

Disconnecting ​

When you disconnect a SaaS tool:

  1. The connection is revoked
  2. All synced records are soft-deleted
  3. All associated AI memories are permanently removed
  4. Webhook configurations are disabled
  5. An audit log entry is created

WARNING

Disconnecting permanently removes all synced data and AI memories from that tool. This cannot be undone.

Troubleshooting ​

OAuth popup blocked ​

Your browser may block the OAuth popup. Allow popups for this site and try again.

Token revoked from the SaaS provider ​

If you revoke GhostAI's access from the SaaS provider's settings, the connection will show "Expired" status. Re-authorize by clicking "Reconnect" in the connection detail view.

Duplicate connections ​

If two admins connect the same SaaS tool, records are deduplicated by external ID. No duplicate data enters the AI memory.

Terminated employees ​

Terminated employees are synced with a "[Terminated]" prefix in memory. Admins can configure auto-removal of terminated records.

Webhook payloads not arriving ​

Verify the webhook URL in your SaaS tool matches the URL shown in the Webhooks tab. Check that your firewall allows inbound POST requests from the SaaS provider's IP ranges.

Sync takes a long time ​

For large organizations (10K+ employees), the initial sync runs as a background task. Progress is shown in the connection detail view. Subsequent incremental syncs are much faster.

Connection shows "Expired" ​

The OAuth token has expired. Click "Reconnect" to re-authorize. GhostAI will attempt automatic token refresh, but some providers require manual re-authorization.

Data still visible after disconnect ​

AI memory is cleared immediately on disconnect, but active chat sessions may still show previously recalled data until the session ends.

Connector not available for my tier ​

Some connectors and features are tier-restricted. Check the Supported Connectors table above for tier requirements, or upgrade your subscription in Settings → Billing.

SOC 2 Type II Certified | BAA Available | HIPAA-Ready