Documentazione

Owari Robo

Owari Robo permette di istruire un assistant, testare risposte private, pubblicare una chat pubblica, catturare Contacts e inoltrare conversazioni concluse tramite Owari Forms senza esporre Memory o Router come prodotti separati.

URL console https://dev-robo.owarilabs.com/

Usa la console Robo per onboarding, teaching, publishing, Contacts, team, history e billing.

URL chat pubblica https://dev-robo.owarilabs.com/robo/{slug}

Gli assistant pubblicati ricevono una pagina chat con consent, limiti, retention policy e raccolta contatti.

Runtime Risorse Memory + Router collegate

Ogni tenant Robo possiede risorse interne Memory e Router mentre Robo applica limiti, audit, chat pubblica e Contacts.

Quickstart

Usa le superfici chat pubblica e runtime compatibili OpenAI da client customer-facing e integrazioni server-side.

curl "https://api.owarilabs.com/robo/v1/public/robots/cartorio/config"

curl -X POST "https://api.owarilabs.com/robo/v1/public/robots/cartorio/sessions" \
  -H "Content-Type: application/json" \
  -d '{
    "visitor_label": "website visitor",
    "consent_accepted": true
  }'

# Use the returned session_id to send a message.
curl -X POST "https://api.owarilabs.com/robo/v1/public/sessions/$SESSION_ID/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What services do you offer?",
    "consent_accepted": true
  }'

curl -X POST "https://api.owarilabs.com/robo/v1/responses" \
  -H "Authorization: Bearer $ROBO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_channel": "public_chat",
    "model": "owari-default",
    "input": "Summarize your support options."
  }'

Endpoint

Robo espone superfici chat pubblica, widget e runtime compatibili OpenAI per integrazioni customer-facing.

GET /health/live

Check whether the Robo API process is live.

GET /health/ready

Check whether the Robo API can serve traffic.

GET /v1/public/robots/{slug}/config

Return public chat configuration for a Robo slug.

POST /v1/public/robots/{slug}/sessions

Create a public chat session.

GET /v1/public/widgets/{slug}/config

Return widget-safe configuration for an allowed website origin.

POST /v1/public/widgets/{slug}/sessions

Create a widget public chat session.

POST /v1/public/sessions/{sessionId}/messages

Send a public chat message and receive an answer.

POST /v1/public/sessions/{sessionId}/feedback

Submit thumbs up or down feedback.

POST /v1/public/sessions/{sessionId}/finish

Finish an idempotent widget or public chat session.

POST /v1/public/sessions/{sessionId}/expand-tokens

Create a one-time token to expand a widget conversation into public chat.

POST /v1/public/expand-tokens/{token}/redeem

Redeem a one-time widget expand token and hydrate the public chat transcript.

POST /v1/public/sessions/{sessionId}/contact-handoffs

Create a Contact from public chat handoff.

POST /v1/responses

Use Robo through an OpenAI-compatible Responses API.

POST /v1/chat/completions

Use Robo through an OpenAI-compatible Chat Completions API.

Swagger / OpenAPI

Usa il riferimento incorporato per ispezionare gli schema request e response correnti di Robo.

Scarica OpenAPI YAML di Robo

Il contratto OpenAPI pubblico qui sotto omette intenzionalmente route console dashboard e control-plane interne.

Caricamento del riferimento API di Owari Robo...

Owari Robo

Quickstart

1. Leggi la configurazione della chat pubblica

2. Avvia una sessione pubblica

3. Chiama la Responses API

Endpoint

Swagger / OpenAPI