Cómo funciona Chatia.

Chatia es una plataforma para freelancers y empresas LATAM que quieren tener un agente de IA propio en webchat y WhatsApp en menos de 5 minutos. No requiere onboarding ni código.

Modelo mental rápido: vos sos el owner de la cuenta. Creás agentes (cada uno es un chatbot con su prompt + skills + base de conocimiento). Cada agente tiene su webchat público(link /chat/<slug>) y opcionalmente WhatsApp. Podés invitar clientes (sub-users) para que vean mensajes y leads, y cada cliente puede sumar hasta 5 team-members.

Cómo arranca

1. Loguéate como owner. Vas a ver un orbe negro brillante abajo a la derecha.
2. Click en el orbe → click en "Empezar a hablar".
3. El browser te pide permiso al micrófono — aceptás.
4. Hablá natural. Ej: "creame un agente para soporte de WhatsApp".
5. El agente ejecuta la acción y te confirma en voz. Las acciones destructivas piden confirmación verbal antes.

Qué te cuesta

• →3 minutos cortesía vitalicios con nuestra OpenAI key. Una sola vez por cuenta.
• →Después: API propia obligatoria. Pegás tu OpenAI key en APIs & modelos y la voz queda gratis para vos (pagás directo a OpenAI).
• →Cero upcharge nuestro. Voice Manager está incluido en todos los planes.

Privacidad y seguridad

• →Tu audio se procesa con OpenAI Realtime API. No lo guardamos en nuestros servers.
• →Solo el owner tiene acceso. Clientes y team-members no pueden activar voz por seguridad.
• →Secretos (API keys, passwords) nunca se leen en voz — aparecen en pantalla con un botón Copiar.
• →Acciones destructivas (borrar agente, revocar key, resetear password) requieren confirmación verbal explícita.
• →El orbe persiste entre páginas: la sesión sigue viva mientras navegás.

Ejemplos de comandos

Tenés dos formas de crear un agente:

1. Builder conversacional en /build — describilo en lenguaje natural ("quiero un agente que atienda consultas de mi tienda y agende citas") y el builder genera el prompt + las skills + lo publica.
2. Voice Manager — decile al orbe "creame un agente para X", queda en draft listo para revisar.

Cada agente tiene tabs en su editor: Identidad, Prompt, WhatsApp, Email, Tools, Knowledge, Instalación y Marca. El más importante es Prompt — ahí va lo que el modelo lee como sistema cada vez que responde.

Publicar: en el panel "Estado" del editor, click "Publicar webchat". Te queda live en/chat/<slug>.

Memoria: cada agente recuerda 10–25 turnos previos según lo configures en la tab "Prompt". Más memoria = mejor coherencia, más tokens.

Modelo: por default eschatia-lite (gratuito, corre con nuestra IA). Si conectás tu OpenAI/Anthropic key en APIs & modelos, podés elegir gpt-5.4, gpt-4o, claude-4.5-sonnet, etc.

Cuando publicás un agente, te genera dos cosas:

• Un link público: https://chatia.pro/chat/<slug> — lo podés mandar tal cual.
• Un script para embeber en cualquier sitio que pega un orbe flotante con el chat:

<script
  src="https://chatia.pro/widget.js"
  data-agent="mi-agente-7"
  data-position="right"
  data-accent="#10b981"
  defer
></script>

Personalizar la marca: en la tab "Marca" del agente cargás logo + color + texto del "Powered by". El widget toma esos valores automáticamente cuando se carga (ver Branding).

El widget está hecho con Shadow DOM — no rompe los estilos del sitio donde lo pegues.

WhatsApp en Chatia funciona vía Kapso (BSP oficial de Meta). Cada owner trae su propia API key de Kapso — Chatia no es un revendedor de WhatsApp, así que vos tenés control total y billing directo con Meta vía Kapso.

Setup en 60 segundos

1. Creás cuenta en kapso.ai (o lo conectás si ya tenés).
2. Pegás tu Kapso API key en la tab "WhatsApp" del agente.
3. Detectamos tu número automáticamente y configuramos el webhook para que los mensajes lleguen al agente.
4. Listo: tu agente responde mensajes WhatsApp reales.

Multimedia inbound + outbound

El agente recibe y responde texto, voz (transcripta con Whisper), imágenes (procesadas con vision) y PDFs (extraídos con pypdf). Todo end-to-end, sin que tengas que tocar nada.

Ventana de 24h

