Widget API & Embed Code

Widget Embed Code

Embed the Operator widget on any website using this standard script tag:

<script src="https://app.operator.ai/widget.js" data-org-id="YOUR_ORGANIZATION_ID"></script>

When loaded, the script checks domain whitelisting, retrieves the organization's branding theme, and renders the floating launcher.

Widget Configuration API

• Endpoint: GET /api/widget/config?orgId={organizationId}
• Authentication: Public with Origin verification.
• Response:

{
  "enabled": true,
  "theme": {
    "themeMode": "light",
    "primaryColor": "#7a5af8",
    "borderRadius": "0.75rem"
  },
  "branding": {
    "companyName": "Acme Family Dental",
    "tagline": "24/7 AI Receptionist",
    "welcomeMessage": "Hi! How can I help you book or answer questions today?"
  },
  "launcher": {
    "position": "bottom_right",
    "icon": "message-square",
    "size": "medium"
  },
  "customization": {
    "starterQuestions": [
      "What are your business hours?",
      "How do I book an appointment?",
      "What services do you offer?"
    ]
  }
}

Session Creation API

• Endpoint: POST /api/widget/session
• Request Body:
• `json
• {
• "organizationId": "org_uuid_here",
• "clientMetadata": {
• "referrer": "https://google.com",
• "userAgent": "Mozilla/5.0..."
• }
• }
• Response:
• `json
• {
• "sessionId": "ses_uuid_here",
• "conversationId": "conv_uuid_here",
• "welcomeMessage": "Hi! How can I help you book or answer questions today?"
• }

Chat Exchange API

• Endpoint: POST /api/widget/chat
• Request Body:
• `json
• {
• "organizationId": "org_uuid_here",
• "conversationId": "conv_uuid_here",
• "message": "Do you have any openings this Friday morning?"
• }
• Response: Returns assistant text, suggested time slots, and citation metadata.