SDKs
Space Meetings Migration
This documentation describes the upcoming changes in meetings workflow functionality for the mobile and web SDKs. It also includes links to detailed migration documentation.
anchorTerminology
anchorThis table defines the terminology we'll be referencing in this article:
| Term | Description |
|---|---|
| USM Meeting | Unified Space Meetings a.k.a. Improved Meetings associated with a Space are a subset of meetings happening on the advanced Webex Suite Meetings platform. These meetings use the new suite backend and happen in spaces. |
| Create a meeting | When a meeting is generated using the /meetings public API. |
| Start a meeting | When a meeting link is used to start a meeting as the first participant. |
| Join a meeting | When a meeting link is used to join an on-going meeting as a subsequent participant. |
| Space meeting | When a meeting is created using /meetings with roomId = <base64Id of room> and adhoc = false. |
| Instant meeting | When a meeting is created using /meetings with roomId = <base64Id of room> and adhoc = true. |
| Scheduled meeting | When a meeting is created using /meetings with roomId = <empty> and adhoc = false. |
anchorRequired SDK Versions
anchorPlease make a note of the required SDK versions and their dates of release.
Minimum Web SDK Version: 2.60.0. Contains the new API reclaimHost().
Minimum Mobile SDK Version: 3.11.0. Contains the new APIs reclaimHost(), makeHost(), and inviteParticipant().
Creating instant meetings using the SDKs will be unavailable from version 3.11.0 for mobile SDKs and 2.60.0 for the web SDK. Going forward you'll need to use the public APIs.
anchorDocumentation
anchorWe've provided the following detailed guides to help you with your migration:
If you have further questions, please contact us via the Webex Developer Portal Support Page.
anchorWorkflow Changes
anchorThe following table details the changes in meetings workflow functionality.
Legend
● = API Change
○ = No API Change
■ = Experience Change
□ = No Experience Change
| Available API Function | API Caller is from the space-owning org | API Caller is from an external org | API Caller is from the free consumer org | Notes |
|---|---|---|---|---|
| Create a meeting using Public APIs ● ■ | Space ✓ Instant ✓ Scheduled ✓ | Space Х Instant Х Scheduled ✓ | Space X Instant X Scheduled ✓ | Before: Meeting link is static and retrieved using roomId.After: Meeting link is dynamic. A developer needs to call the public API to create a meeting link. |
Start a meeting without waiting in the lobby whenenabledJoinBeforeHost = false (SDK)● ■ | Space ✓ Instant ✓ Scheduled ✓ | Space Х Instant ✓ Scheduled X NOTE: In the Webex app, a space meeting also requires the invitee list to be populated. Not everyone becomes a co-host. Non-invitees will be in the lobby. | Space Х Instant ✓ Scheduled X | Before: Participant can start meetings using the roomId.After: Participant requires the meeting link, meeting number, or SIP URI to start the meeting. Space: A consumer org or external org participant who is NOT a member of the space has to be admitted by host even if a password is used to join meeting. Instant: Anyone can join an instant meeting before the host without waiting in lobby. Scheduled: A consumer org or external org participant does NOT have to be admitted by the host when a password is used to join the meeting. |
Start a meeting without waiting in the lobby when enabledJoinBeforeHost =true (SDK)● ■ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Before: Participant can start the meeting using roomId.After: Participant requires the meeting link, meeting number, or SIP URI to start the meeting. |
| Join after a meeting starts (SDK) ● ■ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Before: Participant can start the meeting using roomId.After: Participant requires the meeting link, meeting number, or SIP URI to start the meeting. |
| Use the host PIN to become the meeting host ○ □ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | 1. A host PIN or password is required only for participants who are NOT on the invitee list or NOT a member of the space. 2. When a participant joins using a meeting number or SIP address they are prompted to enter the host PIN or meeting password. Participants can enter the host PIN and join the meeting as a host. 3. When a participant joins using a meeting link they will NOT be prompted to enter a PIN or password. Participants can join meetings but will not be hosts. (Participant can become hosts mid-meeting by using the reclaim host API to enter the host PIN and they can be made hosts by an existing host by calling the make host API. |
| Join a meeting after entering a password or captcha ● ■ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Before: Participant can start the meeting using roomId.After: Participant requires the meeting number, or SIP URI to start the meeting. 5 wrong password entries require solving a captcha. 1. A password is required only for participants who are NOT a part of the invitee list or NOT a member of the space. 2. When a participant joins using meeting number or a SIP address, they will be prompted to enter host PIN or meeting password. Participants can enter the password and join the meeting as a regular participant. |
| Invite additional participants mid-meeting ● □ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Only the host or co-host can invite additional participants to the meeting. |
| Initialize the Webex Assistant mid-meeting ○ ■ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Space ✓ Instant ✓ Scheduled ✓ | Before: Space meetings do not have advanced meeting capabilities via Webex Assistant such as starting transcriptions, captions, languages, etc. After: Space meetings have the same capabilities as regular Webex meetings when the Webex Assistant is enabled. 1. Only meetings created by a licensed user can enable the Webex Assistant features. 2. Any participant with the host role can start the Webex Assistant. |