Skip to main content

Meeting Reports

The Meeting Reports module allows users to generate attendance reports. An attendance report contains a list of participants including the time they joined and left.

Joining the room

JoinSuccess

When joining a room, the join_success control event does not contain module-specific data.

Joined

When joining a room, the joined control event sent to all other participants does not contain module-specific data.

Commands

GenerateMeetingReport

Allows a moderator to generate a meeting report. The meeting report will be stored as an asset.

Fields

FieldTypeRequiredDescription
actionenumyesMust be "generate_attendance_report"
include_email_addressesboolyestrue if email addresses should be included in the report, false otherwise

Example

{
"action": "generate_attendance_report",
"include_email_addresses": false
}

Events

PdfAsset

A meeting report has been generated and stored with the asset ID and file name.

Fields

FieldTypeAlwaysDescription
messageenumyesIs "pdf_asset"
filenamestringyesFile name of the generated meeting report
asset_idAssetIdyesId of the asset inside the object storage

Example

{
"message": "pdf_asset",
"filename": "global",
"asset_id": "00000000-0000-0000-0000-000000000000"
}

Error

Received when something went wrong generating a meeting report on the server.

Fields

FieldTypeAlwaysDescription
messageenumyesIs "error"
errorenumyesExhaustive list of error strings, see table below
ErrorDescription
insufficient_permissionsThe requesting user has insufficient permissions for the operation
storage_exceededThe requesting user has exceeded their storage
generate_failedInternal error while generating the report

Example

{
"message": "error",
"error": "generate_failed"
}