Connect UI

Connect UI provides a fully browser-based interface for integration setup. It enables end users to authenticate and connect to third-party services via a secure, pre-generated URL—without requiring you to build or maintain any frontend components.

Benefits

• Fast proof of concept of Unizo demonstrates the power of integration layer without making frontend changes
• No app login required for your users, they can authorize integrations independently of your app
• Fully customizable with your branding and domain
• Multiple layout options including embedded and pop-up modes

Connect UI drop-in integrations

Configure Connect UI

Configuring Connect UI serves as the foundational step for your Connect UI integration. It acts as a container that holds all the necessary settings and credentials required for your application to communicate with the Connect UI service.

How to Configure Connect UI

1. Navigate to the Connect UI Section from Unizo Console

2. Click the Add Configuration button

Configure Connect UI

3. Configure Settings

   • Name: Enter a descriptive name to identify this Connect UI (e.g., "App Sec UI")
   • Custom Domain: Configure your DNS to map a custom URL to Unizo’s platform. By doing so, you replace the default Unizo base URL (https://dock.unizo.ai) with your branded domain, giving your customers a fully white-labeled experience when accessing the Connect UI workflows.

4. Layout: Choose between:

   • Embedded – Renders inside your app page
   • Pop-up – Displays a modal without leaving the page

5. Copy the ID

   • Once the Connect UI is configured, locate the generated Dock ID
   • Copy this ID to your clipboard or note it down securely

Generated Dock Id

Using the Dock ID for Service Key Generation

The Dock ID serves as a reference point when generating service keys. You'll need to:

• Use this ID in API calls for authentication
• Reference it when configuring your Connect UI instance

Creating Connect UI Links from Unizo Console

Connect UI from Unizo Console

1. Navigate to the Connect UI section from the left menu
2. Configure Connect UI as mentioned in Creating Dock profile above
3. Choose the created configuration, select Test Run, and provide:
   • Customer Key: Required field used to uniquely identify the customer
   • Customer Name (optional): For internal visibility
   • Category: Select integration category
4. Click Generate URL

You will be presented with a unique URL that can be used to test the authentication experience before integrating into your product.

Note: The URL will expire within 30 minutes

Webhook Configuration

To automatically receive Integration IDs for new connections, you'll need to set up a Platform webhook in your Unizo Console. This webhook will notify your system in real-time whenever a new integration is established.

Configure Platform Category Webhook

How to set it up:

1. Go to your Unizo Console
2. Navigate to Setup Integrations → Webhooks
3. Add a new webhook with the 'Platform' category
4. Configure your endpoint URL to receive the webhook notifications

Once configured, you'll automatically receive the integrations.id , serviceKey.id in the webhook payload whenever a new connection is created, making it easy to track and process integrations.

Connect UI Integration Webhook Payload Example

{
  "version": "1.0.0",
  "type": "integration:created",
  "schemaId": "1.0.0",
  "contentType": "application/json",
  "createdDateTime": "2025-05-19T09:59:45.151695057Z",
  "integration": {
    "id": "e9faf151-cefa-4e71-99b9-5b20c5257955",
    "name": "Gi_Acme_1747648785063",
    "type": "TICKETING",
    "changeLog": {
      "createdDateTime": 1747648784897,
      "lastUpdatedDateTime": 1747648784897
    },
    "serviceKey": {
      "id": "196e7fbcbd02ba914e345ec4a14"
    },
    "subOrganization": {
      "externalKey": "e12bcb82-8ec7-4237-ad91-89e6419a76fe",
      "name": "Acme Corp"
    }
  }
}

---

For additional support, contact our team at support@unizo.ai.