Cómo añadir el chatbot de IA de Asyntai a Umbraco
Guía paso a paso para sitios web de Umbraco CMS
Paso 1: Obtén su código de inserción
Primero, ve a su Panel de control de Asyntai y desplácese hasta la sección "Código de inserción". Copie su código de inserción único que se verá así:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Nota: El código anterior es solo un ejemplo. Debe copiar su propio código de inserción único desde su Panel de control ya que contiene su ID de widget personal.
Paso 2: Editar la plantilla maestra (Recomendado)
La forma más fácil de agregar el chatbot a todas las páginas es editando su plantilla Master:
- Inicia sesión en su Umbraco Backoffice
- Ve a Settings en la barra lateral izquierda
- Expande Templates
- Haga clic en su plantilla Master (o la plantilla de diseño principal que use su sitio)
- Encuentra la etiqueta de cierre
</body> - Pegue su código de inserción de Asyntai justo antes de la etiqueta
</body> - Haga clic en "Save"
Consejo: Añadir el script antes de la etiqueta de cierre </body> asegura que se cargue después del contenido de la página, lo cual es recomendado para widgets de chat y no ralentizará la carga de su página.
Alternativa: Usar el tipo de documento Site Settings
Para mayor flexibilidad, puede agregar un campo personalizado para gestionar scripts del pie de página:
- Ve a Settings → Document Types
- Edita su tipo de documento Site Settings (o cree uno si no existe)
- Agrega una nueva propiedad llamada "Footer Scripts" con un tipo de dato Textarea
- Guarde el tipo de documento
- Ve a Content y edita su nodo de Site Settings
- Pegue su código de inserción de Asyntai en el campo Footer Scripts
- En su plantilla Master, agrega este código antes de
</body>:@Html.Raw(Model.Value("footerScripts")) - Guarde tanto el contenido como la plantilla
Nota: Usar @Html.Raw() es importante para renderizar las etiquetas de script correctamente sin codificación HTML.
Alternativa: Usar la carpeta Scripts
También puede crear un archivo JavaScript en el Umbraco Backoffice:
- Ve a Settings → Scripts
- Haga clic derecho en Scripts y seleccione "Create"
- Cree un nuevo archivo llamado asyntai-chatbot.js
- Añada el siguiente código:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Reemplaza
YOUR_WIDGET_IDcon su ID de widget real - Guarde el archivo
- Incluye este script en su plantilla Master antes de
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Alternativa: Específico por página con RenderSection
Si solo quiere el chatbot en páginas específicas:
- En su plantilla Master, agrega antes de
</body>:@RenderSection("footerScripts", required: false) - In the specific page template where you want the chatbot, add:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Paso 3: Verificar la instalación
Después de guardar sus cambios, visite su sitio web en una nueva pestaña del navegador o en una ventana de incógnito. Deberías ver el botón del widget de chat en la esquina inferior derecha. Haga clic en él para asegurarte de que se abra y funciona correctamente.
¿No ves el widget? Asegúrese de haber guardado la plantilla después de hacer cambios. Intenta limpiar el caché de su navegador o ver en una ventana de incógnito. Si estás usando Umbraco Cloud, los cambios deberían desplegarse automáticamente. Para Umbraco autoalojado, puede que necesites reiniciar la aplicación o vaciar el caché.
Weebly