Salta ai contenuti

SDK dell'assistente sullo schermo

Mettere le ancore sul tuo sito

Il copilota non usa mai selettori CSS, XPath o JavaScript per trovare qualcosa nella tua pagina — solo un attributo che aggiungi tu a mano:

data-copilot-anchor="<idSchermata>:<idAncora>"

Nota — Questo nome di attributo è neutro e non cambia con la marca del tuo fornitore

L’SDK cerca data-copilot-anchor nell’HTML della tua pagina, indipendentemente dalla marca con cui il tuo fornitore ti consegna il resto del prodotto. Scrivilo esattamente così nel tuo codice; se lo cambi con un altro nome, il copilota non troverà l’elemento.

Per esempio, in un modulo di registrazione cliente:

<input name="nome" data-copilot-anchor="leads.new:name" />
<input name="telefono" data-copilot-anchor="leads.new:phone" />
<button type="submit" data-copilot-anchor="leads.new:save">Salva</button>

Un elemento senza questo attributo è invisibile per il copilota, anche se è ben visibile a schermo — è la base per cui il copilota può toccare solo ciò che tu hai deciso di esporre.

Nota — Compatibilità con integrazioni esistenti

L’SDK continua a riconoscere l’attributo precedente, data-aymar-anchor, per non rompere un’integrazione già fatta con quel nome. L’unica cosa non permessa è mettere entrambi gli attributi sullo stesso elemento con id diversi — l’SDK non ne sceglie uno dei due: lo tratta come un elemento mal configurato e fallisce chiuso (outcome: "host_error"). Richiede SDK del copilota versione 1.1.0 o superiore; con una versione precedente, usa solo l’attributo precedente.