Meetings

The client.join() function is used to start and join Zoom Meetings.

On this page

• Prerequisites
• Start Meeting
• Join Meeting
• Join Meeting with Registration Required

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.

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 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 1
  meetingNumber: meetingNumber,
  password: password,
  userName: userName,
  zak: zakToken // the host's zak token
})

Join Meeting

To join a Zoom Meeting, you must use 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 0
  meetingNumber: 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

1. Call Add meeting registrant, List meeting registrants, or Update registrant's status.
2. 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

3. Set the registrant token as the value for tk in client.join():

client.join({
  sdkKey: sdkKey,
  signature: signature,
  meetingNumber: meetingNumber,
  password: password,
  userName: userName,
  userEmail: userEmail, // userEmail property required
  tk: registrantToken // JtbsW3pp3KxPLLrE_y7-968kggkV7R5czHM9c0tVvgpM.DQIAAAAWZ9uI4xZFU0pXV1lxdlREV0ZHTlVxSnpCX2JRAzzzzzz
})