Add Comments to Your LMS via LTI 1.3

1. Inicia sesión en FastComments y ve a tu página de configuración LTI 1.3.
2. (Opcional) Elige la plataforma desde la que te conectas en el desplegable Platform - establece la etiqueta de visualización, pero Auto-detect funciona bien.
3. Haz clic en Generate URL. Aparecerá una Registration URL de un solo uso (válida durante 30 minutos).
4. En tu LMS, abre la pantalla de Registro Dinámico LTI 1.3 y pega la URL en el campo Tool initiation registration endpoint (o equivalente). Envía.
5. Tu LMS realiza una llamada de retorno a FastComments, intercambia claves y crea la integración. La ventana emergente se cierra automáticamente cuando termina.
6. De vuelta en FastComments, la nueva configuración aparece en la tabla Existing Configurations. La herramienta ya está disponible dentro de los cursos de tu LMS.

FastComments LTI 1.3 se ha probado con:

• D2L Brightspace (cualquier versión con LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS y Ultra)
• Sakai (versiones con soporte LTI Advantage)
• Schoology (Enterprise, Dynamic Registration cuando esté disponible)

Cualquier otro LMS que implemente la especificación IMS LTI 1.3 Advantage con Dynamic Registration también debería funcionar: seleccione Other LTI 1.3 platform en el menú desplegable de plataformas al generar su URL de registro (obténla aquí).

Canvas LMS utiliza un flujo de configuración diferente (per-developer-key configuration JSON en lugar de Dynamic Registration). Consulte la guía de instalación dedicada de Canvas LMS.

Navegar a la Configuración LTI 1.3

Inicie sesión en FastComments y vaya a su página de Configuración LTI 1.3.

Si su cuenta aún no tiene acceso LTI, verá "LTI no está habilitado para esta cuenta" - póngase en contacto con el soporte para habilitarlo en su plan.

Seleccione una plataforma (Opcional)

En Generar una URL de registro dinámica, use el desplegable Plataforma para indicar a FastComments a qué LMS se está conectando:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Otra plataforma LTI 1.3

También puede dejarlo en Detección automática. La plataforma se lee desde la openid-configuration de su LMS durante el registro; el desplegable solo establece la etiqueta de visualización para la configuración resultante.

Generar la URL

Haga clic en Generar URL. FastComments crea un token de registro de un solo uso y le muestra una URL que se ve así:

https://fastcomments.com/lti/v1p3/register/<long-token>

Cópiela. Esta URL:

• Es de uso único - una vez que su LMS la llame correctamente, el token se consume.
• Expira después de 30 minutos si no se utiliza.
• Debe mantenerse privada - cualquiera que tenga la URL puede registrar una herramienta en su tenant dentro de esos 30 minutos.

Configuraciones existentes

Una vez que se complete un registro con éxito, la nueva configuración aparece en la tabla Configuraciones existentes en la misma página, con su Plataforma, Emisor, ID de Cliente y Estado. Puede eliminar configuraciones de esta tabla si alguna vez necesita anular el registro.

D2L Brightspace expone el Registro dinámico a través de la interfaz de administración de LTI Advantage. Necesitará acceso de administrador.

Abra la pantalla de registro

