Screen pop nativo nell'Agent Desktop di SSCV2: quello che il PDF non vi dice

Questo mese abbiamo spostato il nostro widget telefonico da un pannello laterale custom allo screen pop nativo dell’Agent Desktop di SAP Sales and Service Cloud V2. Arriva una chiamata, l’agente vede chi chiama, si apre il workspace giusto e, quando la chiamata finisce, la sessione termina. Semplice sulla carta. La parte interessante è stata tutto ciò che la documentazione ufficiale non dice.

Tre lezioni ci sono rimaste impresse.

Il silenzio è il peggior messaggio di errore

La shell dell’Agent Desktop e il widget CTI si parlano tramite eventi postMessage del browser, e il payload deve essere XML. Non JSON, XML, nel 2026. Inviate lo stesso contenuto come JSON e la reazione della shell è il nulla assoluto. Nessun errore, nessuna riga di log. Il vostro adapter crede di essere integrato; la shell crede che nessuno abbia chiamato. Quel silenzio ci è costato un pomeriggio che una singola risposta di errore avrebbe trasformato in dieci minuti.

La lezione è generale: quando integrate contro una scatola nera, pianificate l’osservazione, non solo la lettura. Il contratto contro cui spedite davvero è quello che misurate, impressioni a prima vista comprese.

Un solo ID, ovunque, o niente si correla

L’intera sessione si regge su un unico external reference ID, che deve essere identico in ogni messaggio e nell’attività telefonica nel CRM. Lasciate che due componenti si inventino ciascuno il proprio ID e ottenete la modalità di guasto più brutta che esista: la parte visibile funziona, la pulizia no, e all’ora di pranzo l’agente ha il desktop pieno di sessioni zombie.

La disciplina sugli ID è noiosa, ed è esattamente per questo che sfugge. Generare una volta, passarlo avanti, mai rigenerarlo.

Ereditate i tempi dell’altro sistema

Terminare una sessione funziona solo quando la shell riesce a trovare l’attività telefonica, e l’indice di ricerca dietro quella lookup resta indietro di qualche secondo rispetto alla realtà. Mandate il saluto troppo presto e va a vuoto; nessuno saluta due volte, quindi la sessione vive per sempre.

Il nostro rimedio: lasciar assestare, aspettare finché l’attività è davvero trovabile, poi terminare, e terminare di nuovo se serve. Elegante? No. Corretto rispetto al sistema come si comporta davvero? Sì. Quando integrate contro un indice, i suoi tempi diventano i vostri, che il PDF lo menzioni o no.

E rilasciatelo dietro un flag

Abbiamo attivato la modalità nativa tenant per tenant, dietro un flag. La telefonia è l’integrazione in cui ogni agente nota ogni regressione nel giro di minuti. Un rollout controllato non è prudenza fine a se stessa; è ciò che ci ha permesso di imparare queste lezioni senza un telefono di supporto bollente.

Se anche voi state costruendo contro l’Agent Desktop e osservate comportamenti che contraddicono questo post, fatecelo sapere. Questo contratto è stato ricostruito a posteriori, una sorpresa alla volta.