Jitsi

The Jitsi integration links VoxaLink to your own Jitsi Meet server, so a user can start a video conference from the portal without leaving it. This is a video-conferencing connector, not a contact-lookup one — it doesn't match numbers or pop records. Instead, it gives the portal a way to spin up a Jitsi room and invite someone into it.

It authenticates with JWT (JSON Web Token), so your Jitsi/Prosody server needs to be set up for token authentication with an app ID and secret that match what you enter here.

Before you connect

• A self-hosted Jitsi Meet server you control, reachable at a URL such as https://meet.example.com.
• The Jitsi/Prosody server configured for token (JWT) authentication, with an app ID and secret that match the values you'll enter in VoxaLink.

Connect Jitsi in VoxaLink

1. Open Admin → CRM Integrations and find Jitsi under Video Conferencing.
2. Click Configure. In the dialog:
   • Apply to — All accounts (tenant-wide), or a single permission group to pilot it with one team first.
   • Jitsi Server URL — your server's address, e.g. https://meet.example.com.
   • JWT App ID — the app ID configured on your Jitsi server.
   • JWT App Secret — the matching secret for that app ID.
   • Max Conference Duration — how long a room may run, from 1 to 24 hours.
3. Click Save.

Starting a video conference

• In the portal, right-click an extension in the contacts/BLF panel and choose Video Conference (Jitsi).
• A room opens and the person who started it joins as moderator via a signed JWT link; the invited party gets a guest link.
• Each room is named with a random suffix, and it closes automatically once the last person leaves.

Troubleshooting

• The room won't open or rejects the link — check the JWT App ID and JWT App Secret in Configure exactly match the app ID and secret on your Jitsi/Prosody server, and that the server is set up for token authentication.
• Wrong or unreachable server — confirm the Jitsi Server URL is correct and the server is reachable.
• Rooms time out sooner or later than expected — review the Max Conference Duration setting (1–24 hours).