Lleva Kibo a tu producto

Autenticación

Cada solicitud debe incluir tu clave API de partner como Bearer token. Las claves se emiten por partner, con alcance de producto (kibo.chat, kibo.call) y se muestran solo una vez al crearlas — guárdalas en un gestor de secretos y mantenlas en el servidor.

Authorization: Bearer nott_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URL base: https://noonetotalk.com/api/v1 · JSON de entrada y salida · límites de tasa y cuotas mensuales por plan (429 con Retry-After al exceder).

Kibo Chat — POST /chat

Envía un mensaje del usuario final y recibe una respuesta en texto o voz (MP3 en base64). Las conversaciones son stateful por user_id: Kibo recuerda el contexto entre solicitudes. Tus user ID están aislados por partner y nunca colisionan con los de otros partners.

curl https://noonetotalk.com/api/v1/chat \
  -H "Authorization: Bearer $NOTT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "usr_842", "message": "I had a rough day...", "audio": false }'

{
  "type": "text",
  "response": "I'm here for you. Want to tell me what happened?",
  "session_key": "..."
}

{
  "type": "audio",
  "response": "<base64 MP3>",
  "text": "I'm here for you. Want to tell me what happened?",
  "mime_type": "audio/mpeg",
  "session_key": "..."
}

Las respuestas pueden tardar varios segundos (LLM + TTS opcional) — usa un timeout de al menos 120s.

Kibo Call — POST /call/tokens

Conversación de voz en tiempo real con latencia subsegundo y turn-taking natural, por WebRTC con el SDK de ElevenLabs (web, iOS, Android, React Native). Tu servidor solicita un token de corta duración; tu cliente se conecta directamente — ningún media pasa por tus servidores.

curl -X POST https://noonetotalk.com/api/v1/call/tokens \
  -H "Authorization: Bearer $NOTT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "usr_842" }'

Respuesta:

{
  "token": "<ephemeral WebRTC token>",
  "agent_id": "...",
  "expires_in": 300,
  "nott_ref": "ptn_12__usr_842"
}

Cliente (ejemplo web — SDKs también para React Native, Swift, Kotlin):

import { Conversation } from "@elevenlabs/client";

// 1. Get a token from YOUR backend (never expose your NOTT API key client-side)
const { token, nott_ref } = await fetch("/your-backend/kibo-call-token")
  .then((r) => r.json());

// 2. Start the real-time voice session (WebRTC)
const conversation = await Conversation.startSession({
  conversationToken: token,
  connectionType: "webrtc",
  overrides: { dynamicVariables: { nott_ref } }, // required for billing attribution
});

// ... conversation.endSession() when done

Los tokens son de un solo uso y expiran en minutos — solicita uno por llamada. Las calls se facturan por minutos conectados. ¿Sin WebRTC de tu lado? Usa Kibo Chat con "audio": true como alternativa de voz request–response.

Consumo — GET /usage

Consulta self-service del mes actual (?month=YYYY-MM para historial).

{
  "month": "2026-07",
  "chat": { "messages": 12480, "audio_replies": 3120, "quota": 50000 },
  "call": { "tokens_issued": 950, "minutes": 1830.5, "quota_minutes": 5000 }
}

Errores

Los errores siguen el formato { "error": { "code", "message" } }. Reintenta solo 502/timeouts, con backoff exponencial.

Buenas prácticas

Mantén la clave API solo en el servidor — los clientes deben hablar con tu backend. Usa user_id estables y seudónimos (sin correos ni PII): definen la memoria de la conversación. Kibo es un compañero de apoyo emocional, no un dispositivo médico — ofrece tu propia UX de escalada en crisis cuando lo exija tu jurisdicción.