Skip to main content
Skolengo is a modern school management platform used by educational institutions in France. Papillon provides comprehensive integration with Skolengo, including support for messaging between students, parents, and teachers.

​
Overview

The Skolengo integration uses the skolengojs library to communicate with Skolengo’s API. Like Pronote, Skolengo uses dynamic capability detection based on your account’s permissions.
Skolengo features are determined by your school’s configuration and your account type (Student or Parent).

​
Supported Features

Papillon’s Skolengo integration provides access to:

Homework

View and manage assignments with completion tracking

Grades

Access grades and evaluations by period

Timetable

View your weekly class schedule

Attendance

Monitor attendance and absence records

Messaging

Read and send messages to teachers and staff

News

Stay updated with school announcements

​
Feature Details

Manage your schoolwork effectively:
  • View homework organized by week
  • Mark assignments as complete or incomplete
  • Access assignment descriptions and details
  • Track due dates and completion status
Permission Required: READ_ASSIGNMENTSCapability: HOMEWORK
Track academic performance:
  • View grades by evaluation period
  • Access detailed grade information
  • See evaluations and teacher comments
  • Monitor progress over time
  • Support for parent accounts viewing multiple children
Permission Required: READ_EVALUATIONSCapability: GRADES
Stay organized with your schedule:
  • Weekly timetable view
  • Class information and locations
  • Teacher assignments
  • Real-time schedule updates
Permission Required: READ_LESSONSCapability: TIMETABLE
Monitor your attendance:
  • View absence records
  • Check attendance status
  • Access absence justifications
  • Track attendance patterns
Permission Required: READ_ABSENCE_FILESCapability: ATTENDANCE
Communicate with your school community:
  • Read Messages: View all messages and conversations
  • Create Messages: Start new conversations with teachers and staff
  • Reply to Messages: Respond in existing threads
  • View message recipients and participants
  • Send messages with CC and BCC support
Permissions Required: READ_MESSAGES, WRITE_MESSAGESCapabilities: CHAT_READ, CHAT_CREATE
Stay informed:
  • Read school announcements
  • View important notices
  • Access news from administration
  • Get updates about school events
Capability: NEWS (Always Available)

​
Connecting to Skolengo

Follow these steps to connect your Skolengo account:
1

Select Your School

Skolengo requires you to select your school from a list. You’ll need:
  • Your school’s EMS code
  • The authentication URLs (well-known URL and token endpoint)
These are typically auto-detected when you select your school from the list in Papillon.
2

Choose Account Type

Select whether you’re logging in as:
  • Student - For student accounts
  • Parent - For parent accounts (supports multiple children)
Your account type affects which features and data you can access.
3

Enter Credentials

Provide your Skolengo username and password.
Use the same credentials you use to access Skolengo’s website or official app.
4

Authentication

Papillon will authenticate with Skolengo’s OAuth2 system and receive:
  • An access token for API requests
  • A refresh token for maintaining your session
  • Your account permissions and capabilities
5

Permission Detection

Papillon automatically detects which features you have access to based on:
  • Your account type (Student/Parent)
  • Permissions granted by your school
  • Your Skolengo account configuration

​
Authentication Details

Skolengo uses OAuth2-based authentication: 
Authentication Requirements:
- Refresh URL (school-specific)
- Refresh Token (generated after login)
- Well-Known URL (OAuth configuration endpoint)
- Token Endpoint (for token refresh)
- EMS Code (school identifier)

​
Authentication Flow

  1. School Selection: Choose your school to get EMS code and URLs
  2. OAuth Login: Authenticate through Skolengo’s OAuth2 system
  3. Token Generation: Receive access and refresh tokens
  4. Permission Check: System checks your account permissions
  5. Capability Detection: Available features are determined
  6. Automatic Refresh: Tokens are refreshed automatically as needed
Skolengo uses industry-standard OAuth2 for authentication, providing enhanced security compared to traditional username/password systems.

​
Dynamic Capabilities

Skolengo features are enabled based on your account permissions:
Skolengo PermissionPapillon CapabilityFeature
READ_ASSIGNMENTSHOMEWORKHomework & Assignments
READ_MESSAGESCHAT_READRead Messages
WRITE_MESSAGESCHAT_CREATECreate Messages
READ_ABSENCE_FILESATTENDANCEAttendance Records
READ_LESSONSTIMETABLEClass Schedule
READ_EVALUATIONSGRADESGrades & Evaluations
Parent AccountHAVE_KIDSMultiple Children Support
If you don’t see a feature in Papillon, your Skolengo account may not have the required permissions. Contact your school to request access.

​
Parent Accounts

