Docs - Insertar

Inserta tu agente en tu sitio web

Pon tu agente en tu propio sitio. Los visitantes chatean con él ahí mismo, sin cuenta de WukongDojo. Tú pagas ese tráfico desde tu cartera, con un presupuesto diario que tú fijas.

1. Dos formas de insertar

Forma	Qué ven los visitantes	Ideal para
Widget flotante (por defecto)	Un botón de chat fijo abajo a la derecha. Abre un panel de chat — pantalla completa en móvil, tarjeta flotante en escritorio — y recuerda si estaba abierto al cambiar de página.	La mayoría de sitios. Una etiqueta script, nada que dimensionar.
Iframe en línea	El chat aparece dentro de tu página donde lo coloques.	Páginas de documentación o de aterrizaje que quieren el chat en una columna o en la portada.

2. Antes de empezar

El agente debe ser No listado o Público. El embed de un agente Privado siempre aparece fuera de línea. Consulta Publicar para cambiar la visibilidad.

La configuración está en el editor del agente: abre el agente, haz clic en Editar y ve a la sección Canales, en "Insertar en tu sitio web". Solo el propietario la ve.

3. Actívalo

Marca Activar el embed del sitio web.
Fija un Presupuesto diario (USD) — ver sección 4.
En Añadir un dominio, escribe la dirección de tu sitio, p. ej. https://example.com — solo esquema y host, sin ruta ni parámetros. El dominio y su versión www. quedan cubiertos juntos; cualquier otro subdominio (p. ej. docs.example.com) necesita su propia entrada.
Cada dominio tiene su propio fragmento. Haz clic en Copiar y pégalo en el HTML de tu sitio, justo antes de </body>:

<script src="https://www.wukongdojo.ai/api/worker/embed/<embed-id>/widget.js" async></script>

¿Lo prefieres en línea? Haz clic en O insertar en línea (iframe) bajo el fragmento y pega ese donde quieras el chat. Ajusta el ancho y el alto a tu diseño:

<iframe src="https://www.wukongdojo.ai/api/worker/embed/<embed-id>"
        style="width:100%;max-width:420px;height:600px;border:0;border-radius:12px"></iframe>

El fragmento solo funciona en el dominio para el que se creó. Si alguien lo copia en otro sitio, el navegador se niega a cargar el chat.

4. Quién paga y el presupuesto diario

Los visitantes nunca pagan ni inician sesión. Cada conversación del embed se cobra a ti, el propietario del agente, desde tu cartera de WukongDojo.

El presupuesto diario limita ese gasto. Cada mensaje de un visitante cuenta $0.0015 contra el presupuesto del día, así que $1 cubre unos 660 mensajes. Se te cobra el costo real, que puede superar un poco esa cifra en respuestas largas. Cuando se agota el presupuesto del día, el embed se pausa hasta el día siguiente (medianoche UTC) y luego se reanuda solo. Pon el presupuesto en 0 para pausar el embed sin borrar nada.

Para que un solo visitante no agote tu presupuesto, cada visitante también está limitado a 20 mensajes por minuto y 300 al día.

5. Qué ven los visitantes

Si el embed no puede responder — presupuesto agotado, cartera vacía o un visitante que envía demasiado rápido — el visitante ve "This chat is outside office hours right now — please try again later." Los precios, carteras y presupuestos nunca se muestran a los visitantes.

Los visitantes se recuerdan por navegador. Un visitante que vuelve ve sus últimos 20 mensajes. Tras 30 minutos sin respuesta, su siguiente mensaje inicia una conversación nueva para el agente, pero los mensajes anteriores siguen visibles arriba.

6. Revocar un dominio

Haz clic en Revocar junto a un dominio y ese sitio pierde el acceso al instante. El widget desaparece sin romper tu página: el botón flotante simplemente no aparece y un iframe en línea se muestra fuera de línea. Desmarcar Activar el embed del sitio web hace lo mismo para todos los dominios a la vez.

Añadir de nuevo el mismo dominio crea un fragmento nuevo. Pega el nuevo en tu sitio — el anterior no vuelve a funcionar.