Skip to main content
Version: 13.x (Current)

Teleconsultation Service Backend

The Teleconsultation Service Backend is a Mia-Platform plugin that acts as a BFF (Backend For Frontend) for the Teleconsultation Service Frontend. The Teleconsultation Service Frontend handles and visualizes the teleconsultation UI and all its relative tools for the call using iframe.

The teleconsultation service uses the SaaS Kaleyra Service which allows you to create a video call between two or more people, providing also different tools (like chat, whiteboard, screen sharing, file upload ecc.). It provides also supports image background management and language management (only it and en are supported at the moment).

The Teleconsultation Service Backend allows you to handle all the necessary operations (create, update, delete), on the teleconsultations. The Back End uses the RESTful APIs provided by Kaleyra.


In order to use this service, you need first to contact Kaleyra to create a Company, for your product and get the BANDYER_API_SECRET_KEY (for the Teleconsultation Service Backend).

Concepts you should be familiar with

Before continue reading the documentation, it's important to understand some basic concepts about Kaleyra.


A Company is an account created by Kaleyra. In order to use Kaleyra's services, Kaleyra has to provide you the BANDYER_API_SECRET_KEY (to communicate with their RESTful APIs).


A company has several customizable parameters, like theme, languages, virtual background, etc.

For additional information about company customization, please check the REST API.


At the moment, only the italian and the english language are fully supported by Kaleyra.


To access their services, a user must be registered on Kaleyra. There are two types of users:

  • Plus User - the one who can organize and participate to a call
  • Basic User - the one who participates to a call

In order to start a call, a plus user at least is required as participant in the call.

For additional information about users, check the REST API.


The virtual place where a call is hosted, is called a Room. There's the possibility to specify a max duration for a Room in seconds (max time allowed 24h).

For additional information about rooms, check this link.

Teleconsultation Service Backend APIs

The Teleconsultation Service Backend service exposes the APIs listed in the following table.

EndpointMinimum version requiredDescription
POST /teleconsultation1.0.0Create a new teleconsultation.
PATCH /teleconsultation/:teleconsultationId1.0.0Complete or partial update a teleconsultation (participants, start_date, end_date).
POST /teleconsultation/:teleconsultationId/participants/data1.2.0Add a new participant to the teleconsultation.
DELETE /teleconsultation/:teleconsultationId1.0.0Delete a teleconsultation.
GET /teleconsultation/:teleconsultationId1.0.0Return all data required to instantiate a teleconsultation UI and start the call.
DELETE /teleconsultation/:teleconsultationId/uploads1.5.0Delete all files uploaded by the participants during a teleconsultation.
POST /credentials1.4.0Return a valid accessToken for clients using SDK authentication.
POST /settings/background-image1.6.0
PATCH /settings/update1.6.0