Skip to content

Integration Checker

The Integration Checker allows system administrators to test, manage, and activate cloud storage integrations for CallCoach. This tool enables organisations to configure their own cloud storage (AWS S3, Azure Blob Storage, or Google Cloud Storage) for call recording ingestion.

Beta Feature — Restricted Access

The Integration Checker is currently in beta testing and available only to users with the sys_admin role. Beta access must be granted by CallCoach Support.

Accessing the Integration Checker

Navigate to /integration-check in your CallCoach Dashboard.

Key Features

  • Multi-Cloud Support — configure integrations with AWS S3, Azure Blob Storage, or Google Cloud Storage
  • Integration Testing — comprehensive testing of connectivity, permissions, and file operations before activation
  • Integration Management — view, test, activate, deactivate, and delete existing integrations
  • Active/Inactive Status — only one integration can be active per organisation at a time
  • Verification Tracking — last verified timestamp for each integration
  • Secure Credential Storage — all credentials are end-to-end encrypted using AES-256 encryption

Viewing Existing Integrations

The page displays all configured integrations with their status (Active/Inactive). Each integration tile shows bucket name, prefix, region (for AWS), and last verification date. Active integrations are highlighted with a green badge.

Adding a New Integration

  1. Click Add New Integration to expand the wizard
  2. Step 1 — select your cloud storage type (AWS S3, Azure Blob Storage, or Google Cloud Storage)
  3. Step 2 — enter your credentials:
    • Integration Name (descriptive identifier)
    • Bucket/Container Name
    • Prefix/Folder Path (where recordings are stored)
    • Cloud-specific credentials (access keys, account keys, or service account JSON)
  4. Step 3 — run the integration test to verify permissions

Testing an Integration

Click Test Connection on any integration tile. The system tests stored credentials without requiring re-entry. Test results show detailed pass/fail status:

Test Description
List files with prefix Can access and list files
Download file Read permissions
Save file Write permissions
Delete file Delete permissions
Move file Copy permissions
Generate signed URL Optional — won't block integration if it fails

The "Last verified" timestamp updates upon successful test.

Activating an Integration

  1. Click Activate on an inactive integration
  2. The system automatically tests the integration first
  3. If tests pass, the integration becomes active and all others are deactivated

Important

After activating an integration, contact support@icana.ai to switch CallCoach from the standard backend configuration to use your active integration.

Deactivating / Deleting

  • Deactivate — click Deactivate on an active integration. A confirmation dialog appears. No testing is performed.
  • Delete — click the trash icon on any integration tile. The integration is permanently removed.

Visual Indicators

  • Active Integration — full opacity, green "Active" badge with checkmark icon
  • Inactive Integration — reduced opacity (70%), grey "Inactive" badge with dash icon
  • Verified — green checkmark with last verified timestamp
  • Unverified — warning triangle indicating integration hasn't been tested yet

Common Questions

Can I have multiple active integrations?

No, only one integration can be active per organisation at a time. Activating a new integration automatically deactivates all others.

What happens if my integration test fails?

Review the detailed test results to identify which checks failed. Common issues include incorrect credentials, insufficient permissions, incorrect bucket name or prefix, and network connectivity issues. Contact support@icana.ai for assistance.

Do I need to re-enter credentials to test an existing integration?

No, the system uses stored credentials when testing existing integrations. Credentials are only entered once during initial setup.

Can I update the credentials for an existing integration?

Currently, you need to delete the integration and create a new one with updated credentials.

Why is signed URL generation optional?

Signed URL generation is used for temporary access to files but is not critical for core CallCoach functionality. If this test fails, the integration can still be activated and used successfully.