Connect Data Sources
Connect an external source account or upload files so an organization Data Integration can sync documents. An Organization Admin connects the source account. Applications can retrieve its synced documents without a separate sign-in.
Required role
Applies to
How connections work
An Organization Admin connects an external source or uploads files through the Data Integration form. For external sources, the Data Integration and its assigned applications share the authorized account. Optiak reads source content during a sync and does not change the source files or pages.
Source access depends on the provider. For example, Google Drive reads files from one selected folder, while Notion reads pages shared with the Optiak integration in the authorized workspace. The Data Integration's scope determines which applications may use the setup, and each application must enable it before its requests can retrieve documents.
The following diagram illustrates the process of connecting data sources and retrieving information. The upper lane shows source content being prepared and indexed; the lower shows an application question retrieving matching passages, passing them to the model, and returning an answer.
Index documents
Answer a question
Before you connect
- Use an Organization Admin account to create Data Integrations and manage their connections.
- For an external source, have access to the account and content you want to sync. For File Upload, have the files ready.
- Confirm your organization permits connecting the external account to Optiak; obtain approval if required.
- Decide which projects or applications should access the documents, then set the Data Integration's Scope accordingly.
Available connections
Before you begin: Use a Google account that can access the folder you want to sync, and have the folder ID or URL ready.
Optiak uses Google OAuth to connect the account authorized by an Organization Admin. Every application using this Data Integration shares that account's access, so the account must be able to open the selected folder. Optiak syncs supported files directly inside that folder, not its subfolders.
To connect the account and set up the folder:
- In the console, open Company setup → Data integrations, select Add data integration, then choose Google Drive.
- In Connection, select Connect with Google Drive. In the authorization window, choose the Google account and approve access.
- Enter a Folder ID or paste the folder URL. Optiak stores the folder ID for this Data Integration.
- Set a name and Scope, keep Setup active turned on, and add the Data Integration.
- In the Data Integrations list, select Sync. The row shows the sync status and last sync time.
See Data Integrations for supported file types and sync limits.
Optiak connects to Notion with OAuth using an account authorized by an Organization Admin. Every application using this Data Integration shares that account's access to the workspace, limited to pages shared with the Optiak integration.
Use a Notion account that can access the workspace and pages you want Optiak to read. To connect the workspace and choose the pages to sync:
- In the console, open Company setup → Data integrations, select Add data integration, then choose Notion.
- In Connection, select Connect with Notion. In the authorization window, sign in to the Notion account and approve access to the intended workspace.
- In Notion, share the pages you want Optiak to read with its integration.
- Set a name and Scope, keep Setup active turned on, and add the Data Integration.
- In the Data Integrations list, select Sync. The row shows the sync status and last sync time.
See Data Integrations for sync limits.
File Upload needs no external account, authentication, or connection. You upload files directly to Optiak.
- In the console, open Company setup → Data integrations, select Add data integration, then choose File Upload.
- Choose the files in the setup form. They upload when you add the Data Integration.
- Set a name and Scope, keep Setup active turned on, and add the Data Integration.
When editing an existing Data Integration, file uploads and deletions take effect immediately. See Data Integrations for supported file types and upload limits.
After you connect
Connected sources sync when an Organization Admin starts a sync. Each sync adds new documents, updates changed ones, and removes documents no longer available from the source, such as files no longer in a selected Google Drive folder or pages no longer shared with the Notion integration. Source changes reach applications after the next sync. File uploads do not need a sync; added or deleted files take effect immediately. To sync a connected source again, select Sync on the Data Integration.
Set the Scope to include the projects or applications that need the documents. Application admins then open the application's Configuration → Data integrations and enable the setup. See Data Integrations for how retrieval works.
Troubleshooting
- Connection required: the connection was removed. Edit the Data Integration and connect the source account again. Reactivate the setup if it was deactivated, then sync it.
- Needs reconnect: the provider rejected the saved authorization. Edit the Data Integration, select Reconnect, and authorize the account again.
- Sync failed: check that the setup is active, the Google Drive folder ID is correct, or the intended Notion pages are shared with the integration. Reconnect if needed, then select Sync again.
- Syncing: a sync is already running. Wait for it to finish before starting another one.
Related
- Connections: how organization connections are shared.
- Data Integrations: configure sources, scope, and application access.
- Members and Access: organization roles and permissions.