Creating preconfigured links to launch conferences via Connect apps

You can construct URLs or hyperlinks that may be used to automatically launch the Connect app and take the user directly into a specific conference. If required it can also pass in any necessary information such as the caller's name or the PIN needed to enter the meeting.

The URLs are in two formats: one that can be used to launch the web app, and one for use with the desktop and mobile clients.

You can also create a URL that can be converted into a QR code that Pexip Connect for RealWear users can scan to join a meeting. For more information see Using Pexip Connect for RealWear.

Security considerations

Although embedding information such as participant names and conference PINs into the URL can make it easier for participants to join conferences, note that these parameters are included in the URL in human-readable format. This means that if a user shares the URL — such as in a screen shot of their meeting invitation — and the URL includes the PIN, anyone with access to the URL can deduce the PIN and enter (and control, if it is a Host PIN) the meeting.

As of version 25 of Pexip Infinity, when a user follows a link to join a conference via the Connect web app, any join parameters, such as a conference PIN, are automatically removed from the URL that is displayed in the browser's address bar.

Links to the web app

Links to the home screen

To open an instance of the Connect web app in the user's default browser and take them to the home screen (not into a specific conference), use the following link:

https://<address>/webapp

where <address> is the IP address or domain name of the Conferencing Node (or reverse proxy if, for example, it is being used to host a customized version of the web app).

Links to a specific meeting

To provide users with a URL that, when clicked, takes them straight into a specific conference, construct a URL in the format:

https://<address>/webapp/#/?conference=<alias>&name=<name>&pin=<PIN>&role=<role>&muteMicrophone=<muteMicrophone>&muteCamera=<muteCamera>&callType=<callType>&extension=<extension>&bandwidth=<bandwidth>&join=<join>&lng=<lng>

where:

<address> is the IP address or domain name of the Conferencing Node (or reverse proxy if, for example, it is being used to host a customized version of the web app).
<alias> is one of the aliases for the conference or service the user will join.
<name> is the name of the user who is joining the conference.
<PIN> is either the Host PIN or Guest PIN, if required (note the Security considerations if these are included).
<role>

For Pexip Connect for Web ("Webapp3") participants, if role=guest is included in the URL, they will be offered an alternative join flow that takes them through the setup of their camera, microphone and speakers before they are able to Join the meeting. For more information, see Support for first-time and infrequent users.

For previous ("Webapp2" and "Webapp1") participants, use role=guest if you want to allow Guests to automatically join a conference that allows Guests but has no Guest PIN. In all other cases, participants are asked to enter a PIN to join the conference (unless there is no Host PIN, or the URL already specifies a <PIN>); the PIN determines the participant's role and the <role> is ignored. Note that if role=host, participants are still prompted to enter the Host PIN to join the conference; this parameter cannot be used to bypass PIN entry requirements.

<muteMicrophone> is true to join without sending audio (the user will still receive audio, and send and receive video).
<muteCamera> is true to join without sending video (the user will still receive video, and send and receive audio).
<callType>

(Not supported in Webapp3 "Pexip Connect for Web")

is one of:

  • none to join as a presentation and control-only participant, i.e. the user will not send or receive any audio or video. They can still access the conference controls and send and receive presentations.
  • audioonly to join as an audio-only participant, i.e. the user will send and receive audio but will not send or receive video.
  • video (the default) to join as a full (send and receive) audio and video participant.
<extension> is the Virtual Reception extension, or the Microsoft Skype for Business / Lync Conference ID.
<bandwidth> is the maximum bandwidth for the call, and the bandwidth at which the initial call attempt will be made, in kbps. It can be any number between 256 and 6144.

<join>

(Not supported in Webapp2 "previous web app")

is 1 if you want the participant to automatically join the conference, bypassing the option to check their devices.

<lng>

(Not supported in Webapp2 "previous web app")

is the code for one of the supported languages, in order to display Pexip Connect for Web in that language. Note that this will override any of the user's own browser language settings.

The URL should always include the alias parameter. The remainder of the parameters are optional. If a parameter is not specified in the URL but is required when joining (i.e. name, and PIN if the conference uses PINs, or extension if one is requested), the participant will have to provide the information themselves before they can join the conference.