1. Inicie sesión en su instancia de Brightspace como administrador.
2. Navegue a Admin Tools > Manage Extensibility > LTI Advantage.
3. Haga clic en Register Tool. (La URL directa es https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Pegue la URL

Verá un formulario de registro. El campo clave es Endpoint de registro de inicio de la herramienta (algunas versiones de Brightspace lo etiquetan como "Tool Initiation Registration URL").

Pegue la URL de registro de FastComments (consíguelo aquí) en ese campo. Deje los demás campos en blanco: FastComments los completa automáticamente durante el intercambio de registro.

Haga clic en Registrar.

Apruebe la herramienta

Brightspace abre una ventana emergente que se comunica con FastComments, intercambia claves y muestra una pantalla de confirmación. La ventana emergente se cierra sola cuando se completa el registro.

La nueva herramienta aparece en la lista de herramientas de LTI Advantage. Por defecto Brightspace marca las herramientas nuevas como deshabilitado: cambie el interruptor a habilitado para que sus cursos puedan usarla.

Agregar un despliegue

En Brightspace, las herramientas LTI necesitan un despliegue antes de poder usarse en los cursos:

1. Abra la herramienta FastComments recién registrada.
2. Haga clic en Ver despliegues > Nuevo despliegue.
3. Asigne un nombre al despliegue (p. ej. "FastComments - All Courses"), seleccione las unidades organizativas en las que debe estar disponible y guarde.

Tras el primer lanzamiento a través de este despliegue, FastComments fija el deployment_id en su registro de configuración: los lanzamientos posteriores desde un despliegue distinto bajo el mismo cliente serán rechazados a menos que vuelva a registrarlo.

¿Usas Moodle? También publicamos un plugin dedicado para Moodle de FastComments con una integración más estrecha que LTI 1.3 (ganchos de sincronización de calificaciones, informes de actividad más detallados, interfaz de configuración nativa de Moodle). Consulta la guía de instalación del plugin de Moodle. El flujo LTI 1.3 que se muestra a continuación es la opción adecuada si quieres un registro único que también cubra otros LMSes, o si el administrador de Moodle no instalará plugins de terceros.

Moodle 4.0+ admite LTI 1.3 Dynamic Registration a través del plugin External Tool.

Abre la pantalla de gestión de herramientas

1. Inicia sesión en Moodle como administrador del sitio.
2. Navega a Site administration > Plugins > Activity modules > External tool > Manage tools.

Pega la URL

Verás una tarjeta etiquetada Tool URL. Pega la URL de registro de FastComments (consíguela aquí) en el campo de texto y haz clic en Add LTI Advantage.

Moodle abrirá una pantalla de registro que muestra la identidad de la herramienta y los permisos que solicita. Revisa y haz clic en Activate (o Register, según la versión de Moodle).

La ventana emergente se cierra cuando se completa el registro; la nueva herramienta FastComments aparece en la lista Tools con el estado Active.

Hazla disponible

Por defecto, Moodle añade nuevas herramientas a la lista "Course tools" pero no las muestra en el selector de actividades. Para exponer FastComments en todo el curso:

1. Haz clic en el icono de engranaje del mosaico de FastComments.
2. En Tool configuration usage, selecciona Show in activity chooser and as a preconfigured tool.
3. Save.

Los instructores ahora pueden añadir FastComments a cualquier curso mediante Add an activity or resource > FastComments.

Blackboard Learn SaaS y Ultra son compatibles con el registro dinámico LTI 1.3.

Open the Tool Provider Screen

1. Inicia sesión en Blackboard como administrador del sistema.
2. Navega a Administrator Panel > Integrations > LTI Tool Providers.
3. Haz clic en Register LTI 1.3 / LTI Advantage Tool.

Si solo ves "Register LTI 1.1 Provider", tu versión de Blackboard aún no es compatible con LTI 1.3: actualiza o contacta con el soporte de Blackboard.

Paste the URL

Pega la URL de registro de FastComments (consíguela aquí) en el campo Client ID / Registration URL (la denominación de Blackboard varía según la versión). Envía.

Blackboard realiza el intercambio de registro con FastComments y te muestra una pantalla de confirmación.

Approve and Enable

Blackboard marca las herramientas recién registradas como Approved but excluded por defecto:

1. Busca la entrada de FastComments en la lista de proveedores de herramientas.
2. Abre el menú y elige Edit.
3. Ajusta Tool Status a Approved.
4. En Institution Policies, revisa qué datos de usuario se envían (nombre, correo electrónico, rol). Guardar.

La herramienta ya está disponible para los instructores cuando añaden contenido a los cursos.

Sakai

Sakai es compatible con LTI 1.3 Dynamic Registration en las versiones que incluyen LTI Advantage. Desde el Espacio de Administración:

1. Inicia sesión como administrador de Sakai y abre el Espacio de Administración.
2. Elige Herramientas externas > Instalar herramienta LTI 1.3.
3. Pega la URL de registro de FastComments (consíguelo aquí) y envía.
4. Aprueba la herramienta cuando se complete el handshake.

La herramienta aparecerá entonces bajo Herramientas externas y puede añadirse a los sitios por sus mantenedores.

Schoology

Las instancias Enterprise de Schoology son compatibles con LTI 1.3, pero la disponibilidad del Registro Dinámico varía según la implementación. Consulta con tu gestor de cuenta de Schoology.

Si el Registro Dinámico no está disponible en tu instancia de Schoology, tendrás que configurar la integración manualmente usando estos endpoints:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

Después de que Schoology te proporcione un Client ID y Deployment ID, contacta con el soporte de FastComments para registrar la configuración en tu tenant.

Other LTI 1.3 Platforms

Cualquier LMS que siga la especificación IMS LTI 1.3 Advantage debería funcionar con la misma URL de registro (consíguelo aquí). Busca una opción etiquetada como "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" o similar.

Si tu plataforma solo admite la configuración manual de LTI 1.3, usa los cuatro endpoints listados en la sección de Schoology más arriba y contacta con soporte para finalizar.

Esta página trata sobre cómo añadir FastComments a un curso de Brightspace después de que un administrador haya registrado la herramienta y creado una implementación. Si la herramienta aún no está registrada, consulte primero la guía de registro de D2L.

FastComments incrustado como un tema de unidad en Brightspace

Brightspace ofrece dos experiencias de creación de contenido: Contenido clásico y la Nueva experiencia de contenido (también llamada Lecciones). Ambas exponen FastComments, pero las rutas del menú difieren. Cada sección a continuación cubre ambas cuando divergen.

Localizar la herramienta FastComments

La herramienta FastComments aparece en dos lugares dentro del editor de contenido de un curso:

1. El selector de actividades, al que se accede desde el botón Agregar existente de un módulo/unidad (etiquetado Agregar actividades existentes en versiones antiguas de Brightspace). FastComments aparece directamente en el selector en las versiones actuales de Brightspace; las versiones antiguas lo anidan bajo un submenú Herramientas de aprendizaje externas. Cualquiera de las dos rutas añade FastComments como un tema independiente.
2. El cuadro de diálogo Insertar contenido dentro del editor HTML, bajo LTI Advantage. Esto incrusta FastComments en línea en un tema HTML mediante el flujo de enlace profundo LTI.

Si FastComments no aparece en ninguno de los selectores, la implementación no está habilitada para la unidad organizativa que contiene el curso. Pida a su administrador de Brightspace que abra Herramientas de administración > Administrar extensibilidad > LTI Advantage > herramienta FastComments > Ver implementaciones, abra la implementación y añada la unidad organizativa del curso (o una unidad organizativa superior) bajo Unidades organizativas.

Añadir FastComments como un tema en un módulo

Contenido clásico:

1. Abra el curso y haga clic en Contenido en la barra de navegación.
2. Seleccione el módulo que debe contener la discusión (o cree uno mediante Agregar un módulo).
3. Haga clic en Agregar existente (Brightspace antiguo: Agregar actividades existentes > Herramientas de aprendizaje externas).
4. En el selector, haga clic en FastComments. Brightspace crea un tema en el módulo y le devuelve a la vista de contenido.
5. Haga clic en el nuevo tema. Cambie el nombre a algo descriptivo como FastComments Discussion usando el editor de título en línea.

Nueva experiencia de contenido (Lecciones):

1. Abra el curso y haga clic en Contenido.
2. Abra la unidad y la lección que debe contener la discusión.
3. Haga clic en Agregar > Actividad existente y seleccione FastComments (Brightspace antiguo: anidado bajo Herramientas de aprendizaje externas).
4. La actividad se añade a la lección.
5. Haga clic en el título de la actividad para renombrarla.

La primera vez que cualquier usuario (instructor o estudiante) abra el tema, FastComments inicializa el hilo para ese enlace de recurso. El hilo está vinculado al ID de enlace de recurso, por lo que renombrar o mover el tema no cambia qué hilo se carga.

Incrustar FastComments en línea en un tema HTML

Use este flujo cuando quiera que los comentarios aparezcan debajo de una lectura, video u otro contenido dentro de la misma página del tema en lugar de como un tema separado.

1. Abra o cree un tema HTML en el módulo/lección.
2. Haga clic en Editar HTML para abrir el editor HTML de Brightspace.
3. Coloque el cursor donde debe aparecer el hilo de comentarios.
4. Haga clic en el botón Insertar contenido (icono de pieza de rompecabezas en la barra de herramientas del editor).
5. En el cuadro de diálogo Insertar contenido, desplácese hasta LTI Advantage y haga clic en FastComments.
6. FastComments abre un selector de enlace profundo. Confirme la ubicación (las opciones predeterminadas funcionan para discusiones de contenido); haga clic en Insertar o Continuar.
7. Brightspace regresa al editor HTML con un bloque marcador que representa el lanzamiento LTI. Haga clic en Guardar y cerrar en el tema.

Cuando se carga el tema, Brightspace reemplaza el marcador por un iframe que lanza automáticamente FastComments vía LTI. Los estudiantes ven el hilo de discusión en línea.

Un único tema HTML puede contener múltiples incrustaciones de FastComments mediante enlaces profundos. Cada incrustación obtiene su propio hilo porque cada enlace profundo produce un ID de enlace de recurso distinto.

Tema del módulo vs enlace rápido incrustado

Elija el enfoque de tema del módulo cuando:

• La discusión sea la actividad principal para ese paso en el módulo.
• Desee que el tema aparezca en la tabla de contenidos de Brightspace, en el seguimiento de finalización y en Class Progress.

Elija el enfoque de incrustación en línea cuando:

• Los comentarios deban situarse debajo de otro contenido en la misma página.
• No quiera un elemento separable con seguimiento de finalización en la tabla de contenidos.

Visibilidad, borrador y condiciones de publicación

Un nuevo tema de FastComments es visible para los estudiantes por defecto. Para ocultarlo mientras lo configura:

1. En el editor de contenido, haga clic en el título del tema (Contenido clásico) o en el menú de tres puntos de la actividad (Nueva experiencia de contenido).
2. Establezca el estado en Borrador (Contenido clásico) o desactive la Visibilidad (Nueva experiencia de contenido).

Los temas en borrador son invisibles para los estudiantes. Los instructores y asistentes de enseñanza todavía los ven con una insignia de "Borrador".

Para restringir el tema a un grupo o sección específicos:

1. Abra el tema.
2. Haga clic en el menú del título del tema > Editar propiedades en el lugar (Contenido clásico) o Editar > Restricciones (Nueva experiencia de contenido).
3. Bajo Condiciones de publicación, haga clic en Crear.
4. Elija Matrícula de grupo o Matrícula de sección, seleccione el grupo/sección y guarde.

Las condiciones de publicación se apilan con el propio mapeo de roles de FastComments. Los estudiantes que no pueden ver el tema no reciben un lanzamiento LTI.

Qué ven los estudiantes en el primer lanzamiento

Cuando un estudiante hace clic en el tema (o carga un tema HTML con una incrustación):

1. Brightspace realiza el lanzamiento LTI 1.3 en segundo plano.
2. FastComments recibe el nombre del estudiante, correo electrónico, URL del avatar y rol en el LMS, y lo conecta automáticamente. No aparece ningún aviso de inicio de sesión de FastComments.
3. El hilo de comentarios para ese enlace de recurso se renderiza dentro del iframe de Brightspace.

Mapeo de roles en el lanzamiento:

• Brightspace Administrator se convierte en un administrador de FastComments para el hilo (moderación completa, eliminar, prohibir y acceso a la configuración).
• Brightspace Instructor se convierte en un moderador de FastComments (fijar, ocultar, eliminar, prohibir).
• Todos los demás roles (Learner, TeachingAssistant, etc.) se convierten en comentaristas estándar.

Los comentarios se atribuyen a la cuenta de Brightspace del estudiante. Si el estudiante edita su nombre o avatar en Brightspace, el siguiente lanzamiento LTI sincroniza el cambio.

Altura del iframe y cambio de tamaño

FastComments emite el postMessage org.imsglobal.lti.frameResize en cada renderizado de hilo y en los cambios de contenido (nuevo comentario, expansión de respuestas). Brightspace escucha este mensaje y ajusta la altura del iframe para que el hilo no se corte y no muestre una barra de desplazamiento interna.

Si el iframe se queda con una altura fija y corta:

• Confirme que el curso se carga mediante HTTPS. El listener de postMessage de Brightspace rechaza frames de contenido mixto.
• Confirme que ninguna extensión del navegador está bloqueando el canal postMessage.
• Para incrustaciones en línea en un tema HTML, el HTML circundante no debe envolver el iframe en un contenedor de altura fija. Elimine cualquier style="height: ..." en línea del elemento padre.

Problemas específicos de Brightspace

La herramienta no aparece en el selector Agregar existente. La implementación no está habilitada para la unidad organizativa de este curso. Un administrador necesita añadir la unidad organizativa (o una superior) a la lista de Unidades organizativas de la implementación. El registro de la herramienta por sí solo no es suficiente; la implementación determina qué cursos ven la herramienta.

deployment_id mismatch on launch. FastComments fija por TOFU el primer deployment_id que ve para un registro. Si un administrador elimina la implementación original y crea una nueva, los lanzamientos desde la nueva implementación son rechazados con un error de coincidencia de implementación. La solución es volver a registrar FastComments (genere una nueva URL de registro (consíguela aquí) y ejecute el Registro Dinámico de nuevo); el registro de configuración antiguo se reemplaza.

La herramienta se lanza pero muestra "Invalid LTI launch". El curso está en una estructura de inquilino/organización diferente a la que cubre la implementación, o la implementación se deshabilitó después del registro. Verifique nuevamente Herramientas de administración > Administrar extensibilidad > LTI Advantage > FastComments > conmutador Habilitado y la lista de unidades organizativas de la implementación.

Faltan nombres y roles dentro de FastComments. Brightspace envía lanzamientos LTI con claims de Names and Role Provisioning Services (NRPS). Si un curso se actualizó desde un enlace LTI 1.1 antiguo, el lanzamiento carece de claims name y email. Vuelva a añadir el tema de FastComments mediante Agregar existente (no migre el enlace antiguo) para que el lanzamiento utilice LTI 1.3.

La incrustación muestra una pantalla de inicio de sesión en lugar de SSO automático. El tema HTML se insertó como un <iframe> simple apuntando a FastComments en lugar de mediante Insertar contenido > LTI Advantage. Los iframes simples omiten el lanzamiento LTI y llevan a los usuarios a la página pública de FastComments. Elimine el iframe y vuelva a insertarlo mediante el flujo Insertar contenido.

Una vez que un administrador haya registrado FastComments como una herramienta LTI 1.3 Advantage y aprobado las políticas de la institución, los instructores la añaden a los cursos a través de los puntos de colocación estándar de Blackboard. Los pasos exactos difieren entre Ultra Course View y Original Course View, por lo que ambos se tratan a continuación.

Ultra Course View

Ultra Course View es la vista predeterminada en Blackboard Learn SaaS desde 2026.

1. Abra el curso y vaya a la página Course Content.
2. Pase el cursor o toque donde quiera que aparezca el hilo de comentarios en el esquema y haga clic en el botón morado + (Agregar contenido).
3. Elija Content Market. El panel Content Market lista todas las herramientas LTI aprobadas y las colocaciones de Building Block para su institución.
4. Busque el mosaico FastComments y haga clic en él. Blackboard crea un elemento de contenido en la posición donde abrió el menú +.
5. El elemento aparece en el esquema como una entrada "Visible to students" por defecto para los instructores que tienen Hide from students desactivado como su valor predeterminado personal. Si su valor predeterminado es Hidden, el elemento se crea como oculto y usted activa el selector de visibilidad en la fila del elemento cuando esté listo.
6. Para cambiar el nombre del elemento, haga clic en el título en el esquema y escriba una nueva etiqueta. El título que ven los estudiantes en el esquema es independiente del identificador del hilo de FastComments, por lo que renombrarlo es seguro en cualquier momento.

Si no ve Content Market como opción, su institución tiene la colocación oculta. También puede acceder al mismo selector a través de More tools en el mismo menú + bajo el grupo LTI Tools.

Original Course View

Original Course View sigue siendo compatible en Learn SaaS y sigue siendo la experiencia principal para sitios Learn 9.1 autoalojados en la línea de lanzamientos CU de Q4 2024.

1. Abra el curso y entre en un Content Area (por ejemplo, el área predeterminada Information o Content en el menú del curso).
2. Active Edit Mode con el interruptor en la esquina superior derecha de la página.
3. Haga clic en Build Content en la barra de acciones.
4. Bajo el submenú Learning Tools, haga clic en FastComments. El submenú Learning Tools se llena a partir de las colocaciones de herramientas LTI 1.3 después de que un administrador registre la herramienta. Si no lo ve, consulte la sección de advertencias más abajo.
5. En el formulario Create FastComments, establezca:
   • Name: la etiqueta que los estudiantes ven en el área de contenido.
   • Description: texto opcional que se muestra encima del hilo incrustado.
   • Permit Users to View this Content: conmutador de disponibilidad Sí/No.
   • Track Number of Views: habilite si desea las estadísticas de vistas por elemento de Blackboard. FastComments ejecuta sus propias analíticas de forma independiente.
   • Date and Time Restrictions: ventanas opcionales de Display After / Display Until.
6. Envíe. La herramienta aparece como un elemento clicable en el área de contenido.

Embedding Inside an Item or Document

En ambas vistas de curso, los instructores incrustan FastComments en línea dentro del cuerpo de un Item, Document, o cualquier campo de texto enriquecido mediante el botón LTI Advantage del Editor de Contenido.

Ultra Course View:

1. Cree o edite un Document.
2. Haga clic en Add content dentro del cuerpo del documento donde desea que aparezca el hilo.
3. En la barra de herramientas del editor, abra el menú Insert content y haga clic en Content Market (el punto de entrada LTI Advantage / Deep Linking).
4. Elija FastComments. FastComments devuelve una carga útil de deep-link y Blackboard inserta un bloque incrustado en el cuerpo del documento en la posición del cursor.
5. Guarde el documento. Los estudiantes ven el hilo renderizado en línea a medida que se desplazan.

Original Course View:

1. Edite cualquier elemento con un cuerpo de texto enriquecido.
2. En la barra de herramientas del Content Editor, haga clic en el icono más Add Content y elija Content Market (etiquetado como Add Content from External Tool en CUs antiguas de Q4 2024).
3. Elija FastComments. El editor inserta un bloque marcador de posición que referencia el recurso deep-linked.
4. Envíe el elemento.

Cada incrustación de deep-link produce su propio hilo de FastComments, por lo que un Item con dos bloques FastComments incrustados tendrá dos flujos de comentarios independientes.

Visibility, Release Conditions, and Group Restrictions

Los elementos de contenido de FastComments se comportan como cualquier otro elemento de contenido de Blackboard respecto a las reglas de control de acceso aplicadas sobre ellos.

• Ultra: haga clic en el selector de visibilidad en la fila (Visible to students, Hidden from students, Conditional availability). La disponibilidad condicional admite ventanas de fecha/hora, reglas de rendimiento contra elementos del libro de calificaciones y reglas de miembros contra grupos del curso.
• Original: abra el menú contextual del elemento y elija Adaptive Release o Adaptive Release: Advanced para restringir la herramienta por fecha, membresía, calificación o estado de revisión. Use Set Group Availability en el elemento para restringirlo a grupos específicos del curso.

FastComments respeta lo que decida la restricción de Blackboard. Si Blackboard oculta el elemento a un estudiante, el lanzamiento LTI nunca ocurre para ese estudiante y no aparece en la vista de moderador.

Gradebook Behavior

FastComments no informa calificaciones de vuelta mediante LTI Advantage Assignment and Grade Services. No se crea automáticamente una columna de calificaciones para los elementos de contenido de FastComments.

Si su tenant de Blackboard está configurado para crear automáticamente una columna del libro de calificaciones para cada nuevo elemento de contenido independientemente de los metadatos de evaluación, igualmente aparece una columna vacía. Para ocultarla:

• Ultra: abra el Gradebook, haga clic en el encabezado de la columna, elija Edit, y desactive Show to students además de Include in calculations. O use Delete si su institución permite la eliminación de columnas para ítems sin calificación.
• Original: abra el Grade Center, haga clic en la flecha de la columna, elija Hide from Users (on/off), y opcionalmente Hide from Instructor View bajo Column Organization.

What Students See

Cuando un estudiante abre el elemento FastComments o se desplaza hasta un bloque incrustado:

1. Blackboard lanza el mensaje LTI 1.3 a FastComments. El estudiante inicia sesión mediante SSO usando su identidad de Blackboard (nombre, correo electrónico, avatar, rol) sin ver un formulario de inicio de sesión.
2. El hilo de comentarios se renderiza en el iframe. El encadenamiento, las respuestas, las menciones y las reacciones están todas disponibles según la configuración del widget de comentarios configurada en FastComments.
3. Sus comentarios se atribuyen a su cuenta de Blackboard. Si el estudiante edita su nombre o foto en Blackboard más adelante, el siguiente lanzamiento actualiza el perfil de FastComments.

Mapeo de roles de Blackboard a FastComments:

• System Administrator y Course Builder se mapean a FastComments admin.
• Instructor y Teaching Assistant se mapean a FastComments moderator.
• Student, Guest, y Observer se mapean a FastComments commenter.

Los moderadores ven controles de moderación (fijar, ocultar, prohibir, eliminar) en línea en cada comentario del hilo.

Thread Scoping

FastComments delimita cada hilo por (Blackboard host, course ID, resource link ID). Dos elementos FastComments en el mismo curso generan dos hilos. El mismo elemento copiado en dos plantillas de curso (por ejemplo, mediante copia de curso) genera dos hilos, porque Blackboard emite un nuevo resource link ID durante la copia. Para mantener un hilo compartido entre copias de curso, use Deep Linking con un URN de hilo explícito configurado en FastComments antes de lanzar la copia.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). El administrador aprobó la herramienta pero dejó una política de la institución que bloquea la colocación relevante. Vaya a Administrator Panel > Integrations > LTI Tool Providers, edite la entrada de FastComments y confirme que las colocaciones Course Content Tool (Original) y Course Content Tool - allow students / Deep Linking content tool (Ultra) están habilitadas. Guarde y actualice la página del curso.

