How to Add Asyntai AI Chatbot to Brightspace

Step-by-step guide for D2L Brightspace

플랫폼:

1단계: 임베드 코드 가져오기

먼저 Asyntai 대시보드로 이동하여 "임베드 코드" 섹션까지 아래로 스크롤하십시오. 다음과 같은 형태의 고유 임베드 코드를 복사하십시오:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

참고: 위의 코드는 예시일 뿐입니다. 개인 위젯 ID가 포함된 고유한 임베드 코드를 대시보드에서 복사해야 합니다.

Step 2: Create a Custom Widget

In Brightspace, the chatbot is added by creating a Custom Widget that holds your embed code. This normally requires an instructor or administrator role:

Log in to Brightspace and open the course where you want the chatbot (administrators can use Admin Tools to work at the org level instead)
From the course navbar, click Course Admin (or Admin Tools for an org-level widget)
Under the Site Resources section, click Widgets
Click Create Widget
On the Properties tab, give the widget a name such as Asyntai Chatbot
Open the Content tab and click the </> (source code / HTML editor) button to switch to HTML view
Paste your Asyntai embed code into the source editor
Leave Render in iFrame unchecked so the script runs in the page context and the floating chat button can appear over the whole homepage
Click Save and Close

참고: The Widgets tool lives under Course Admin for a single course, and under Admin Tools for the whole organization. If you don't see Widgets, your role may not have permission — ask your Brightspace administrator.

Step 3: Add the Widget to a Homepage

A custom widget only appears once it is placed on an active homepage using Homepage Management:

Go to Course Admin → Homepages (or Admin Tools → Homepages for the org level)
Create a new homepage, or click an existing one to edit it. If you edit a system homepage, use Copy first so you have an editable version
In a widget panel, click Add Widgets
Find and select your Asyntai Chatbot widget, then click Add
Click Save and Close
Back on the Homepages list, set your edited homepage as the Active homepage from the Active Homepage dropdown

팁: An administrator can build this widget under Admin Tools and set it on the organization's default homepage so the chatbot appears across every course that inherits the default homepage, instead of adding it course by course.

중요: Some institutions lock down homepages, widgets, or embedded scripts. If your changes don't take effect, your Brightspace administrator may need to grant permission or add the widget for you at the org level.

4단계: 설치 확인

After activating the homepage, open the course (or your Brightspace site) in a new browser tab or incognito window. You should see the chat widget button in the bottom right corner. Click it to ensure it opens and functions correctly.

위젯이 보이지 않나요? Make sure the edited homepage is set as the Active homepage and that the widget was added to it. Confirm you left Render in iFrame unchecked. Clear your browser cache or view in incognito mode, and check the browser console (F12) for any JavaScript errors.

도움이 필요하신가요?

If you don't have permission to create widgets or edit homepages, your Brightspace administrator can add the widget to the organization's default homepage so it appears across your courses. You can also contact Asyntai support for guidance on installing the chatbot in Brightspace.