Jitsi as a Service is a cloud video meeting service powered by the Jitsi platform and hosted by the 8x8 company. With the Jitsi as a Service (JaaS) integration, you can quickly enable a video conferencing feature for your Ringotel users.
Note:
Currently, the integration allows you to create instant meetings between Ringotel users. The ability to schedule meetings and invite extenral users will be added soon.
Create a JaaS account
Firstly, to set up an integration, you need to create a new Jitsi as a Service account via the official website: Jitsi as a Service – World's easiest way to add meetings to your apps.
Create an API Key
An API key is required to integrate your JaaS account with a Ringotel organization. To create a new API key, you need a public key provided by Ringotel, which will be used in user authentication when connecting to the meetings.
Note:
You need to create an API key for each Ringotel organization where you want to enable the integration.
Log in to your Ringotel Shell admin portal and navigate to an organization → Integrations → Jitsi 8x8 → click Enable Integration.
Copy the provided public key by clicking the Copy button.
3. Navigate back to your JaaS portal → API keys menu → press Add API Key.
4. In the opened pop-up, press Add public API key button in the Add your own key section.
5. Paste the public key (copied earlier from your Ringotel Shell admin portal) in the designated field and (optionally) change the key name, then press Add API key.
Important:
Please ensure there is no newline character added at the end of the public key (after -----END PUBLIC KEY-----).
An API key should now be generated.
6. Note the newly created API Key ID and an App ID that will be required to enable the integration.
Create Integration
Switch back to your Ringotel Shell admin portal and enter the Key ID and App ID (copied from your JaaS portal) into the designated fields of the Jitsi 8x8 integration settings.
2. If you self-host an HTML page with Jitsi scripts, change the Base URL accordingly.
3. Optionally enable features that will be available for the moderators to use during the meetings.
4. Press Save & Continue to enable the integration.
Note:
Logged-in users will need to log out and log back into their apps to apply changes.
Using the Integration
Ringotel users for whom the integration is enabled will be able to initiate instant video meetings from the group chats created via their Ringotel app.
Note:
Only group admins can initiate video meetings. Group admins will be automatically granted moderator roles in the meetings.
Follow these steps to create an instant meeting in the Ringotel app:
1. Firstly, create a new group.
2. Press the “video camera” button to initiate a video meeting. Confirm the pop-up once prompted to continue or cancel if you don't want to continue.
Note:
User must be a group admin to be able to see the button and initiate a meeting.
3. Once the meeting is initiated, you will be automatically navigated to the meeting page, while all group participants will receive a notification and a personal link to join the meeting.
How to invite people outside of my organization?
You can invite external participants to a meeting by
Using the same link generated and provided in the group chat:
Important:
When using the first option (sharing the link provided in the group chat), the invited participants will have the same permissions as the Ringotel user for whom the link was generated. Because Jitsi is an open-source platform, you may consider implementing other ways of inviting external participants. For more information please refer to the official documentation:
2. Copy the invitation link from the Jitsi video meeting webpage:
Note, if you are using the JaaS integration, to use the invitation link, you first need to enable “Allow meeting participants to join unauthenticated“ option in your JaaS portal:
