Jitsi as a Service is a cloud video meeting service powered by the Jitsi platform and hosted by 8x8 company. With the Jitsi as a Service (JaaS) integration, you can quickly enable a video conferencing feature for your Ringotel users.
| Info |
|---|
Right now, 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: https://jaas.8x8.vc.
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.
| Info |
|---|
Please 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 a 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. 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.
| Info |
|---|
Note: Logged in users will need to logout and log in 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.
| Info |
|---|
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:
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.
| Info |
|---|
Note: a user must be a group admin to be able to see a 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:
| Note |
|---|
Important: When using the fist 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 the inviting external participants. For more information please refer to the official documentation: https://jitsi.github.io/handbook/docs/intro/ or https://developer.8x8.com/jaas/docs/jaas-onboarding |
Copy the invitation link from the Jitsi video meeting webpage:
Please noteNote, if you are using the JaaS integration, to use the invitation link, you firstly need to enable “Allow meeting participants to join unauthenticated“ option in your JaaS portal:
