Aether AI
API ReferenceGuidesSDKsFAQ

SDKs & libraries

Official SDKs for integrating Aether AI Support into your applications.

JavaScript / TypeScript

For Node.js, React, Next.js, and browser

v1.0.0
npm install @iamdamnsam/aether-support

Quick Start

import { AetherSupport } from '@iamdamnsam/aether-support';

const aether = new AetherSupport({
  apiKey: 'your_api_key',
  appId: 'your_app_id',
});

// Create a ticket
const ticket = await aether.createTicket({
  subject: 'Help needed',
  description: 'I need assistance with...',
  userEmail: 'user@example.com',
  priority: 'medium',
});

// Search knowledge base
const results = await aether.search('how to reset password');
npm →GitHub →

Python

For Django, Flask, FastAPI, and scripts

v1.0.0
pip install aether-support

Quick Start

from aether_support import AetherSupport

aether = AetherSupport(
    api_key="your_api_key",
    app_id="your_app_id",
)

# Create a ticket
ticket = aether.create_ticket(
    subject="Help needed",
    description="I need assistance with...",
    user_email="user@example.com",
    priority="medium",
)

# Search knowledge base
results = aether.search("how to reset password")
PyPI →GitHub →

React Components

Pre-built React components (included in JS SDK)

v1.0.0

Available Components

import {
  SupportWidget,    // Floating chat widget
  SupportButton,    // Trigger button
  TicketForm,       // Ticket creation form
  TicketList,       // List of user's tickets
} from '@iamdamnsam/aether-support/react';

// Add the widget to your app
function App() {
  return (
    <>
      <YourApp />
      <SupportWidget
        apiKey="your_api_key"
        appId="your_app_id"
        position="bottom-right"
        theme="auto"
      />
    </>
  );
}

Example Integrations

Copy-paste examples for popular frameworks.

React + Vite
// 1. Install the SDK
npm install @iamdamnsam/aether-support

// 2. Add to your App.tsx
import { SupportWidget } from '@iamdamnsam/aether-support/react';

function App() {
  return (
    <>
      <YourRoutes />
      <SupportWidget
        apiKey={import.meta.env.VITE_AETHER_API_KEY}
        appId={import.meta.env.VITE_AETHER_APP_ID}
      />
    </>
  );
}

// 3. Add to your .env
// VITE_AETHER_API_KEY=your_api_key
// VITE_AETHER_APP_ID=your_app_id
Next.js 14
// 1. Install the SDK
npm install @iamdamnsam/aether-support

// 2. Create components/SupportWidget.tsx
'use client';
import { SupportWidget } from '@iamdamnsam/aether-support/react';

export default function Support() {
  return (
    <SupportWidget
      apiKey={process.env.NEXT_PUBLIC_AETHER_API_KEY!}
      appId={process.env.NEXT_PUBLIC_AETHER_APP_ID!}
    />
  );
}

// 3. Add to your layout.tsx
import Support from '@/components/SupportWidget';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Support />
      </body>
    </html>
  );
}
Express.js (Backend)
// 1. Install the SDK
npm install @iamdamnsam/aether-support

// 2. Initialize in your server
import { AetherSupport } from '@iamdamnsam/aether-support';

const aether = new AetherSupport({
  apiKey: process.env.AETHER_API_KEY,
  appId: process.env.AETHER_APP_ID,
});

// 3. Create tickets from your API
app.post('/api/support', async (req, res) => {
  const ticket = await aether.tickets.create({
    subject: req.body.subject,
    description: req.body.message,
    customerEmail: req.user.email,
    priority: 'medium',
  });
  res.json({ ticketId: ticket.id });
});
FastAPI (Python)
# 1. Install the SDK
pip install aether-support

# 2. Initialize the client
from aether_support import AetherSupport
import os

aether = AetherSupport(
    api_key=os.environ["AETHER_API_KEY"],
    app_id=os.environ["AETHER_APP_ID"]
)

# 3. Create tickets from your API
@app.post("/api/support")
async def create_ticket(request: TicketRequest):
    ticket = aether.tickets.create(
        subject=request.subject,
        description=request.message,
        customer_email=request.email,
        priority="medium"
    )
    return {"ticket_id": ticket.id}
Flask (Python)
# 1. Install the SDK
pip install aether-support

# 2. Initialize in your app
from flask import Flask, request, jsonify
from aether_support import AetherSupport
import os

app = Flask(__name__)
aether = AetherSupport(
    api_key=os.environ["AETHER_API_KEY"],
    app_id=os.environ["AETHER_APP_ID"]
)

# 3. Create a support endpoint
@app.route("/api/support", methods=["POST"])
def create_ticket():
    data = request.json
    ticket = aether.tickets.create(
        subject=data["subject"],
        description=data["message"],
        customer_email=data["email"]
    )
    return jsonify({"ticket_id": ticket.id})

Video Tutorials

Watch step-by-step guides for common integration scenarios.

🚀

Getting Started in 5 Minutes

5:32

Quick setup walkthrough from account creation to live widget

⚛️

React Integration Guide

8:15

Add Aether to your React or Next.js application

🎫

Building a Custom Ticket Form

12:45

Create custom ticket forms with the JavaScript SDK

🐍

Python Backend Integration

10:20

Server-side ticket management with Flask or FastAPI

🔗

Webhook Setup & Automation

7:30

Connect to Slack, Discord, and custom endpoints

🎨

Advanced Widget Customization

9:45

Theme, positioning, and custom CSS styling

📺 More tutorials coming soon! Request a topic

Additional Resources

GitHub

View source code and examples

API Reference

Full API documentation with Swagger UI

FAQ

Answers to common questions