Cómo instalar el widget en tu web

El widget es el chat que aparece en tu web. Se instala pegando una línea de código, y funciona en cualquier sitio donde puedas insertar HTML.

Paso 1 — Copia el snippet

En el panel, entra en tu bot → pestaña Widget → sección Snippet embebible. Tiene esta forma:

<script
  src="https://panel.botdesk.ai/widget.js"
  data-api-key="TU_API_KEY"
  data-bot-id="..."
></script>

El data-bot-id ya viene puesto: identifica a qué bot pertenece la conversación. Sin él, el asistente no sabría de qué bot es y perdería su calendario y sus etiquetas.

Paso 2 — Sustituye la API key

Necesitas una clave activa. Se crean en Cuenta → API Keys.

Copia la clave y sustituye TU_API_KEY en el snippet. La clave solo se muestra una vez al crearla, así que guárdala.

Paso 3 — Pégalo en tu web

Justo antes de la etiqueta </body>.

WordPress: en el tema, en footer.php, o con cualquier plugin de los que insertan código en el pie.

Shopify: en Tienda online → Temas → Editar código, dentro de theme.liquid, antes de </body>.

Webflow, Squarespace, Wix: todos tienen una sección de código personalizado en los ajustes del sitio.

Web propia: antes de </body> en tu plantilla.

Paso 4 — Compruébalo

Abre tu web y busca la burbuja del chat. Escríbele algo que esté en tu conocimiento.

Si estabas probando en la misma pestaña, ten en cuenta que la sesión se guarda: para probar como un visitante nuevo, abre una pestaña nueva o una ventana de incógnito.

Personalizar el aspecto

Desde la misma pestaña Widget puedes cambiar el color de acento, la posición, el avatar, el mensaje de bienvenida y las preguntas sugeridas que aparecen al abrirlo.

Restringir en qué dominios funciona

En Dominios permitidos puedes limitar en qué webs se carga tu widget. Si lo dejas vacío, funciona en cualquiera que tenga el snippet — algo a tener en cuenta si tu clave llega a manos ajenas.

Si no aparece

Comprueba que el snippet está antes de </body> y no dentro del <head>.

Comprueba la clave. Si la API key está revocada o mal copiada, el widget no carga la configuración y no se muestra.

Mira la consola del navegador. El widget avisa ahí cuando no encuentra la clave o no puede conectar.