ドキュメント
Owari Robo
Owari Robo は assistant の teaching、private answer の test、public chat の publish、Contacts の capture、Owari Forms 経由の完了済み conversation relay を提供し、Memory と Router を別 product として露出しません。
Robo console で onboarding、teaching、publish、Contacts、team、history、billing を管理します。
公開 assistant は consent、limit、retention、contact capture を持つ slug scoped public chat page を受け取ります。
各 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 の設定を取得します。
curl "https://api.owarilabs.com/robo/v1/public/robots/cartorio/config" 2. Public session を開始する
Public chat client は message や contact request の前に session を作成します。
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 を実行できます。
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 を公開します。
/health/live Check whether the Robo API process is live.
/health/ready Check whether the Robo API can serve traffic.
/v1/public/robots/{slug}/config Return public chat configuration for a Robo slug.
/v1/public/robots/{slug}/sessions Create a public chat session.
/v1/public/widgets/{slug}/config Return widget-safe configuration for an allowed website origin.
/v1/public/widgets/{slug}/sessions Create a widget public chat session.
/v1/public/sessions/{sessionId}/messages Send a public chat message and receive an answer.
/v1/public/sessions/{sessionId}/feedback Submit thumbs up or down feedback.
/v1/public/sessions/{sessionId}/finish Finish an idempotent widget or public chat session.
/v1/public/sessions/{sessionId}/expand-tokens Create a one-time token to expand a widget conversation into public chat.
/v1/public/expand-tokens/{token}/redeem Redeem a one-time widget expand token and hydrate the public chat transcript.
/v1/public/sessions/{sessionId}/contact-handoffs Create a Contact from public chat handoff.
/v1/responses Use Robo through an OpenAI-compatible Responses API.
/v1/chat/completions Use Robo through an OpenAI-compatible Chat Completions API.
Swagger / OpenAPI
現在の Robo request/response schema は以下の reference で確認できます。
以下の public OpenAPI 契約は dashboard console と internal control-plane route を意図的に省略しています。