This URL structure will not work on version 24 or earlier of Pexip Infinity, but any URLs using the previously recommended structure (https://<address>/webapp/conference/<alias>?<parameters>) will still work on v25 and later, and the join parameters (but not the alias) will be removed from the browser's address bar.

Examples

Assuming the domain name of your Conferencing Node is vc.pexample.com, and there is a Virtual Meeting Room with the alias meet.alice, which has no PIN:

  • the basic URL for someone to join the VMR directly would be:

    https://vc.pexample.com/webapp/#/?conference=meet.alice

  • to set the display name for a participant e.g. "Bob", the URL would be:

    https://vc.pexample.com/webapp/#/?conference=meet.alice&name=Bob

    (Note that if you shared this same link with many participants, they would all join with their display name set to "Bob".)

If we then gave the same Virtual Meeting Room a Host PIN of 1234, and allowed Guests to join without a PIN:

  • the URL for Bob to join it directly as a Host would be:

    https://vc.pexample.com/webapp/#/?conference=meet.alice&name=Bob&pin=1234

  • the URL for Bob to join it directly as a Guest would be:

    https://vc.pexample.com/webapp/#/?conference=meet.alice&name=Bob&role=guest

  • the URL for Bob to join it directly as an audio-only Guest would be:

    https://vc.pexample.com/webapp/#/?conference=meet.alice&name=Bob&role=guest&callType=audioonly

Alternative structure to join with an invitation card

(Supported in Webapp2 only)

You can use an alternative URL structure in the format:

https://<address>/webapp/home?conference=<alias>

In this case the web app will launch with an invitation to join the nominated <alias>, and it gives the user an opportunity to modify their settings (such as camera, mic and so on) before joining the conference, and they can select whether they want to join with video, voice, or content and control only.

This can be useful in scenarios where a user has previously set their camera to None, and are unable to modify their device settings if they have been taken directly into a conference.

Links to the desktop and mobile clients

You can create a URL that, when clicked, opens the Connect app on that device and provides an invitation to join the nominated conference. The same URL can be used for the desktop client and mobile clients for Android and iOS. This URL can be included in web pages, instant messages or emails (but note that some email clients such as Gmail will strip them out for security reasons).

The Connect app desktop or mobile client must already be installed on the device.

The URL is in the format:

pexip://<alias>?host=<domain>&name=<name>&pin=<PIN>&role=<role>&muteMicrophone=<muteMicrophone>&muteCamera=<muteCamera>&extension=<extension>&bandwidth=<bandwidth>

where:

<alias> is one of the aliases for the conference or service the user is invited to join.
<domain> is the IP address or domain name of the Conferencing Node (or reverse proxy if, for example, it is being used to host a customized version of the web app) the client should connect to in order to place the call. Note that this is ignored if the client is registered and Route calls via registrar is enabled.
<name> is the name of the user who is joining the conference.
<PIN> is either the Host PIN or Guest PIN, if required (note the Security considerations if these are included).
<role> is guest if you want to allow Guests to join a conference without having to enter a PIN (providing the conference allows Guests and has no Guest PIN). In all other cases, participants are asked to enter a PIN to join the conference (unless there is no Host PIN, or the URL already specifies a <PIN>); the PIN determines the participant's role and the <role> is ignored. Note that if role=host, participants are still prompted to enter the Host PIN to join the conference; this parameter cannot be used to bypass PIN entry requirements.
<muteMicrophone> is true to join without sending audio (the user will still receive audio, and send and receive video).
<muteCamera> is true to join without sending video (the user will still receive video, and send and receive audio).
<extension> is the Virtual Reception extension, or the Microsoft Skype for Business / Lync Conference ID.
<bandwidth> is the maximum bandwidth for the call, and the bandwidth at which the initial call attempt will be made, in kbps. It can be any number between 256 and 6144.

The URL must always include pexip://<alias>. The remainder of the parameters are optional. If a parameter is not specified in the URL but is required when joining (i.e. name, and PIN if the conference uses PINs, or extension if one is requested), the participant will have to provide the information themselves before they can join the conference.

Example - email footer

For example, Alice's personal meeting room has the alias meet.alice@pexample.com so she includes the following text in her email footer:

  • Video: <a href="pexip://meet.alice@pexample.com">meet.alice@pexample.com</a>

which displays as:

  • Video: meet.alice@pexample.com

Now, when someone who has a Connect app installed on their device clicks on the link in Alice's email, their client will open automatically with an invitation to join meet.alice@pexample.com, and all they need to do is select whether they want to join with video, voice, or content and control only:

Example - Guest PIN

Alice's personal meeting room has a Guest PIN of 1234. When Alice is chatting with a colleague using an instant messaging client and she wants to move the conversation to video, she sends them the message pexip://meet.alice@pexample.com?pin=1234, which automatically appears as a hyperlink. Her colleague clicks on the link and is invited to join Alice's personal meeting room as a Guest.

Example - always join with microphone muted

If you want the participant to join a meeting with a PIN of 1234, and you want their microphone to be muted on joining, the URL would be: pexip://meet.alice@pexample.com?pin=1234&muteMicrophone=true

Links to the legacy Connect apps

For information on creating links to legacy clients, see the v17 documentation.