Ir para o conteúdo
SVEDA
PT
Menu

HOST

Host SDKs

Cada host faz mint de um embed token com escopo; a página abre chat JS ou iframe. A host API key não sai do servidor.

No framework Embed token

Host SDKs

Cada host faz mint de um embed token com escopo; a página abre chat JS ou iframe. A host API key não sai do servidor.

Passo a passo: mint do embed token em PHP, Laravel, Python, Node, Ruby, Go, Java, .NET ou sem framework.

No framework

A static page can open the chat. Something on your origin still has to mint the embed token — curl for local, or a tiny POST /sveda/session.

PHP

Framework-agnostic PHP. Factory::factory() → embed()->createToken(). Your page only receives origin and token.

Laravel

The package wraps sveda-ai/php-sdk, mints Sanctum MCP tokens, and exposes StartSidecarSessionController.

Python

One client. Flask, Django, and FastAPI are route wrappers. start_host_session returns origin, token, expires_in, appearance.

Node

Native fetch. startHostSession talks to the sidecar. The page still opens chat with data-sveda-open buttons.

Ruby

The gem mints embed tokens with Bearer host auth. Rails is a controller and a layout. Plain Ruby is the same HTTP call.

Go

No framework required. net/http plus the module is the host. Templates only render chat buttons when the origin is set.

Java

HttpClient transport. Spring Boot is a controller and Thymeleaf. The SDK does not need Spring.

.NET

net8.0 sveda-dotnet-sdk. ASP.NET is MapPost plus a layout. The library is usable from any HttpClient host.

Same handshake on every host

Numbered steps on each language page match this contract. Each page also has a ready Cursor prompt. Skip the SDK with no framework.

  1. 1

    Docker sidecar

    SVEDA_EMBED_ENABLED=true on ghcr.io/neresson/sveda-server plus a host API key. CORS lists the page origin so /build/sveda/sveda-chat.css and sveda-chat.js load.

  2. 2

    Install the SDK

    Or skip it. A static page plus curl or a 20-line mint route is enough.

  3. 3

    Match the keys

    SVEDA_CLIENT_HOST_API_KEY equals SVEDA_EMBED_HOST_API_KEY.

  4. 4

    POST /sveda/session

    Return origin, token, expires_in.

  5. 5

    Open the chat

    Set data-sveda-origin and data-sveda-session, then JS or iframe.

Start without a framework.

Static HTML, an iframe, or a 20-line session endpoint. Then pick a language SDK when you want typed minting.

No framework