Ghosty
Documentación
Canales

Widget embebido

Pon un chat con tu agente en tu propio sitio con un iframe. Disponible para agentes de motor EasyBits.

Actualizado 2026-09-16

Un <iframe> y tu agente contesta en tu página.

Alcance. Hoy el widget funciona con agentes de motor EasyBits (los que se crean en Agentes → EasyBits). Los agentes nativos de Studio llegan al embed más adelante; mientras tanto se integran por la .

Incrustar

En el panel del agente copia el token de embed y pega:

html
<iframe  src="https://www.ghosty.studio/embed/TU_EMBED_TOKEN"  style="width:100%;max-width:420px;height:600px;border:0;border-radius:16px"  allow="clipboard-write"></iframe>

El token es la credencial del widget: identifica al agente y limita lo que puede hacer (sólo conversar). Si se filtra, regenéralo desde el panel.

Qué hace

  • Historial guardado en el navegador del visitante (localStorage), sin cuentas.
  • Respuestas en streaming.
  • Tema claro/oscuro según el sistema.

Qué no hace (todavía)

  • No sube archivos.
  • No identifica al visitante: si necesitas saber quién escribe, usa la desde tu backend.

Endpoints detrás del widget

Por si prefieres tu propia UI:

RutaQué hace
GET /api/embed/lookup?embedToken=…Resuelve el agentId del token.
POST /api/embed/message/:agentIdManda un mensaje; responde en SSE. Header Authorization: <embedToken>.
← Anterior
Teams
Siguiente →
Conectores