Develop a Telephony System Login Page

If needed, create a telephony system login page that appears in the Omni-Channel utility in the Lightning service console.

Complete this step if your telephony provider doesn’t support SSO, meaning that reps must log into a telephony system to make and receive calls. The telephony system must maintain the duration and validity of the login session.

  1. In your ConversationVendorInfo file, include a login URL in the customLoginUrl field.

  2. In the response to init(), set showLogin to true and include an optional number for loginFrameHeight in the InitResult object.

  3. Upon initialization, the Omni-Channel utility shows an iframe that is populated with the URL specified in the scvVendorLoginUrl field of customSettings in the callCenter file:

    Omni login window

  4. Publish a Connector API event with the login result to show either a login failure or the dialer.

  5. The rep can now log out from Omni-Channel.

    Omni-Channel logout window

  6. In the event of a session timeout, the telephony vendor can trigger a logout from the Connector API and use the Connector API publishEvent method. The vendor can provide a loginFrameHeight for the login iframe. If no value is provided, a default value of 350 is used.

    Clicking Log Out in the Voice Call Simulator performs the same action. To learn more, see Test Your Implementation with the Voice Call Simulator.

See Also