Trovo
I Suoi dati sono troppo grandi, o troppo freschi, per essere letti in anticipo. Così li chiedo in tempo reale — e mostro il risultato nella Sua interfaccia.
Un catalogo da un milione di articoli, lo stato di un ordine, un posto libero un minuto fa: non li memorizzo. Chiamo la Sua API quando la domanda lo richiede e apro ciò che ho trovato nel punto giusto.
Quello da 55 pollici è disponibile a Odessa?
Sì, ce ne sono due nel negozio di Odessa, ritiro oggi. Le ho aperto la scheda.
(la scheda del Suo prodotto si apre nella pagina)
Uno strumento è una singola chiamata alla Sua API, descritta una volta sola, nel Suo pannello.
Lei descrive la chiamata. L'indirizzo, GET o POST, gli header. Gli argomenti li compilo io — «una chiave di ricerca», «un numero d'ordine» — ciascuno con una frase che spiega cos'è, così so cosa inserire. Il parametro della lingua lo compilo da solo, nella lingua del visitatore, se la Sua API la supporta.
Lei mi dice cosa torna indietro. «Un elenco di prodotti con nome, prezzo e link.» Da quel momento so quando questo strumento risponde a una domanda, e uso il risultato per rispondere.
Il Suo token resta segreto. Lo incolla una sola volta; viene conservato cifrato, lo inserisco solo nel momento della chiamata e non compare mai in una trascrizione, in un log né davanti al modello.
Lo provi lì. Un pulsante sul modulo esegue la chiamata vera e mostra la risposta vera, così Lei vede ciò che vedrei io prima di un visitatore.
Un evento è il modo in cui apro la Sua interfaccia invece di descriverla.
«Mostra questi prodotti», «apri il carrello», «filtra l'elenco»: nel pannello Lei dà un nome all'evento e ai suoi campi, la Sua pagina resta in ascolto — un solo listener, scritto una volta dal Suo sviluppatore — e al momento giusto lo invio insieme ai dati. Sarà la Sua griglia di prodotti a mostrare i risultati. Io non disegno mai la Sua interfaccia al Suo posto: chiedo alla Sua di farlo.
Colleghi uno strumento a un evento e l'evento parte ogni volta che lo strumento trova qualcosa, non quando decido io. È deterministico, ed è proprio ciò che serve quando il risultato è un elenco di articoli da mostrare.
Chiedere prima, o agire subito. Un evento può essere contrassegnato con «chiedi prima il consenso»: allora lo tengo in sospeso dietro a una domanda, a cui il visitatore risponde con parole sue.
Consegnare un contatto. Tenere d'occhio una schermata.
Consegnare un contatto. Mi indichi l'endpoint del Suo CRM e ogni contatto lasciato da un visitatore viene inviato lì nel momento in cui arriva, con la domanda, la pagina e la lingua, e il Suo token nell'header. Dal pannello vede se è arrivato a destinazione.
Tenere d'occhio una schermata. Nella Sua app, uno strumento può essere il controllo che eseguo quando un utente apre una schermata: «c'è qualcosa che non va qui?» Se il Suo endpoint risponde di sì, alzo la mano con una sola frase. Se risponde di no, non dico nulla, e a Lei non costa niente.
</>
Cosa serve. Di solito un pomeriggio.
La Sua API esiste già: devo solo conoscerla. Un modulo per ogni chiamata nel pannello, senza SDK e senza codice sul Suo server. Un listener sulla Sua pagina per ogni evento, poche righe di JavaScript. E per un'app con accesso riservato, una chiamata per consegnarmi il token dell'utente, così interrogo la Sua API come se fossi lui.
Chiamo solo in https, dai nostri server, con un timeout, e non seguo mai un reindirizzamento. Riutilizzo una risposta solo quando è il Suo server a dirmi che posso.
Nella schermata Strumenti, più due selettori altrove.
I Suoi strumenti e i Suoi eventi, ciascuno in un modulo; accanto, i segreti, scritti una volta sola; dove uno strumento è disponibile: in ogni schermata o solo in quelle che lo indicano; Test su uno strumento, Simula su un evento. Lo strumento di consegna si sceglie nella scheda Passaggio a un operatore dell'assistente, quello che osserva una schermata nella fonte della schermata stessa.
I miei limiti, senza giri di parole.
- Un endpoint lento dà una risposta lenta: una chiamata che supera i dieci secondi viene interrotta e io rispondo senza il suo risultato.
- Pochi strumenti per sito, non centinaia; uno strumento può essere legato a una sola schermata, così compare solo dove serve.
- Strumenti, eventi e invio dei contatti sono una funzione del piano Growth. Con Starter rispondo a partire dalle Sue pagine.
Colleghi il Suo catalogo una volta sola. Alle domande ci penso io.