"Tool not configured for this context" or "Tool is not deployed" error on launch. El ámbito de despliegue registrado durante el registro dinámico no coincide con el contexto de la institución al que pertenece el curso. En la entrada del proveedor de herramientas de Blackboard, verifique que el Deployment ID coincida con lo que FastComments muestra en su página de Configuración LTI 1.3 para este tenant. Si difieren, elimine la colocación y vuelva a ejecutar el registro dinámico desde una URL de registro nueva (consíguelo aquí).

Iframe height looks fixed or content gets cut off. Algunos tenants de Blackboard incluyen una Política de Seguridad de Contenido estricta que bloquea el postMessage de redimensionamiento de iframe LTI predeterminado. FastComments emite tanto el mensaje estilo Canvas lti.frameResize como el mensaje según la especificación IMS org.imsglobal.lti.frameResize para maximizar la compatibilidad, pero una anulación de CSP a nivel de tenant bloquea el listener del padre. Pida a su administrador que confirme que *.fastcomments.com está en la lista blanca de herramientas LTI y que ningún encabezado CSP personalizado está eliminando eventos postMessage. El redimensionamiento entonces funciona sin más configuración.

Course copy duplicates threads. La copia de cursos de Blackboard emite nuevos resource link IDs para las colocaciones LTI, por lo que los cursos copiados comienzan con hilos vacíos. Esto es esperado. Si necesita que el curso copiado herede el hilo original, configure Deep Linking con un URN de hilo explícito antes de copiar, o contacte al soporte de FastComments para remapear IDs de hilos en lote.

