Meetings
The client.join()
function is used to start and join Zoom Meetings.
On this page
Prerequisites
Here are the properties for the client.join()
function. You can get the Meeting number, password, and registrant token from the Zoom Meeting APIs.
Key | Value Description |
---|---|
sdkKey | Required, your SDK Key. |
signature | Required, your SDK JWT signature. |
meetingNumber | Required, the Zoom Meeting or Webinar Number. |
password | Required, leave as empty string if the Meeting or Webinar only requires the waiting room. |
userName | Required, the name of the user starting or joining the Meeting or Webinar. |
userEmail | Required for Webinar, optional for Meeting, required for Meeting and Webinar if registration is required. The email of the user starting or joining the Meeting or Webinar. |
tk | Required, the registrant's token if your Meeting or Webinar requires registration. |
zak | Required, the host's Zoom Access Key (ZAK) token if you are starting a Meeting or Webinar. |
For the full set of client.init()
and client.join()
properties, as well as the Web Meeting SDK APIs and event listeners, please see the Component View Reference.
Start Meeting
To start a Zoom Meeting, you must use have a role
value of 1
in your SDK Signature, and pass in the Meeting host's zak
token. This enables your Web Meeting SDK to start the Meeting.
client.join({sdkKey: sdkKey,signature: signature, // role in SDK Signature needs to be 1meetingNumber: meetingNumber,password: password,userName: userName,zak: zakToken // the host's zak token})
Join Meeting
To join a Zoom Meeting, you must use have a role
value of 0
in your SDK Signature. This enables your Web Meeting SDK to join any Meeting.
client.join({sdkKey: sdkKey,signature: signature, // role in SDK Signature needs to be 0meetingNumber: meetingNumber,password: password,userName: userName})
Join Meeting with Registration Required
Web Meeting SDK Component View v2.1.0 and above enables users to join registered meetings automatically. Your app handles the join process automatically using the registration token retrieved via the Zoom API.
This feature uses the registration token denoted by the tk
value in the query parameter in the registrant's join_url
:
"join_url": "https://example.zoom.us/w/12345?tk=TOKEN"
To get a registrant's token and join the meeting
- Call Add meeting registrant, List meeting registrants, or Update registrant's status.
- Get the
tk
value from the response:
{"registrant_id": "ESJWWYqvTDWFGNUqJzB_bQ","id": 96231721187,"topic": "My Registered websdk Meeting","start_time": "2021-05-31T14:00:00Z","join_url": "https://example.zoom.us/w/12345?tk=JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz&pwd=Ri0TkdxhXeWRUOITyT3ZDZmOOOGwxQT09&uuid=XX_pII1ZlzIQ42xx3zA2zYrrU"}
The tk
value above is JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz
JavaScript Example
var registrantToken = new URL(response.join_url).searchParams.get('tk')// Let's imagine that the response is the same and the tk value is:// JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz
- Set the registrant token as the value for
tk
inclient.join()
:
client.join({sdkKey: sdkKey,signature: signature,meetingNumber: meetingNumber,password: password,userName: userName,userEmail: userEmail, // userEmail property requiredtk: registrantToken // JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz})
Need help?
If you're looking for help, try Developer Support or our Developer Forum. Priority support is also available with Premier Developer Support plans.