Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Metodo Javascript

Descrizione

TOOLBAR.EAYCIMEASYCIM.openScriptInbound

String ContactID

Chiede la apertura di un nuovo script per un contatto Inbound generando un nuovo ECID di lavorazione su easyCIM. Per questa API si è scelto di eseguirla in automatico da CTToolbar7 solo nel caso lo Script non sia stato abilitato dalla configurazione del profilo in AgentDesktopManager. In questo modo l’integratore non dovrà preoccuparsi di richiamarla ad ogni contatto Inbound ACD mentre sarà altresì suo compito richiamare la API di esitazione e salvataggio TOOLBAR.EASYCIM.saveScript.

TOOLBAR.EAYCIMEASYCIM.openScript

String ContactID, String ECID

Chiede la apertura dello Script per un contatto esistente avente come identificativo il parametro ECID.

La chiamata a questa API serve per riservare il contatto all’operatore va utilizzata sull’evento di ESTABLISHED della chiamata, quando si è sicuri che il cliente ha risposto.

Verrà restituito mediante una Promise Javascript una struttura JSON contenente i seguenti parametri:

  • result (boolean): indica se la chiamata è andata a buon fine.

In caso di risposta positiva nell’oggetto JSON verranno valorizzati i seguenti campi:

  • ECID, campaignName, idCustomer, idCustomerBOC, idMacroActivity, idMacroActivityBOC, idPartner, idPartnerBOC, macroActivityDescription

{
ECID: "felixct7|1|181|12"
campaignName: null
idCustomer: 181
idCustomerBOC: null
idMacroActivity: 12
idMacroActivityBOC: null
idPartner: 1
idPartnerBOC: null
macroActivityDescription: "DEFAULT_INB"
result: true
}

Esempio di chiamata della API openScript:

Code Block
languagejs
TOOLBAR.EASYCIM.openScript("86-60536353@B2BUAGW1.enghouse.com", "felixct7|1|181|12").then(
  function(data) { }, function(err) { }
);

TOOLBAR.EAYCIMEASYCIM.getContactInfo

String ContactID

Restituisce mediante una Promise Javascript tutta la struttura ContactInfo memorizzata su easyCIM per il contatto in corso.

Code Block
TOOLBAR.EASYCIM.getContactInfo(ContactObj.id).then (
  function (data) {
  }
);

TOOLBAR.EASYCIM.getContactInfoWS

String ECID

Restituisce mediante una Promise Javascript tutta la struttura ContactInfo memorizzata su easyCIM ed associata ad un ECID valido. A differenza della API getContactInfo questo metodo non si basa sui dati memorizzati nella istanza locale della toolbar ma interroga un specifico Web Service esposto da easyCIM.

Code Block
languagejs
TOOLBAR.EASYCIM.getContactInfoWS("felixct7|1|854|12").then (
  function (data) {
  }
);

Esempio di oggetto ritornato in caso di successo:

Code Block
languagejson
{
  "result": true,
  "ContactInfo": [
    {
      "id": "CUSTOMER_INFO",
      "description": "Cliente",
      "value": ""
    }
  ]
}

Esempio di oggetto ritornato in caso di ECID non valido (il campo error conterrà un descrizione dell’errore):

Code Block
languagejson
{
  "result": false,
  "error": {
    "errorDescription": "Dati non presenti",
    "additionalInfo": {
      "info": [
        "Contact pk[999] schema[tenant01] macroActivity[DEFAULT_INB] not found"
      ]
    }
  }
}

TOOLBAR.EASYCIM.saveScript

String ContactID, String outcomeResult, Boolean offlineEnd, String note, Object Array labels

Salva lo script specificando un esito di chiusura ed eventualmente terminando la lavorazione del contatto sulla postazione operatore (termina lo stato di Offline/ACW del contatto stesso). E’ possibile specificare come esito uno dei seguenti valori preconfigurati:

  • Un valore stringa tra i seguenti: BUSY_BY_AGENT, NO_ANSWER_BY_AGENT,            ANSWERING_MACHINE_BY_AGENT, FAX_BY_AGENT,               APPOINTMENT

  • Un esito di produttività mediante il suo ID (esempio 117)

  • Un esito di produttività mediante la sua descrizione (esempio DEFAULT_NU)

Il parametro offlineEnd indica se terminare o meno anche il contatto CTI facendo di conseguenza terminare lo stato di Offline (After Call Work) del contatto stesso e rendendo nuovamente schedulabile l’operatore.

Il parametro note consente di specificare annotazioni aggiuntive associate alla chiusura del contatto.

Con il parametro labels è possibile aggiungere informazioni strutturate organizzate in un array di uno o più oggetti aventi la seguente struttura:

Code Block
 {
  "label": "result_code",
  "value": "12345",
  "isStatistic": true,
  "isAnagraphic": false,
  "isFromSDK": false
 }
  • label: nome del campo

  • value: valore del campo

  • isStatistic (true/false): se true indica che il campo può essere esportabile ed utilizzato nelle statistiche

  • isAnagraphic: se true indica che il campo appartiene alla anagrafica cliente

  • isFromSDK: se true non necessita la pre-dichiarazione del campo all’interno del Form Configurator (Script)

...