Skedva Documentation

Everything you need to set up, configure, and extend Skedva for your business.

Quick Start Widget Setup API Reference Webhooks

Quick Start

Get Skedva running on your website in under 5 minutes. Follow these three steps:

Create your account

Install the widget

Copy the widget code from your dashboard (Settings → Widget) and paste it before the closing </body> tag of your website.

<script src="https://skedva.com/widget.js" data-api-key="YOUR_API_KEY"></script>

Train your AI

Go to Knowledge Base in your dashboard. Upload your FAQs, product information, or help articles. Skedva will learn from them and start answering visitor questions accurately.

Platform Overview

Skedva is a full-stack AI sales and support platform. Here's how the system is architected:

Chat Widget

Embeddable widget for your website. Handles real-time messaging with AI-powered responses.

AI Engine

GPT-4.1-nano powered. Trained on your knowledge base, canned responses, and conversation history.

Lead Management

Automatic lead capture, scoring, qualification, and CRM sync.

Automation Engine

Rule-based automation with triggers, conditions, and actions. No-code workflow builder.

Analytics

Real-time dashboards, daily AI summaries, conversion funnels, and team performance metrics.

Security

Encryption at rest, RBAC, CSRF protection, rate limiting, audit logging, and 2FA support.

Tech Stack

Backend: FastAPI (Python 3.11)

Frontend: Next.js 14 (React 18)

Database: PostgreSQL 15

Cache: Redis 7

AI: OpenAI GPT-4.1-nano

Monitoring: Prometheus + Grafana

Widget Installation

The Skedva chat widget can be installed on any website with a single line of code.

Basic Installation

<script src="https://skedva.com/widget.js" data-api-key="YOUR_API_KEY"></script>

Configuration Options

Attribute	Type	Description
data-api-key	string	Your unique API key (required)
data-position	string	"bottom-right" (default) or "bottom-left"
data-color	string	Primary brand color (hex)
data-greeting	string	Custom greeting message
data-language	string	Language code (en, es, fr, etc.)

Platform-Specific Guides

WordPress

Add to theme footer

Shopify

Add to theme footer

Webflow

Add to theme footer

Squarespace

Add to theme footer

Wix

Add to theme footer

Custom HTML

Add to theme footer

AI & Automation

AI Response Pipeline

When a visitor sends a message, Skedva processes it through a multi-stage pipeline:

Intent Detection

Classifies the message into one of 120+ intents (pricing, support, sales, etc.)

Knowledge Base Lookup

Searches your KB articles for relevant information to include in the response

Canned Response Match

Checks 200+ canned responses for exact or fuzzy matches

AI Generation

If no canned match, generates a contextual response using GPT-4.1-nano

Fallback

If AI credits are exhausted, uses a graceful fallback response or escalates to human

Automation Rules

Create no-code automation rules with triggers, conditions, and actions:

Triggers

• New conversation
• Message received
• Lead captured
• Conversation idle
• Keyword detected

Conditions

• Lead score threshold
• Time of day
• Channel type
• Visitor location
• Conversation count

Actions

• Send auto-reply
• Assign to agent
• Tag conversation
• Send email alert
• Create CRM record

API Reference

Skedva provides a RESTful API for full programmatic access. Base URL: https://skedva.com/api/v1

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_JWT_TOKEN

Widget endpoints use X-API-Key header instead of Bearer tokens.

Endpoints

Method	Endpoint	Description
POST	/api/v1/auth/signup	Register a new user account
POST	/api/v1/auth/login	Authenticate and receive JWT tokens
POST	/api/v1/auth/refresh	Refresh an expired access token
GET	/api/v1/conversations	List all conversations for your business
GET	/api/v1/conversations/:id	Get a single conversation with messages
POST	/api/v1/widget/message	Send a message via the chat widget
GET	/api/v1/leads	List all captured leads
PATCH	/api/v1/leads/:id	Update lead status or score
GET	/api/v1/automations	List automation rules
POST	/api/v1/automations	Create a new automation rule
GET	/api/v1/kb	List knowledge base articles
POST	/api/v1/kb	Create a knowledge base article
GET	/api/v1/analytics/daily	Get daily analytics summary
GET	/api/v1/canned-responses	List canned responses
POST	/api/v1/canned-responses	Create a canned response

