Widget Overview

The Keva Widget is a lightweight, embeddable chat interface that allows your customers to start support conversations directly from your website or application. It connects to your Keva workspace and automatically routes conversations to your AI agent.

Features

• Real-time messaging - Instant message delivery with typing indicators
• Pre-chat forms - Collect customer information before starting conversations
• File attachments - Support for images, PDFs, and documents up to 5MB
• Markdown support - Rich text formatting in agent responses
• Mobile responsive - Optimized for all screen sizes
• Shadow DOM isolation - Styles are encapsulated and won't conflict with your site

Quick Start

Add the widget to your site with a single script tag:

<script
  src="https://app.keva.support/widget/keva-widget.js"
  data-api-key="keva_live_your_api_key"
  async
></script>

The widget will automatically appear as a floating button in the bottom-right corner of your page.

How It Works

1. Customer opens widget - Clicking the launcher button opens the chat panel
2. Pre-chat form - Customer enters their email and any required fields
3. Conversation starts - A new ticket is created in Keva
4. AI responds - Your configured AI agent processes and responds
5. Real-time sync - Messages are delivered instantly via Server-Sent Events

Requirements

• A Keva account with an active workspace
• A widget API key (generate in Settings > API Keys)
• HTTPS enabled on your website (required for secure connections)

Next Steps

Browser Support

The widget supports all modern browsers: