Core Concepts
Prior to diving into the calling features of the Webex JS SDK, it's essential for developers to grasp a few fundamental concepts.
anchorAccess Token
anchorThe access token serves as a secure digital key that grants authorized access to various Webex services and resources. This token is a vital component of authentication and authorization mechanisms, ensuring that only trusted entities can interact with Webex on behalf of a user or application. Developers can obtain and utilize access tokens to initialize and consume the calling features available on the Webex JS SDK.
anchorCalling
anchorThe Calling
object serves as the developer's primary gateway, offering access to a range of essential features, including Calls, Voicemail, Contacts, Call History, and Call Settings. Developers initiate the Calling
instance by configuring the SDK, and it additionally provides developers with the capability to create audio streams.
anchorCalling Client
anchorThe CallingClient
module, housed within the Calling
object, plays a pivotal role in developer authorization for establishing a Webex Calling endpoint. This endpoint facilitates the seamless exchange of calls with the Webex cloud, both outgoing and incoming. After an administrator successfully provisions a user within a Webex Calling licensed organization, the CallingClient
module can be leveraged to generate the requisite endpoint associated with that user.
anchorLine
anchorThe Line
feature in the CallingClient
module acts as a virtual phone line, enabling the handling of both incoming and outgoing calls. This feature offers configurable settings and controls, empowering developers to manage multiple calls on different lines for an individual user.
As of October 1, 2023, the SDK currently supports only a single Line
within the CallingClient
. The capability to support multiple lines is planned for a future release.
anchorCall
anchorWithin the CallingClient
module, the Call
object serves as the operational unit for a specific call, offering a variety of methods to manage call characteristics such as direction, status, and participant details. In addition to basic actions like initiating, answering, and terminating calls, the Call
object also supports supplementary services like placing calls on hold, resuming them, and facilitating different types of call transfers, enhancing the feature set for real-time voice and video communications in your applications.