Example: Send a Widget Message

curl -X POST https://skedva.com/api/v1/widget/message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"message": "What are your pricing plans?", "session_id": "visitor-123"}'

Webhooks

Receive real-time notifications when events happen in Skedva. Configure webhook URLs in your dashboard under Settings → Webhooks.

Available Events

conversation.created

A new conversation is started by a visitor

{ conversation_id, visitor_id, channel, timestamp }

conversation.closed

A conversation is marked as resolved

{ conversation_id, resolved_by, duration, timestamp }

message.received

A new message is received in a conversation

{ message_id, conversation_id, content, sender_type }

lead.captured

A new lead is captured from a conversation

{ lead_id, name, email, phone, score, source }

lead.qualified

A lead is marked as qualified by AI or manually

{ lead_id, score, qualification_reason }

automation.triggered

An automation rule has been triggered

{ rule_id, trigger_event, actions_executed }

agent.assigned

A human agent is assigned to a conversation

{ conversation_id, agent_id, assignment_reason }

Webhook Security

All webhook payloads include an X-Skedva-Signature header with an HMAC-SHA256 signature. Verify this signature to ensure the webhook is authentic.

import hmac, hashlib

def verify_webhook(payload, signature, secret):
    expected = hmac.new(
        secret.encode(), payload, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

Integrations

Connect Skedva with the tools you already use.

HubSpot

Available

Sync leads, contacts, and deals. Auto-create HubSpot contacts from captured leads.

Salesforce

Available

Push qualified leads to Salesforce. Map custom fields and create opportunities.

Slack

Available

Receive real-time notifications for new conversations, leads, and escalations.

WhatsApp Business

Available

Handle WhatsApp messages directly from Skedva. Full two-way messaging support.

Gmail / Outlook

Available

Send follow-up emails directly from Skedva. Track opens and replies.

Zapier

Available

Connect Skedva to 5,000+ apps. Trigger Zaps on any Skedva event.

Stripe

Built-in

Manage billing and subscriptions. Built-in payment processing for your plans.

Custom Webhooks

Available

Send event data to any HTTP endpoint. Full payload customization.

Agency Guide

Manage multiple client accounts from a single agency dashboard. White-label Skedva and resell it under your own brand.

Agency Features

Multi-tenant client management

White-label branding

Custom domains per client

Per-client analytics

Centralized billing

Client onboarding templates

Role-based access for clients

Bulk automation deployment

Setting Up Client Workspaces

1Navigate to Agency Dashboard → Clients → Add Client
2Enter client business details (name, domain, industry)
3Configure white-label settings (logo, colors, custom domain)
4Deploy the widget code to your client's website
5Upload client-specific knowledge base articles and canned responses

Frequently Asked Questions

How do I install the chat widget?

Add a single <script> tag to your website. The widget code is available in your dashboard under Settings → Widget. It works with any website, CMS, or landing page builder.

What AI model does Skedva use?

Skedva uses OpenAI GPT-4.1-nano for fast, cost-effective responses. The AI is fine-tuned with your knowledge base, canned responses, and conversation history to provide accurate, business-specific answers.

Can I use my own domain for the widget?

Yes! Agency Pro and Enterprise plans include custom domain support. You can serve the widget from your own domain with full white-label branding.

How does lead scoring work?

Skedva AI analyzes conversation context, engagement patterns, and intent signals to assign a lead score from 0-100. You can customize scoring criteria in the automation settings.

Is my data secure?

Yes. Skedva uses encryption at rest (AES-256), TLS 1.3 in transit, role-based access control, audit logging, and CSRF protection. We follow SOC 2 compliant architecture practices.

Can I integrate with my existing CRM?

Skedva integrates with HubSpot, Salesforce, and other CRMs via our API and Zapier. Direct CRM token persistence is built in for seamless lead syncing.

What happens when the AI can't answer a question?

Skedva gracefully escalates to a human agent. The full conversation context is preserved so the agent can pick up right where the AI left off. You can configure escalation rules in automation settings.

Do you support WhatsApp?

Yes! Skedva supports WhatsApp Business API integration. You can receive and respond to WhatsApp messages directly from your Skedva dashboard.

Ready to get started?

Create your free account and have Skedva running on your website in under 5 minutes.

Start Free Trial