Book a build call
Volver a la Ayuda
Guía

Ponga su agente en un sitio web de HTML simple

4 min de lectura

Read in English

Si usted edita sus propios archivos HTML, puede poner a su agente en cualquier página. Necesita la única etiqueta de NetShow y una pequeña prueba de que el sitio es suyo. Estos pasos sirven para un sitio en su propio servidor, en un hosting compartido o en un hosting estático que sirve archivos comunes. Publique primero a su agente; Publíquelo muestra ese paso.

Los nombres de menú de hosting de esta guía son los de septiembre de 2026 y pueden cambiar. Si los controles de su hosting se ven distintos, busque en su ayuda “upload files”, “site root”, “hidden folders” o “Content-Security-Policy”.

Ponga la etiqueta en sus páginas

Abra la página de inserción web de su agente desde su página Deploy. En Paste this tag into your website, presione Copy code. No cambie la etiqueta copiada: sus valores identifican a su agente y su puerta. Colóquela justo antes de </body> en cada archivo HTML de página donde deba aparecer el agente. Si sus páginas comparten un archivo de pie de página, ponga la etiqueta ahí una sola vez.

Así se ve una página pequeña después de insertarla. your-agent es solo un ejemplo; pegue su propia etiqueta con todos sus atributos.

<!doctype html>
<html lang="en">
  <head><title>Our site</title></head>
  <body>
    <h1>Welcome</h1>
    <script src='https://app.netshow.ai/js/ns-chat-widget.js' charset='utf-8' data-agent='your-agent' data-agent-slug='your-agent' data-api='https://app.netshow.ai/api/door/your-agent/chat' data-name='Your agent' data-welcome='Hello' data-theme='netshow' data-tracker='' data-domain-config='' data-livechat='' data-door-lane='1'></script>
  </body>
</html>

Suba los archivos modificados y cargue una de esas páginas. Antes de la verificación, puede aparecer la cara en vivo de su agente, pero les dice a los visitantes que la puerta está cerrada en lugar de responder.

Publique el archivo de verificación

En Add your website and verify it, escriba la dirección HTTPS completa de su sitio en Website address y luego presione Request this site. Use la dirección que el navegador muestra al final, como la dirección con www si el dominio sin www lo lleva ahí; si ambas responden, agregue cada una.

Abra Verify ownership and activate chat junto a la dirección solicitada. Muestra el texto exacto que su sitio debe servir. Junto al archivo de su página de inicio, cree una carpeta llamada .well-known que contenga un archivo de texto simple llamado netshow-origin.txt. Ponga en ese archivo solo el texto exacto que se muestra y luego súbalo. En un navegador, abra https://your-address/.well-known/netshow-origin.txt; debe ver ese mismo texto directamente. La verificación no sigue redirecciones, así que la dirección solicitada y la del archivo deben coincidir exactamente.

Si el navegador muestra 403 o 404, puede que su hosting oculte las carpetas cuyo nombre empieza con punto; pregúntele cómo servir /.well-known/. Cuando se abra, presione Verify and activate. Si su hosting no puede servir ese archivo, agregue en su lugar la etiqueta de verificación que se muestra en el mismo panel dentro del <head> de su página de inicio, súbala y presione Verify and activate. El Hosted Share Link de la página Deploy siempre funciona como enlace a la página propia de su agente.

Si su sitio envía una política de seguridad

Agregue cada fuente de NetShow de abajo a la misma directiva de la Content-Security-Policy de su sitio:

script-src  https://app.netshow.ai;
connect-src https://app.netshow.ai;
img-src     https://app.netshow.ai;
frame-src   https://app.netshow.ai;
media-src   blob:;

Una etiqueta que nombra el host alterno https://claude.netshow.ai lo necesita en los mismos lugares. Una etiqueta con una URL de emisión de voz en tiempo real también necesita https://api.openai.com en connect-src.

script-src carga la etiqueta y su capa de escenario, connect-src permite que el agente responda, img-src muestra su cara, frame-src abre su panel de conversación y media-src blob: reproduce su voz. Deje sus propias entradas como están.

Lo que encuentran los visitantes, y cómo quitarlo

La página muestra la cara en vivo de su agente en su esquina. Un visitante la abre y toca Talk; el micrófono pide acceso solo después de ese toque. Sin micrófono ni altavoz, un visitante puede escribir desde el menú del agente.

Para quitar al agente de una página, borre la etiqueta y suba el cambio. En la página de inserción, el control Withdraw junto a la dirección cierra la puerta ahí, aunque una página antigua todavía tenga la etiqueta.

Lo que escuchan sus visitantes

En una dirección activa y verificada, su agente lee en voz alta cada respuesta escrita con la voz de NetShow. Una etiqueta que pegó antes no necesita cambios. En la página de inserción, cada dirección activa muestra NetShow voice a su lado. Si la voz no está disponible, la respuesta se queda en pantalla y Talk parpadea. El micrófono se abre solo después de que el visitante toca Talk.

Ponga a su agente en la página

Su agente también puede vivir en la página misma. En la página Deploy, en Your agent on your own pages, cada dirección verificada tiene un interruptor que dice “Put Ava on the page here”, con el nombre de su agente en lugar de Ava. Actívelo, vuelva a copiar el código Script y reemplace la etiqueta anterior en sus páginas.

Entonces su agente descansa en una esquina, se acopla en un panel lateral cuando un visitante lo toca (una hoja inferior en los teléfonos), sale a la página con “Set me free” y vuelve con “Bring me back”. Habla después de un toque; Type está en su menú pequeño. En las páginas de inicio de sesión y de pago se queda en su panel. Para apagarlo, desactive el interruptor y vuelva a copiar la etiqueta. La inserción con iFrame sigue siendo solo de conversación.

Cómo saluda su agente a sus visitantes

Cuando la etiqueta responde, su agente saluda primero a cada visitante: su cara en vivo está ahí de inmediato, su saludo aparece como subtítulo y habla al primer toque, clic o tecla del visitante, porque los navegadores mantienen el sonido apagado hasta entonces. Nunca reproduce un clip grabado ni la voz del navegador, dice que es una IA y un visitante puede interrumpirlo en cualquier momento.

¿Sigues con dudas?

La documentación completa explica a fondo los modelos, la voz, el conocimiento y los flujos de trabajo (en inglés).

Abrir la documentación