ドキュメント

Owari Robo

Owari Robo は assistant の teaching、private answer の test、public chat の publish、Contacts の capture、Owari Forms 経由の完了済み conversation relay を提供し、Memory と Router を別 product として露出しません。

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

Robo console で onboarding、teaching、publish、Contacts、team、history、billing を管理します。

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

公開 assistant は consent、limit、retention、contact capture を持つ slug scoped public chat page を受け取ります。

Runtime Linked Memory + Router resources

各 Robo tenant は内部 Memory と Router resource を持ち、Robo が limits、audit、public chat、Contacts を適用します。

Quickstart

Public chat と OpenAI-compatible runtime surface を、顧客向け client と server-side integration から利用します。

1. Public chat configuration を読む

Public chat 体験を表示する前に、公開 assistant の設定を取得します。

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

2. Public session を開始する

Public chat client は message や contact request の前に session を作成します。

bash
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
  }'

3. Responses API を呼び出す

Server-side integration は tenant-scoped Robo API key で OpenAI-compatible runtime call を実行できます。

bash
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 は customer-facing integration 向けに public chat、widget、OpenAI-compatible runtime surface を公開します。

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

現在の Robo request/response schema は以下の reference で確認できます。

Robo OpenAPI YAML をダウンロード

以下の public OpenAPI 契約は dashboard console と internal control-plane route を意図的に省略しています。

Owari Robo API リファレンスを読み込み中...