Meta exige que el agente solo pueda responder dentro de las 24h desde el último mensaje del usuario. Pasada esa ventana, solo podés enviar templates pre-aprobados. Te avisamos en el dashboard y emitimos un webhook agent.outbound.skipped_24h_window cuando bloqueamos un envío por esto.

Status events

Recibís webhooks por cada cambio de estado del mensaje:delivered, read, failed, quality_changed, banned.

Las skills son funciones que el modelo puede invocar durante una conversación. Las activás en la tab "Tools" del agente. Las built-in:

• capture_lead — guarda nombre/email/teléfono/interés.
• schedule_appointment — agenda en el calendario del agente.
• list_availability — consulta huecos disponibles.
• create_calendar_event — crea evento custom.
• send_email — manda email transaccional via Resend o SMTP.
• send_whatsapp_handoff — deriva a humano por WhatsApp.
• whatsapp_send_template — manda template Meta pre-aprobado.
• query_knowledge — busca en la base de conocimiento del agente.
• http_request — llamada HTTP arbitraria a tu backend.

Cada skill se dispara cuando el modelo decide que es necesaria durante la conversación. Vos definís qué skills tiene disponibles en el editor — el modelo elige cuándo usarlas.

Knowledge base: en la tab "Knowledge" del agente cargás texto (FAQs, docs, copys de la web). El modelo lo consulta vía query_knowledge para responder con datos reales.

Cada vez que un usuario habla con tu agente (en webchat o WhatsApp), se crea una Conversación. La ves en el editor del agente, tab "Conversaciones".

Takeover humano

Si el agente no puede resolver algo, vos podés tomar control de la conversación: la IA se pausa y vos contestás como operador. Tres formas de hacerlo:

1. Desde el dashboard: en la conversación, botón "Pausar IA" + caja de texto para responder vos.
2. Desde el portal cliente: tu cliente o sus team-members pueden hacer takeover si les diste el scope correspondiente.
3. Por voz: decile al orbe "tomo control de la conversación 123" y respondé verbalmente.

Exportar

Cada conversación se exporta en JSON, CSV o TXT vía botón en el editor o vía API: GET /api/developers/conversations/<id>/export?format=csv. Útil para fine-tuning, análisis o auditoría.

Webhooks de mensaje

Te llegan eventos firmados por cada mensaje:agent.message.created, agent.reply.created, agent.lead.captured, agent.handoff.requested. Ver API y webhooks.

Vos sos el owner de la cuenta. Podés invitar clientes (sub-users) en /clients con email + nombre + password inicial. Cada cliente entra a su portal en /client y ve solo lo que vos le diste acceso.

Permisos por agente

Para cada cliente, vos decidís a qué agentes tiene acceso (con scopes messages,leads por default — read-only). El cliente nunca ve el prompt del agente, ni el modelo, ni la billing.

Equipo del cliente (5 seats)

Cada cliente puede invitar hasta 5 team-members a su portal — útil para que su equipo de soporte / ventas comparta el trabajo. Los team-members heredan los grants del cliente padre y no pueden invitar a más gente ni ver el dashboard de métricas.

Esta feature solo está habilitada si el owner (vos) tiene plan pago. En plan Free el cliente ve "Esta función todavía no está habilitada en tu cuenta. Ponete en contacto con [vos]".

Dashboard del cliente

Si querés, podés habilitarle al cliente un dashboard de métricas de interacciones (mensajes/día, leads, breakdown por agente) en /clients> tu cliente > toggle "Dashboard de interacciones". Solo lo ve el cliente titular, no sus team-members.

Reset de password

Si tu cliente perdió su contraseña, en /clients/<id> tenés un botón "Resetear contraseña" que genera una nueva y te la muestra una sola vez para que se la pases por canal seguro.

Personalizás dos zonas distintas — el webchat público que ven los visitantes y el portal del cliente que ven tus clientes invitados.

Webchat (por agente)

En el editor de cada agente, tab "Marca". Cargás logo (PNG/JPG/WebP/SVG, máx 2 MB), elegís color primario (color picker o presets) y configurás el texto + URL del "Powered by". Vista previa en vivo del chat al lado.

Portal cliente (global del owner)

En /dashboard/branding configurás cómo se ve el portal del cliente: brand_name (reemplaza "Agent Factory" en la sidebar), logo, color primario y "Powered by" del portal.

Override por cliente

Para cada cliente individual podés tener un branding distinto: en /clients/<id> tenés una sección "Marca del cliente" con su logo + colores + "Powered by" propios. Útil si manejás múltiples marcas.

