Incrustar un Chatbot de IA en tu sitio web
Integración en el Sitio web
Esta es la forma universal de añadir su chatbot a cualquier sitio web. Solo tiene que pegar dos líneas cortas en el HTML de su sitio: una etiqueta <script> que carga el widget y un elemento <web-chat-agent> que le indica qué chatbot mostrar. Eso es todo, la burbuja de chat flotante aparecerá en la esquina de cada página donde se ejecute el código.
Si utiliza WordPress, TYPO3, Shopify, Wix, Squarespace o Webflow, consulte la guía específica para su plataforma, donde se muestra con exactitud dónde pegar este mismo código.
Dónde encontrar su ID del chatbot
No es necesario escribir el identificador a mano. En el panel de WebChatAgent:
- Abra su chatbot.
- Vaya a Canales → Widget de chat y despliegue Mostrar detalles de instalación.
- Haga clic en el botón de copiar dentro del cuadro de código.
El fragmento copiado ya incluye su ID del chatbot, por lo que solo tiene que pegarlo. (Si alguna vez necesita el identificador sin procesar por separado, es la cadena larga que aparece en la URL del panel: /dashboard/<your-chatbot-id>).
El código para pegar
Pegue esto justo antes de la etiqueta de cierre </body> de su sitio:
<script src="https://webchatagent.com/widget/web-chat-agent.js" async></script>
<web-chat-agent chatbot-id="YOUR_ID"></web-chat-agent>
Reemplace YOUR_ID por su ID del chatbot (o, de forma más sencilla, copie el fragmento predefinido del panel para que el identificador ya esté insertado). El widget se carga de forma asíncrona, de modo que no ralentiza la página, y se muestra como un botón de chat flotante en la esquina inferior.
Atributos opcionales
El widget obtiene sus colores, título, mensaje de bienvenida y comportamiento a partir de la configuración del panel, por lo que normalmente solo necesita chatbot-id. Para sobrescribir algunos parámetros directamente en el HTML, añada estos atributos al elemento <web-chat-agent>:
chatbot-id— Su ID del chatbot. Obligatorio.theme— Estilo visual:"default"o"modern". El valor predeterminado es"default".initially-open— Establézcalo en"true"para abrir el chat automáticamente cuando cargue la página. El valor predeterminado es"false"(cerrada).tracking-consent— Señal de consentimiento opcional para la personalización persistente:"unknown","denied"o"granted". Si se omite, se establece de forma predeterminada en"unknown"y los activadores locales anónimos siguen funcionando.context-data— Contexto de sesión de su página para la IA (por ejemplo,"Customer=Acme GmbH;OrderID=A-1023"), útil cuando el widget se ejecuta dentro de un CRM o una zona con inicio de sesión. Formatos, límites y notas de seguridad en la guía para desarrolladores.
<web-chat-agent
chatbot-id="YOUR_ID"
theme="modern"
initially-open="false"
></web-chat-agent>
Todo lo demás, el color de marca, el avatar, las fuentes, la posición y el comportamiento, se configura en Canales → Widget de chat, para que no tenga que modificar el código de nuevo para cambiar el estilo del widget. La personalidad del asistente se configura en Configuración → Estilo y función de las respuestas.
Consentimiento de cookies y activadores proactivos
El widget no añade un segundo banner de cookies. Sin una señal de consentimiento, se ejecuta en el Modo de Privacidad anónimo: los activadores por tiempo, desplazamiento, intención de salida, inactividad, URL, visibilidad y clics reiterados se evalúan de forma local en la memoria. El reconocimiento de visitantes recurrentes, los contadores persistentes, la analítica proactiva y los saludos generados por IA requieren una señal de tipo granted.
Consulte Consentimiento de cookies y activadores proactivos anónimos para ver la matriz completa de comportamientos, ejemplos de CMP y la referencia de almacenamiento.
Integrar el chat dentro de la página
El fragmento anterior ofrece un botón flotante. Si prefiere situar el chat dentro del diseño de su página, por ejemplo, un panel de chat completo en una página de soporte específica, utilice el widget integrado. Este carga un script diferente y un elemento diferente:
<script src="https://webchatagent.com/widget/chat-widget-inline.js" async></script>
<web-chat-agent-inline chatbot-id="YOUR_ID"></web-chat-agent-inline>
El chat integrado se renderiza en el lugar exacto donde ubique el elemento, así que colóquelo dentro del contenedor en el que desee que resida el chat. Consulte la guía de Chat integrado para ver los detalles sobre la maquetación.
Funciona en todas partes
Ambos fragmentos consisten en HTML estándar y un elemento personalizado, por lo que funcionan en cualquier plataforma web: WordPress, TYPO3, Shopify, Wix, Squarespace, Webflow y sitios HTML/JS desarrollados a mano. Pegue el código en el HTML de su sitio web y publique.
Resolución de problemas
- ¿No aparece el widget? Asegúrese de que el código esté en el HTML de la página (antes de
</body>) y de haber publicado los cambios o borrado la caché de cualquier plugin. Revise la consola del navegador para comprobar si hay scripts bloqueados. - ¿Solo se muestra en una página? Inserte el fragmento en una ubicación global de todo el sitio web (pie de página o código global), no en una única página.
