anchorPassword and Captcha Verification Process

When the SDK is configured with meetings.experimental.enableUnifiedMeetings set to true, the SDK leverages the Webex API to fetch meeting details.

Password required. Call fetchMeetingInfo() with password argument

or

Captcha required. Call fetchMeetingInfo() with the captchaInfo argument

In cases where access is restricted, the Webex API returns specific error codes, such as 403xxx and 423xxx. In response to those errors, you must:

1. Provide the correct password or captcha.
2. Call fetchMeetingInfo again to retrieve the meeting information.

For more information see the Kitchen Sink app.

anchorCaptcha Response Example

A typical captcha response includes fetching the captcha image and audio, as well as refreshing the captcha URL:

{
  "code": 423006,
  "message": "PasswordOrHostKeyError too many times, please input captcha code",
  "captchaID": "Captcha_8f7ecfce-541f-4f22-9ff7-a42d6a323336",
  "verificationImageURL": "https://train.qa.webex.com/captchaservice/v1/captchas/Captcha_8f7ecfce-541f-4f22-9ff7-a42d6a323336/verificationCodeImage",
  "verificationAudioURL": "https://train.qa.webex.com/captchaservice/v1/captchas/Captcha_8f7ecfce-541f-4f22-9ff7-a42d6a323336/verificationCodeAudio",
  "refreshURL": "https://train.qa.webex.com/captchaservice/v1/captchas/refresh?siteurl=train&captchaID=Captcha_8f7ecfce-541f-4f22-9ff7-a42d6a323336"
}

anchorError Code Handling

While the Webex API returns various error identifiers, it primarily checks for 403xxx and 423xxx codes. Those codes indicate password and captcha errors, specifically:

const PASSWORD_ERROR_DEFAULT_MESSAGE =
  'Password required. Call fetchMeetingInfo() with a password argument';
const CAPTCHA_ERROR_DEFAULT_MESSAGE =
  'Captcha required. Call fetchMeetingInfo() with a captchaInfo argument';
const ADHOC_MEETING_DEFAULT_ERROR =
  'Failed to start the ad-hoc meeting, Please contact support team ';

For more information, refer to Webex JS SDK.

Password Error Details

The following table lists password error codes and descriptions of when these codes are returned.

Captcha Error Details

The following table lists captcha error codes and descriptions of when these codes are returned.