1. Students unable to log in

Issue: Students are unable to log in to the Dialogic app.

Solutions:

  • Ensure that students are using the correct web app URL.
  • Double-check the password provided by the teacher.
  • If login attempts exceed 100 failed attempts, or if daily interactions are exceeded, the app will set itself to “Inactive.” Teachers should reactivate the app in the “Settings” sheet.
  • Teachers must accept the license in the “About” tab for the app to work

2. API key not working

Issue: The Dialogic app is not responding, indicating issues with the API key.

Solutions:

  • Verify that the API key is correctly entered in the “Settings” sheet.
  • Verify that the model selected in the “Settings” sheet is correct
  • Check the API key’s validity and ensure it has not expired.
  • Ensure you have sufficient token credits if using OpenAI.
  • Check the status of the service (OpenAI, Llama, Google Gemini) for any outages.

3. Exceeded maximum daily interactions

Issue: The app has reached the maximum daily interactions limit.

Solutions:

  • Teachers can increase the maximum daily interactions limit in the “Settings” sheet.
  • Consider setting a reasonable limit based on class size and expected usage.

4. Scenario not loading

Issue: The chosen scenario does not load or display correctly.

Solutions:

  • Verify that the Scenario ID is correctly entered (IDs are case sensitive!)
  • Ensure the scenario is set to “Active” in the “Scenarios” sheet.

5. Interlocutor responses are off-topic

Issue: The AI interlocutor is providing irrelevant or off-topic responses.

Solutions:

  • Review the various parameters, especially “Interlocutor Role” and “Special Instructions”, to ensure they are clear and concise.
  • Adjust the “Scenario” and “Opening Message” to better guide the conversation.
  • Test the scenario with different inputs to see if the issue persists and make necessary adjustments.
  • Try using a different large language model

6. Issues with email sharing

Issue: Students are unable to share their conversations via email.

Solutions:

  • Ensure that the teacher’s email address is correctly entered in the “Settings” sheet.
  • Confirm that students are following the correct steps to share the chat (clicking the email button).
  • Check spam or junk folders if the email is not received.

7. Google Drive permissions issues

Issue: Errors related to Google Drive permissions when deploying or accessing the app.

Solutions:

  • Ensure that the Google Account used has appropriate permissions for Google Drive and Apps Script.
  • Follow the deployment steps carefully, ensuring all permissions are granted.
  • If issues persist, try re-deploying the app and reauthorizing access.

8. Getting a “Page not found” error message when trying to load the web app

Issue: This is a rare bug that usually occurs when testing the app from different Google accounts within the same browser (Chrome). This is a Google issue, not a Dialogic one, but there are a couple easy workarounds.

Solutions:

  • Open Dialogic in an “Icognito” tab
  • Try opening Dialogic from a different Google account in Chrome (if available)
  • Open Dialogic from a different browser (Firefox, Safari etc)