Getting Started with Velora!

Get your first AI agent up and running in under 5 minutes.

1. Create an account

2. Create an agent

From the dashboard, click "+ New Agent" or pick a template. Give your agent a name, type, and personality.

3. Train with documents

Go to Knowledge Base and upload PDFs, DOCX, TXT, CSV files or add URLs. Your agent indexes them automatically using hybrid search (combining meaning and keywords).

4. Test in the playground

Open the Playground and start chatting. Test different questions, review cited sources, and tweak the personality until it feels right.

5. Deploy

Head to Deploy, grab an API key, and pick how you want to ship it: embed on a website, install as a mobile app, connect to Telegram, or call the API directly.

API Reference

All API requests use an API key passed in the X-API-Key header.

POST/api/widget/{agent_id}/chat

Send a message and get back a streaming response via Server-Sent Events.

Request

curl -X POST "https://api.velorai.co/api/widget/{agent_id}/chat" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: vk_your_api_key" \
  -d '{
    "message": "What is your return policy?",
    "conversation_id": null
  }'

Response (SSE stream)

data: {"type": "token", "content": "Our"}
data: {"type": "token", "content": " return"}
data: {"type": "token", "content": " policy"}
data: {"type": "metadata", "conversation_id": "uuid", "sources": ["faq.pdf"], "response_time_ms": 1234}
data: [DONE]

GET/api/widget/{agent_id}/config

Fetch the agent's display settings. Requires an API key.

curl "https://api.velorai.co/api/widget/{agent_id}/config" \
  -H "X-API-Key: vk_your_api_key"

Response

{
  "agent_name": "Support Bot",
  "greeting_message": "Hi! How can I help?",
  "widget_color": "#6366f1",
  "widget_position": "bottom-right",
  "enable_voice": false,
  "enable_vision": false
}

GET/api/widget/{agent_id}/public-config

Fetch basic public info without authentication. Used by the PWA install page.

curl "https://api.velorai.co/api/widget/{agent_id}/public-config"

Website Widget

Drop a chat bubble onto any website with one script tag.

Installation

Add this script before the closing </body> tag:

<script
  src="https://api.velorai.co/widget/widget.js"
  data-agent-id="your-agent-id"
  data-api-key="vk_your_api_key"
  data-host="https://api.velorai.co"
></script>

Customization

The widget picks up your agent's color and position settings. Adjust them in Settings → Widget.

Supported options

widget_color: Hex color for the chat bubble and header

widget_position — bottom-right or bottom-left

Mobile App (PWA)

Turn any agent into a standalone mobile app. No app store, no approval process.

How it works

Each agent gets a unique shareable URL:

https://www.velorai.co/a/{agent_id}?key=vk_your_api_key

When users open this on mobile:

1. They see a full-screen chat interface styled to your agent

2. A prompt appears to install the app (or they can use the browser menu)

3. It installs as a standalone app with the agent's icon and name

4. Each agent installs independently, completely separate from the others

Telegram Bot

Connect your agent to Telegram as a bot.

1. Create a bot

Open Telegram, find @BotFather, send /newbot, and follow the prompts.

2. Connect to Velora!

In your agent's Deploy page, scroll to Telegram Bot, paste the BotFather token, and click Connect.

3. Start the bot

Click Start. Your bot goes live instantly, using the same knowledge base, tools, and personality as your agent.

Commands

/start: Start the conversation

/help: Show help message

/new: Start a new conversation

Integrations

Give your agent access to external services so it can read real data and take action.

📧

Gmail

Read, search, draft, and send emails

Read (auto), Send (approval required)

📅

Google Calendar

Read events, find free time, create events

Read (auto), Create (approval required)

📁

Google Drive

Search and list files

Read-only (auto)

🎬

YouTube

Search videos, get video details

Read-only (auto)

💬

Slack

List channels, read history, send messages

Read (auto), Send (approval required)

All integrations use OAuth 2.0 for secure authorization. Connect from any agent's Integrations tab. Access tokens are encrypted at rest.

Agent Tools

Agents come with built-in tools. The AI picks the right one based on the conversation.

Web Search

Search the web using DuckDuckGo

AUTO

Calculator

Evaluate math expressions and calculations

AUTO

Date & Time

Get the current date, time, and timezone

AUTO

Read Emails

Fetch recent emails from Gmail

AUTO

Send Email

Send an email via Gmail

APPROVAL

Read Calendar

Read calendar events

AUTO

Create Event

Create a calendar event

APPROVAL

Search Drive

Search Google Drive files

AUTO

Search YouTube

Search and find YouTube videos

AUTO

List Slack Channels

List public channels in a Slack workspace

AUTO

Send Slack Message

Send a message to a Slack channel

APPROVAL

Permission levels

AUTO: The agent runs this tool on its own.

APPROVAL: The agent asks before running this tool.

Custom APIs

Wire up any REST API as a tool your agent can call: internal services, third-party APIs, or anything with an HTTP endpoint.

How to add a custom API

Open your agent's Integrations page, scroll to Custom APIs, and hit "+ Add API".

Configuration fields

Tool Name: Unique identifier (e.g., get_weather). No spaces.

Description: What the API does. The AI uses this to decide when to call it.

Method: GET, POST, PUT, or DELETE.

URL: Full endpoint URL. Use {param} placeholders for dynamic values.

Parameters: JSON array describing the inputs the AI should fill in.

Headers: JSON object for authentication headers, API keys, etc.

Body Template: JSON body template for POST/PUT requests.

Response Path: JSONPath expression to pull the relevant data from the response.

Example: Weather API

{
  "name": "get_weather",
  "description": "Get current weather for a city",
  "method": "GET",
  "url": "https://api.weather.com/v1/current?city={city}",
  "parameters": [
    {
      "name": "city",
      "type": "string",
      "description": "City name",
      "required": true
    }
  ],
  "headers": {
    "X-Api-Key": "your-weather-api-key"
  }
}