For Developers

Troubleshooting Issues

You can find solutions to common Microsoft Teams integration issues below.

Invalid or Missing Data

  • Cause: Data is incomplete or missing from the Microsoft Education tenant.
  • Resolution:
    • Verify that all required fields, such as school names, user roles, and class identifiers, are populated in Microsoft Education.
    • Ensure that Microsoft Education APIs are enabled and accessible.

Permissions Errors

  • Cause: The integration does not have sufficient permissions to access required data.
  • Resolution:
    • Check that Edlink has been granted the necessary permissions in the Microsoft tenant.
    • Consult the Microsoft API documentation to ensure proper configuration of roles and access scopes.

Failed Authentication or SSO Issues

  • Cause: Misconfigured OAuth2 credentials or incorrect tenant ID during setup.
  • Resolution: Verify that OAuth2 credentials and tenant IDs are correctly configured in the Edlink dashboard. Ensure scopes are sufficient to grant access to required endpoints. Contact support if you need help re-configuring the OAuth2 credentials.

Partial Data Syncs

  • Cause: Users or classes missing required metadata (e.g., class codes, display names) in Microsoft Teams.
  • Resolution: Confirm that metadata for users and classes is complete in Microsoft Teams. Fields like classCode and displayName must be populated.

Resource Errors in Assignments

  • Cause: Unsupported file types or missing attachments in assignment resources.
  • Resolution: Verify that resources attached to assignments are in supported formats (e.g., PDFs, DOCX) and accessible via public or tenant-specific links.

Limited Access with Non-Education Licenses

  • Note: Without Office 365 Education licenses, only basic identity information (names, email addresses, and roles) will be synchronized. Full roster and course data requires Education licenses.

For other issues or specific implementation questions, please reach out to Edlink support.