Student sees a generic Blackboard error on launch. La causa es una claim email faltante o desactualizada. Confirme que la política de la institución para FastComments tiene habilitados Role, Name, y Email Address bajo User Fields to Send. Guarde y luego inicie de nuevo en una sesión de navegador nueva.

"Token de registro no encontrado, caducado o ya usado"

El token en tu URL de registro (consíguelo aquí) es válido durante 30 minutos y solo puede usarse una vez. Si tu LMS tardó más que eso, o si el registro se reintentó después de haberse completado, el token será rechazado. Genera una URL nueva en la página de Configuración LTI 1.3 de FastComments y empieza de nuevo.

"La plataforma rechazó el registro"

Tu LMS rechazó el apretón de manos de registro. Las causas más comunes:

• La herramienta ya está registrada con el mismo nombre de cliente. Algunas plataformas (en particular D2L) rechazan un segundo registro de "FastComments" hasta que se elimine el anterior. Elimina la herramienta antigua en tu LMS y vuelve a intentarlo.
• Campo incorrecto en el LMS. Asegúrate de pegar la URL en el campo registration / tool initiation registration endpoint, no en el campo launch URL ni en el campo login URL.
• El LMS en realidad no soporta el Registro Dinámico. Versiones antiguas de Moodle y Blackboard anuncian LTI 1.3 pero solo permiten la configuración manual. Revisa la documentación de tu plataforma.

