Integra un Centro de búsqueda en tu web
Usa el Embed code generado cuando el Centro de búsqueda deba aparecer dentro de una página que controlas. La integración necesita el runtime de Seekdown, un contenedor y el ID srch-… del Centro de búsqueda.
Añade el código de integración público
La estructura documentada es:
<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>
<div id="seekdown-assistant-root"></div>
<script>
document.addEventListener('DOMContentLoaded', function () {
if (window.skdwn && window.skdwn.startAssistant) {
skdwn.startAssistant({
assistantId: 'srch-your-search-center-id',
accessToken: ''
});
}
});
</script>Sustituye el ID de ejemplo por el valor del fragmento generado para tu Centro de búsqueda. Un token de acceso vacío solo es adecuado para un Centro de búsqueda público con autenticación None.
Colócalo con intención
Añade el contenedor donde deba mostrarse la experiencia de búsqueda. Deja a la página suficiente anchura para las tarjetas de resultados y prueba su altura tras una respuesta corta y otra larga.
No añadas el mismo ID de contenedor dos veces en una página. El runtime apunta a #seekdown-assistant-root.
Verifica la implementación
| Entrada o acción | Resultado esperado | Cómo verificarlo |
|---|---|---|
| Cargar la página | La interfaz de búsqueda aparece en el contenedor | Revisa la consola del navegador por si hay errores de script |
| Elegir una sugerencia | Se ejecuta la consulta | Confirma el texto seleccionado y el resultado |
| Hacer una pregunta conocida | Aparecen la respuesta y los documentos correctos | Compara con la fuente esperada |
| Abrir una tarjeta de fuente | Se abre la página original | Revisa el destino y el texto de apoyo |
| Cambiar el tamaño de la página | La interfaz sigue siendo usable | Prueba ventanas estrechas y anchas |
Diagnostica una integración en blanco
Revisa la URL del runtime, el ID del contenedor, el ID del Centro de búsqueda y la llamada de inicialización, en ese orden. En un Centro de búsqueda privado, revisa también el token de acceso y Allowed origins.
Usa el fragmento copiado en lugar de reconstruir los ID a partir de una URL pública. Si el acceso anónimo no es adecuado, configura un Centro de búsqueda privado antes de publicar la integración.