Skolengo parent accounts have special features:
Parent accounts can manage multiple children:
  • View each child’s information separately
  • Switch between children’s data
  • Access grades, homework, and attendance for each student
  • Receive notifications for all children
Capability: HAVE_KIDS
When viewing grades with a parent account, you must specify which child’s grades you want to see.

​
Messaging Features

Skolengo’s messaging system in Papillon supports:

​
Reading Messages

  • View all conversations and chats
  • Read message content and history
  • See message participants
  • Check message timestamps

​
Creating Messages

  • Start new conversations
  • Select recipients (teachers, staff)
  • Add subject and content
  • Send messages with CC and BCC

​
Message Structure

Message Features:
- Subject line
- Message content
- Primary recipients
- CC recipients (optional)
- BCC recipients (optional)
- Message threading
Unlike email, Skolengo messages are contained within the school platform and only reach school-approved recipients.

​
Data Synchronization

Skolengo data syncs with:
  • Manual Refresh: Pull down to refresh any screen
  • Automatic Token Refresh: OAuth tokens refreshed automatically
  • On-Demand Loading: Data fetched when you navigate to features
  • Session Persistence: Your session remains active between app launches
Skolengo tokens have longer validity periods than some platforms, reducing the need for frequent re-authentication.

​
Common Issues & Solutions

Problem: School not appearing in the selection list.Solutions:
  • Verify your school uses Skolengo
  • Ask your school administration for the EMS code
  • Check if your school recently switched platforms
  • Contact Papillon support if your school should be listed
Problem: Can’t log in with correct credentials.Solutions:
  • Verify username and password on Skolengo’s website
  • Ensure you selected the correct account type (Student/Parent)
  • Check that your Skolengo account is active
  • Try resetting your password on Skolengo’s website
  • Contact your school if account is locked
Problem: Expected features don’t appear in Papillon.Solutions:
  • Your account may not have required permissions
  • Check if features are available on Skolengo’s website
  • Student vs. Parent accounts have different permissions
  • Contact your school to request feature access
Problem: Session expired errors.Solutions:
  • Papillon should automatically refresh your token
  • Try manually refreshing the app
  • Check your internet connection
  • If issues persist, disconnect and reconnect your account
Problem: Parent can’t view different children’s data.Solutions:
  • Ensure you’re logged in with a parent account
  • The HAVE_KIDS capability should be automatically detected
  • Try refreshing your account
  • Some features require specifying which child’s data to view

​
Privacy & Security

Skolengo integration security features:
  • ✓ OAuth2-based authentication (industry standard)
  • ✓ Secure token storage on device
  • ✓ HTTPS encrypted communication
  • ✓ Automatic token refresh (no password storage)
  • ✓ Permission-based access control
  • ✓ No third-party data sharing
  • ✓ Secure session cleanup on logout
OAuth2 provides enhanced security by never storing your password. Instead, secure tokens are used for all API requests.

​
Technical Implementation

The Skolengo integration is built using:
  • Library: skolengojs - TypeScript client for Skolengo API
  • Authentication: OAuth2 with refresh token flow
  • Session Type: Skolengo session object with user permissions
  • Capability Detection: Dynamic based on account permissions
  • Multi-child Support: Kid reference system for parent accounts
Implementation reference: /services/skolengo/index.ts

​
Account Types Comparison

FeatureStudent AccountParent Account
Homework✓ Own homework✓ Child’s homework
Grades✓ Own grades✓ Child’s grades
Timetable✓ Own schedule✓ Child’s schedule
Attendance✓ Own attendance✓ Child’s attendance
Messaging✓ Send/Receive✓ Send/Receive for child
Multiple Students✗ Single student✓ Multiple children

​
Best Practices

OAuth Security

Don’t share your refresh tokens - they provide full access to your account

Regular Updates

Pull to refresh regularly for the latest information

Permission Awareness

Understand which features your account type supports

Message Etiquette

Use professional communication when messaging teachers

​
Feature Availability

Not all schools enable all Skolengo features. Here’s what might affect availability:
  • School Configuration: Your school may disable certain modules
  • Account Type: Students and parents have different permissions
  • Grade Level: Some features may be restricted by grade
  • Subscription: Your school’s Skolengo subscription level
If a feature is available on Skolengo’s website but not in Papillon, please report it as a bug on GitHub.

​
Getting Help

If you need assistance:
  1. Check the troubleshooting section
  2. Verify your credentials work on Skolengo’s official website
  3. Contact your school for account and permission issues
  4. Report bugs on Papillon’s GitHub
  5. Check Skolengo’s official documentation

​
Next Steps

Messaging Guide

Learn how to use Papillon’s messaging features

All Integrations

Explore other supported platforms

Build docs developers (and LLMs) love

Get started for freeTalk to us