Documentação

Owari Robo

Owari Robo permite ensinar um assistente, testar respostas privadas, publicar chat público, capturar Contatos e enviar conversas finalizadas pelo Owari Forms sem expor Memory ou Router como produtos separados.

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

Use o console Robo para onboarding, ensino, publicação, Contatos, equipe, histórico e billing.

URL do chat público https://dev-robo.owarilabs.com/robo/{slug}

Assistentes publicados recebem uma página pública com consentimento, limites, retenção e captura de contato.

Runtime Recursos vinculados de Memory + Router

Cada tenant Robo tem recursos internos de Memory e Router enquanto Robo aplica limites, auditoria, chat público e Contatos.

Primeiros passos

Use as superfícies de chat público e runtime compatível com OpenAI em clientes voltados ao usuário e integrações 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."
  }'

Endpoints

Robo expõe superfícies de chat público, widget e runtime compatível com OpenAI para integrações voltadas ao cliente.

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

Use a referência incorporada para inspecionar schemas atuais de request e response do Robo.

Baixar OpenAPI YAML do Robo

O contrato OpenAPI público abaixo omite intencionalmente rotas de console do dashboard e control-plane interno.

Carregando referência da API Owari Robo...

Owari Robo

Primeiros passos

1. Leia a configuração do chat público

2. Inicie uma sessão pública

3. Chame a Responses API

Endpoints

Swagger / OpenAPI