API : Flexcare : Videochat : Get room

Introduction

This endpoint gets a room based on id of the room, devices where FlexCare Confernece app is installed and setting from the meeting

Request

URL	https://api.telecomx.dk/flexcare/videochat/meetings/ROOM_ID
Method	GET
Access level	RESELLER, ADMIN
Params	ROOM_ID	Unique id of the room to retrieve

Query example

https://api.telecomx,dk/flexcare/videochat/meetings/12345678901234567890ABCD

Response

JSON object
_id	ObjecId	Unique id of the Conference
customer	ObjectId	Unique id of the customer
employee	ObjectId	Unique id of the employee who created conference in telecomx platform
uri	String	Uri to identify meeting, created by Medcom
pin	String	Pin to access conference, created by Medcom
desktopLink	String	Link for desktop devices, created by Medcom
clinicalLink	String	Link for clinic devices, created by Medcom
mobileLink	String	Link for mobile devices, created by Medcom
state	String	State of conference: CREATED, STARTED, CLOSED
created	Date(ISO)	Date of when conference is created
devices	Array	List of IptvDevices added to thie conference
devices[]._id	ObjectId	Unique id of the device
devices[].technicalRoomNumber	String	Room number, location
devices[].serial	String	Serial number of the device
devices[].name	String	Name of device
devices[].deviceId	String	Id generated by the device
settings	Object	Current readonly data about the device.
devices[].settings.medcomUri	String	Url wich telecomx platform can communicate with medcom platform
devices[].settings.cameraOn	Boolean	If camera is set to on or off at the start of each meeting
devices[].settings.microphoneOn	Boolean	If micrphone is set to on or off at the start of each meeting
devices[].settings.setVolume	Boolean	If tablet should set volume niveu before each meeting
devices[].settings.addParticipant	Boolean	Adds a option to add participants to meeting by email or sms, this is done trough Medcom platform
devices[].settings.volume	Number	Sets the tablet volume before each meeting
devices[].settings.quality	String	Sets the meeting quality to: LOW, MEDIUM, HIGH, VERY_HIGH
commands	Array	List of commands send to device during a meeting
devices[].commands[]._id	ObjectId	Name of product
devices[].commands[].type	String	Type of command: START_MEETING, START_MEETING, CAMERA_ON, MICROPHONE_ON, SET_QUALITY, SET_VOLUME, HANGUP,
devices[].commands[].volume	Number	Sets the volume niveu
devices[].commands[].value	Boolean	If type is either MICROPHON_ON or CAMERA_ON, it turns on or off the camera or microphone based on the value
devices[].commands[].quality	String	Sets the meeting quality to: LOW, MEDIUM, HIGH, VERY_HIGH
devices[].commands[].fetched	Boolean	Indicates if android device has fetched the command
devices[].commands[].executed	Boolean	Indicates if android device has executed the command

Example

{
   meeting: {
     _id: ObjectId('1234567890123457890CCCC'),
     subject: 'Årlig sundheds check',
     description: 'Gennemgang af patient forløb',
     startTime: '2025-11-04T10:40:23.223+00:00',
     endTime: '2025-11-04T11:40:23.223+00:00',
     externalId: '88f73951-70a6-47f6-be21-d0be415db9e0',
     uuid: 'c6c5365a-2b3c-44ec-82d6-69cdaef8fbbc',
     customer: ObjectId('1234567890123457890CCCC'),
     uri: 'test@rooms.dk',
     pin: '1234',
     desktopLink: 'https://s.test.dias.rm.dk/QcT',
     clinicalLink: 'https://rooms.dk/webapp/?conference=test@rooms.dk&pin=1234&name=Patient',
     mobileLink: 'https://s.test.dias.rm.dk/YuP',
     state: 'CREATED',
     created: ISODate('2016-01-01T00:00:00.000Z'),
     startTimeMedcom: '2025-11-04T10:40:23 +00:00',
     endTimeMedcom: '2025-11-04T11:40:23 +00:00',
     guestDesktopLink: 'https://portal.vconf.dk/?url=test@rooms.dkk&pin=1234',
     hostDesktopLink; 'https://portal.vconf.dk/?url=test@rooms.dk&pin=1234',
     clinicalLink: '',
     mobilLink: 'https://m.vconf.dk/bb4418ce6323',
     participants: [
        {
            type: 'SMS',
            value: '+4545454545',
            reference: '1234567890123457890CCCC',
            smsStatus: 'Delivered'
        }
     ],
     devices: [
        {
            _id: ObjectId('1234567890123457890CCCC'),
            serial: 'FLXCA1700937',
            name: 'Test',
            deviceId: '1700937',
            settings: {
                 medcomUri: 'https://rooms.dk',
                 cameraOn: false,
                 microphoneOn: true,
                 setVolume: true,
                 addParticipant: false,
                 volume: 80,
                 quality: 'HIGH'
            }
        }
     ] 
   },
   devices: [
      {
         _id: ObjectId('1234567890123457890CCCC'),
         serial: 'FLXCA1700937',
         name: 'Test',
         deviceId: '1700937',
         settings: {
              medcomUri: 'https://rooms.dk',
              cameraOn: false,
              microphoneOn: true,
              setVolume: true,
              addParticipant: false,
              volume: 80,
              quality: 'HIGH'
         }
      }
   ],
   setting: {
      _id: ObjectId('1234567890123457890CCCC'),
      name: 'Standard møde',
      customer: ObjectId('1234567890123457890CCCC'),
      defaultSetting: true,
      subject: 'Årlig sundheds check',
      description: 'Gennemgang af patient forløb',
      organizedByEmail: 'system@flexcare.dk',
      maxParticipants: 5,
      endMeetingOnTime: false,
      meetingType: 'POOL',
      duration: 60,
      guestMicrophone: true,
      guestPinRequired: true,
      projectCode: 'Årlig check',
      enableOverlayText: true,
      tabletSetting: {
          medcomUri: 'https://rooms.vconf.dk',
          camerOn: true,
          microPhoneOn: true,
          setVolume: true,
          addParticipants: false,
          volume: 80,
          quality: 'HIGH'
       },
       sendSMS: true,
       sms: ObjectId('1234567890123457890CCCC'),
       schedulingTemplateId: 5
   }
}

Errors

Error code	Message	Description
403	token	Access denied
404	customer	Room not found
422	Invalid data	Data is not valid in query
500	internal_error	<Unspecified>

WIKI

Table of Contents

API : Flexcare : Videochat : Get room

Introduction

Request

Query example

Response

Example

Errors