Cuando inserta un agente de Copilot Studio en su sitio web, el panel de chat a veces aparece completamente en blanco. Sin mensaje de bienvenida, sin respuesta y sin texto de error. Este problema suele ocurrir porque el dominio del sitio web no está autorizado en la configuración del canal de Copilot Studio, o porque falta una configuración de autenticación o de origen de datos requerida. Este artículo explica las tres causas raíz más comunes y proporciona los pasos exactos para restaurar la visualización del chat.
Puntos clave: Cómo solucionar un chat de sitio web en blanco en Copilot Studio
- Copilot Studio > Canales > Sitio web > Seguridad del dominio: Agregue el dominio de su sitio web activo a la lista de permitidos para evitar que se bloquee el chat.
- Copilot Studio > Configuración > Autenticación: Configure Microsoft Entra ID o el acceso anónimo para que el chat pueda cargarse para los visitantes sin una licencia de Microsoft 365.
- Copilot Studio > Temas > Reserva del sistema: Habilite un tema de reserva para mostrar un mensaje predeterminado si el agente no puede coincidir con ninguna entrada del usuario.
Por qué el chat del sitio web de Copilot Studio aparece en blanco
El panel de chat en blanco casi siempre se debe a uno de tres fallos técnicos. Primero, el agente de Copilot bloquea las solicitudes de dominios que no están listados en la configuración de seguridad del canal. Cuando un usuario visita su sitio web, el navegador envía una solicitud a Copilot Studio. Si el dominio no está autorizado, el servidor devuelve una respuesta vacía o un error de CORS, y la interfaz del chat no muestra nada.
Segundo, el método de autenticación está mal configurado. Copilot Studio admite dos modos para los canales de sitio web: acceso anónimo y acceso autenticado con Microsoft Entra ID. Si el acceso anónimo está desactivado y su sitio web no pasa un token válido, el agente se niega a responder. El panel de chat se carga pero permanece vacío porque no se intercambian datos.
Tercero, el agente no tiene temas activos o el tema de reserva del sistema está deshabilitado. Cuando un usuario escribe un mensaje, el agente intenta hacerlo coincidir con los temas existentes. Si ningún tema coincide y el tema de reserva está desactivado, el agente no devuelve nada. El chat permanece en blanco aunque la conexión funcione técnicamente.
Pasos para volver a habilitar el chat del sitio web en Copilot Studio
Siga estos pasos en el orden indicado. Pruebe el chat después de cada paso para poder identificar qué solución resolvió el problema.
Paso 1: Autorizar el dominio de su sitio web
- Abra Copilot Studio y seleccione su agente
Inicie sesión en copilotstudio.microsoft.com con su cuenta de Microsoft 365. En la navegación izquierda, seleccione Agentes y haga clic en el agente que muestra un chat en blanco en su sitio web. - Vaya a Canales > Sitio web
En el menú izquierdo, haga clic en Canales. En la lista Canales disponibles, seleccione Sitio web. Se abre la página de configuración del canal. - Agregue el dominio de su sitio web a la lista de permitidos
En Seguridad del dominio, verá un campo de texto etiquetado como Dominios permitidos. Escriba el dominio completo de su sitio web, por ejemplowww.example.com. Si su sitio usa varios subdominios, agregue cada uno en una nueva línea. No incluyahttp://nihttps://. Haga clic en Guardar en la parte superior de la página. - Vuelva a insertar el script del chat en su sitio web
Después de guardar, copie el código de inserción de la página del canal Sitio web. Reemplace la etiqueta de script antigua en su sitio web con este nuevo código. El chat ahora se cargará solo para los dominios que autorizó.
Paso 2: Configurar el acceso anónimo
- Vaya a Configuración > Autenticación
En Copilot Studio, haga clic en Configuración en el menú izquierdo. En la sección Seguridad, seleccione Autenticación. Esta página controla cómo se identifican los usuarios ante el agente. - Habilitar el acceso anónimo
Establezca el interruptor Permitir acceso anónimo en Activado. Esto permite que los visitantes sin una cuenta de Microsoft 365 interactúen con el chat. Si necesita acceso autenticado para escenarios con datos confidenciales, mantenga este interruptor Desactivado y configure Microsoft Entra ID en su lugar. Para la mayoría de los sitios web públicos, el acceso anónimo es la opción correcta. - Guarde y vuelva a publicar el agente
Haga clic en Guardar. Luego vaya a la sección Publicar en el menú izquierdo y haga clic en Publicar. Los cambios se aplican al sitio web activo en unos minutos.
Paso 3: Habilitar el tema de reserva del sistema
- Abra Temas > Sistema
En el menú izquierdo, seleccione Temas. En la parte superior de la lista de temas, cambie el filtro de Personalizado a Sistema. Verá un tema llamado Reserva. - Active el tema de reserva
Haga clic en el tema Reserva. En el editor de temas, asegúrese de que el interruptor Estado en la parte superior derecha esté establecido en Activado. Si está Desactivado, haga clic en el interruptor para habilitarlo. El tema de reserva se activa cuando el agente no puede encontrar un tema coincidente para el mensaje del usuario. - Edite el mensaje de reserva
En el tema de reserva, verá un nodo de mensaje. Reemplace el texto predeterminado con algo útil, como “No entendí su pregunta. Vuelva a formularla o comuníquese con soporte técnico”. Haga clic en Guardar y vuelva a publicar el agente.
Paso 4: Verificar el código de inserción del chat
- Revise la etiqueta de script en su sitio webAbra el archivo HTML o la plantilla del CMS de su sitio web. Localice la etiqueta de script que carga el agente de Copilot. Debería verse similar a
. Asegúrese de que la URL<script src="https://copilotstudio.microsoft.com/..."></script>sea correcta y no esté truncada.src - Confirme que el script esté colocado antes de la etiqueta de cierre del cuerpoMueva la etiqueta de script justo antes de
si aún no está allí. Esto garantiza que el DOM de la página se cargue por completo antes de que se inicialice el chat.</body> - Borre la caché del navegador y pruebeAbra una ventana de navegación incógnita o privada. Navegue a su sitio web. El chat ahora debería mostrar un mensaje de bienvenida o un cuadro de entrada. Si sigue en blanco, continúe con la siguiente sección.
Si el chat sigue en blanco después de la solución principal
El chat funciona en localhost pero no en el dominio activo
Esto confirma que la configuración de seguridad del dominio es el problema. Es probable que haya omitido agregar el dominio activo exacto a la lista de permitidos. Vuelva a
Canales > Sitio web > Seguridad del dominio y verifique la ortografía del dominio. Incluya el subdominio si su sitio usa . Por ejemplo, agregue tanto www como example.com si ambos redirigen a su sitio.www.example.com
El chat muestra un indicador de carga que nunca termina
Un indicador de carga persistente suele indicar un problema de red o de CORS. Abra las herramientas de desarrollo de su navegador (F12) y revise la pestaña Consola. Si ve un error de CORS, el dominio no está autorizado o el script de inserción está siendo bloqueado por una política de seguridad de contenido. Agregue el dominio de Copilot Studio
al encabezado Content-Security-Policy de su sitio web.copilotstudio.microsoft.com
El chat se carga pero no devuelve respuestas a los mensajes del usuario
Esto apunta a un problema de configuración de temas. El agente no tiene temas que coincidan con la entrada del usuario, y el tema de reserva está desactivado o vacío. Vuelva a
Temas > Sistema > Reserva y confirme que esté habilitado. También revise sus temas personalizados: si todos tienen condiciones de desencadenador complejas, simplifíquelas para capturar más frases del usuario.
Canal de sitio web de Copilot Studio: acceso anónimo vs. autenticado
| Elemento | Acceso anónimo | Acceso autenticado (Microsoft Entra ID) |
|---|---|---|
| Quién puede chatear | Cualquier visitante sin iniciar sesión | Solo usuarios con una cuenta de Microsoft 365 en su inquilino |
| Complejidad de configuración | Interruptor simple en Configuración > Autenticación | Requiere registro de aplicación en el portal de Azure y generación de tokens |
| Acceso a datos | El agente usa solo orígenes de conocimiento estáticos | El agente puede acceder a datos de Microsoft 365 específicos del usuario |
| Caso de uso | Preguntas frecuentes públicas, marketing, soporte | Portales internos de empleados, autoservicio de RR. HH. |
| Riesgo de chat en blanco | Bajo si el dominio está autorizado | Alto si el token falta o está expirado |
Para la mayoría de los sitios web públicos, el acceso anónimo es el método correcto. El acceso autenticado está pensado para portales corporativos internos donde cada visitante tiene una identidad de Microsoft 365. Si elige el acceso autenticado, debe implementar la generación de tokens en el backend de su sitio web y pasar el token al SDK de chat de Copilot.
Después de completar los pasos anteriores, el canal de sitio web de Copilot Studio debería mostrar un panel de chat totalmente funcional. Pruebe el chat en varios navegadores y dispositivos. Si la pantalla en blanco persiste, revise los encabezados Content-Security-Policy de su sitio web y asegúrese de que permitan scripts desde copilotstudio.microsoft.com y todos los subdominios. Como sugerencia avanzada, use el panel Test Agent de Copilot Studio para enviar mensajes de prueba directamente en el estudio antes de probar el sitio web activo.