"No se pudo obtener la configuración de la plataforma"

FastComments no pudo leer el documento openid-configuration de tu LMS. Esto es raro y suele significar que el LMS proporcionó una URL de descubrimiento malformada o inaccesible. Contacta con el soporte de tu LMS.

El lanzamiento muestra "Configuración no encontrada"

O bien la configuración en FastComments fue eliminada, o el lanzamiento provino de un par iss/client_id que no reconocemos. Si eliminaste y volviste a registrar, indica a tu LMS que elimine y vuelva a añadir la herramienta FastComments para que obtenga el nuevo client_id.

El lanzamiento muestra "Despliegue no registrado"

Iniciaste FastComments desde un despliegue de Brightspace/Moodle/Blackboard diferente del que se usó en el primer lanzamiento. FastComments fija el deployment_id en el primer lanzamiento como verificación de seguridad. Para añadir un nuevo despliegue bajo el mismo cliente, contacta con el soporte - añadiremos el ID de despliegue a la configuración.

El lanzamiento muestra "message_type no compatible"

El LMS envió un mensaje LTI que FastComments no maneja (por ejemplo LtiSubmissionReviewRequest). FastComments solo soporta los flujos estándar de resource-link launch y deep-linking. Contacta si necesitas que se añada un tipo de mensaje específico.

El iframe no se redimensiona

La mayoría de los LMS ajustan automáticamente el tamaño de los iframes LTI. Si el tuyo no lo hace, verifica que la configuración de lanzamiento del LMS permita que la herramienta envíe eventos postMessage al frame padre. FastComments emite mensajes de redimensionamiento tanto de estilo Canvas (lti.frameResize) como según la especificación IMS (org.imsglobal.lti.frameResize).