Integrations

Connect Operanix to your existing tools and workflows through four integration methods — Workflow Builder, REST API, Webhooks, and Chat Widget.

Overview

Operanix connects to your technology stack through four complementary methods:

Workflow Integrations (n8n)

The Workflow Center includes a built-in n8n integration that connects Operanix to 400+ external tools through a visual drag-and-drop builder.

Connecting Tools

1. Navigate to Workflow Center → Tool Connections tab
2. Click Add Connection and select the tool category
3. Authenticate with your credentials (OAuth or API key)
4. The connection is now available in all workflow automations

Supported Platforms

REST API Integration

The Operanix REST API provides programmatic access to the full platform. Use it for server-to-server integrations, custom dashboards, or CI/CD pipeline triggers.

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from Settings → API Keys.

Authorization: Bearer op_live_xxxxxxxxxxxxxxxxxxxx

Base URL

https://api.operanix.com/v1

Quick Start Example

Create a task assigned to the Sales agent:

curl -X POST https://api.operanix.com/v1/tasks \
  -H "Authorization: Bearer op_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Research Acme Corp",
    "agent": "sales",
    "priority": "high",
    "description": "Compile a prospect brief for Acme Corp"
  }'

Webhook Events

Webhooks deliver real-time event notifications to your systems via HTTP POST requests.

Registering Webhooks

1. Navigate to Settings → Webhooks
2. Click Add Webhook
3. Enter your endpoint URL and select the event types to subscribe to
4. Operanix sends a test ping to verify connectivity

Signature Verification

Every webhook request includes an X-Operanix-Signature header containing an HMAC-SHA256 signature. Verify this signature using your webhook secret to confirm the request originated from Operanix.

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Event Types

Chat Widget

Embed an Operanix agent on any website with a single line of HTML.

Embed Code

<script src="https://widget.operanix.com/chat.js"
  data-tenant="your-tenant-id"
  data-agent="support"></script>

Customization Options

Hosted Chat Alternative

If you prefer not to embed code, share a hosted chat URL instead:

https://chat.operanix.com/your-tenant-id/support

Share this link on social media, in emails, or as a QR code. No code required — the page is fully hosted by Operanix.

SSO Integration

Operanix supports single sign-on for enterprise teams, enabling centralized authentication and automated user provisioning.

Supported Providers

• Google Workspace — OAuth 2.0
• Microsoft Entra ID — OAuth 2.0 / OIDC
• Okta — SAML 2.0 / OIDC
• OneLogin — SAML 2.0
• Generic SAML / OIDC — Any identity provider supporting SAML 2.0 or OpenID Connect

Setup Steps

1. Navigate to Settings → Authentication → SSO
2. Select your identity provider from the dropdown
3. Enter your SSO metadata URL (or upload the XML metadata file)
4. Map identity provider groups to Operanix roles
5. Enable JIT (Just-In-Time) provisioning to auto-create user accounts on first login
6. Test the connection with a sample login

Role Mapping

Map your identity provider groups to Operanix RBAC roles: