Přeskočit na hlavní obsah

Integrace

Frontendová integrace agentské lišty do jiných webových aplikací.

Začínáme​

přehled

Aplikace agentské lišty je JavaScriptový bundle, který se vkládá do webové aplikace CRM pomocí iframe. Propojení spočívá v navázání callbacků a volání metod pomocí SDK.

<iframe src="https://ucs.zakaznik.cz/operator/" id="operator-app" allow="microphone autoplay"></iframe>
<script src="https://ucs.zakaznik.cz/operator/sdk.js" type="text/javascript"></script>
<script type="text/javascript"
const operatorIframe = document.getElementById('operator-app');
const targetOrigin = 'https://crm.zakaznik.cz/';
const integration = {
  onStateChange: (status) => {
    console.log('Agent switched their status to:', status);
  },
  onCallRinging: (call) => {
    console.log('Agent got a call:', call);
  },
  onCallHangup: (call) => {
    console.log('Agent finished a call:', call);
  },
};
window.ucsOperator = new UcsOperatorSDK(operatorIframe, targetOrigin, integration);

// to switch agent status
window.ucsOperator.changeStatus("READY");

// to dial a call
window.ucsOperator.dial("+420800123456");

// to hangup a call
window.ucsOperator.hangup();

</script>

SDK je jednoduchý bridge mezi CRM a operátorskou aplikací UCS, který zajišťuje bezpečnou integraci pomocí postMessage.

Přihlášení​

V produkčním prostředí se využívá přihlášení uživatele pomocí SSO přímo prostřednictvím operačního systému (např. Active Directory a GSSAPI). Případně lze navázat trust mezi CRM a UCS pomocí PSK a CRM může následně přihlašovat uživatele prostřednictvím metody sso.

Pro potřeby vývoje a ladění je možné využít přihlášení pomocí jména a hesla prostřednictvím metody login.

// login using credentials
configuration.onCredentials = () => {
  ucsOperator.login('alice', 'password1234');
}