Ir al contenido

SDK del asistente en pantalla

Poner las anclas en tu web

Ver como Markdown

El copiloto nunca usa selectores CSS, XPath ni JavaScript para encontrar algo en tu página — solo un atributo que tú añades a mano:

data-copilot-anchor="<idDePantalla>:<idDeAncla>"

Nota — Este nombre de atributo es neutro y no cambia con la marca de tu proveedor

El SDK busca data-copilot-anchor en el HTML de tu página, con independencia de la marca con la que tu proveedor te entregue el resto del producto. Escríbelo tal cual en tu código; si lo cambias por otro nombre, el copiloto no encontrará el elemento.

Por ejemplo, en un formulario de alta de cliente:

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

Un elemento sin este atributo es invisible para el copiloto, aunque esté a la vista en la pantalla — es la base de que el copiloto solo pueda tocar lo que tú decidiste exponer.

Nota — Compatibilidad con integraciones existentes

El SDK sigue reconociendo el atributo anterior, data-aymar-anchor, para no romper una integración ya hecha con ese nombre. Lo único que no está permitido es poner los dos atributos en el mismo elemento con ids distintos — el SDK no elige uno de los dos: lo trata como un elemento mal configurado y falla cerrado (outcome: "host_error"). Requiere SDK del copiloto versión 1.1.0 o superior; con una versión anterior, usa solo el atributo anterior.