Powered by — gating por plan

En plan Free el badge "Powered by Chatia.pro" siempre se muestra. En cualquier plan pago (PayG, Starter, Pro, Studio, Agency) podés ocultarlo o reemplazarlo por tu propio texto + link.

Los archivos viven en /persistent/branding/{kind}/{owner_id}.{ext} en el disco persistente de Render.

Toda la plataforma es accesible vía REST API con Bearer auth. Generás API keys en /dashboard/developers/api.

Endpoints principales

• · /api/developers/agents — list/create/publish/update/delete.
• · /api/developers/conversations/:id/export — JSON, CSV o TXT.
• · /api/developers/clients — gestión completa de sub-users.
• · /api/developers/clients/:id/team-members — los 5 seats.
• · /api/developers/webhooks — endpoints firmados HMAC-SHA256.
• · /api/developers/events/catalog — lista canónica de event types.
• · /api/v1/chat/completions — OpenAI-compatible (Chatia Lite).

Doc completa con request/response shapes, ejemplos cURL y SDK Python/Node: /docs/api.

Webhooks firmados

Cada webhook que mandamos trae headers x-chatia-signature, x-chatia-timestamp, x-chatia-event, x-chatia-event-id. Verificás con HMAC-SHA256: hmacSha256(secret, timestamp + "." + raw_body). Si no matchea, descartás como replay attack.

Para asistentes IA

Tenemos un manual machine-readable en /SKILL.md que pegás directamente en Claude Code, Cursor o Codex y arman integraciones contra Chatia sin que tengas que escribir una línea.

Modelo simple: arrancás Free con 100 mensajes de prueba. Cuando guardás tarjeta, se activa Pay-as-you-go automáticamente. Si querés más mensajes incluidos, subís a un plan mensual.

Comparativa completa en /pricing. Resumen:

• · Free — $0, 3 agentes, 100 mensajes trial, 3 min Voice Manager.
• · PayG — $0 + $0.01/msg con API de Chatia o $0.004/msg con API propia.
• · Starter — $5/mo · 1.000 mensajes · 4 agentes.
• · Pro — $12/mo · 5.000 mensajes · 6 agentes (más elegido).
• · Studio — $29/mo · 20.000 mensajes · 8 agentes.
• · Agency — $59/mo · 60.000 mensajes · 17 agentes.

Todos los planes pagos incluyen Voice Manager gratis con tu API propia.

Cómo cobrás vos a tus clientes

Vos sos el owner — Chatia te cobra a vos por uso. Cómo le facturás a tu cliente final es 100% tuyo. La sugerencia: cobrarles un setup fee + un fee mensual por agente activo.

Tu API propia

Si conectás tu propia OpenAI key en /dashboard/api-settings, los mensajes salen ~60% más baratos para vos (cobramos solo overhead de infra, vos pagás al modelo directo).

Customer portal

Cancelás, cambiás de plan, ves facturas y actualizás tarjeta desde el Customer Portal de Polar — botón en /billing.

Autenticación

Tres formas de loguear: email/password, Google OAuth, o cualquiera de las dos + 2FA TOTP. Activás 2FA en /account#twofa escaneando el QR con Google Authenticator, Authy, 1Password o cualquier app TOTP.

Si entrás con Google y activaste 2FA, te pide el código TOTP igual antes de soltar la sesión. Cero excepciones.

Roles y permisos

• · owner: vos. Acceso total a tu cuenta y tus agentes.
• · superadmin: solo el equipo de Chatia. Acceso a métricas globales.
• · client: sub-user que vos invitaste. Read-only sobre los agentes que le diste acceso.
• · team_member: invitado por un cliente. Hereda los grants del cliente padre.

Cifrado

Passwords con bcrypt. Tokens JWT firmados HS256. Credenciales sensibles (OpenAI/Anthropic/Kapso keys) cifradas con Fernet en DB. Webhooks salientes firmados HMAC-SHA256. Todo el tráfico vía HTTPS.

Voice Manager — owner only

Por seguridad, solo el owner (y superadmin) puede activar Voice Manager. Clientes y team-members ni siquiera ven el orbe en su dashboard. Eso evita que alguien con menos privilegios ejecute tools privilegiadas vía voz.

Reportar un problema de seguridad

Escribinos a [email protected] con detalle. Respondemos en 48h hábiles. No publiquemos el issue hasta que esté resuelto.