Webex Calling
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.