Instalar el widget
El código que se pega en su sitio, dónde ponerlo y cómo comprobar que funciona.
El widget se instala con un único <script>. No necesita instalar librerías, tocar su servidor ni cambiar su diseño.
El código
Cada cuenta tiene su propia clave (data-key). La encuentra en Canales, junto al diseñador del asistente.
<script
src="https://widget.astrhorus.io/widget.js"
data-key="wk_live_tu_clave"
async
></script>
| Atributo | Qué hace |
|---|---|
src |
El script del widget. Lo sirve Astrhorus; siempre carga la versión vigente |
data-key |
Identifica a su cuenta. Es obligatorio; sin él el widget no aparece y la consola del navegador avisa |
async |
Evita que el script retrase la carga de su página |
Nota
La clave se puede ver en el código de su página: no es un secreto. Lo que protege su cuenta es la lista de dominios autorizados: en cualquier otro sitio, el widget se niega a abrirse.
Dónde pegarlo
Péguelo una sola vez antes del cierre de </body> en la plantilla común de su sitio, para que aparezca en todas las páginas:
<!-- … el contenido de su página … -->
<script src="https://widget.astrhorus.io/widget.js" data-key="wk_live_tu_clave" async></script>
</body>
</html>
Si lo quiere solo en algunas páginas (por ejemplo, no en el pago), póngalo únicamente en esas.
Qué hace al cargar
- Crea un botón flotante abajo a la derecha, con el avatar y el color que usted eligió.
- Pide una sesión a Astrhorus y comprueba que el sitio donde está sea uno de sus dominios autorizados.
- Al abrirse, muestra el chat en una ventana flotante. En el celular ocupa casi toda la pantalla.
- Guarda un identificador de sesión anónimo en el navegador del visitante, para que la conversación continúe si recarga la página.
El widget vive dentro de un <iframe>: sus estilos y scripts no afectan a los de su sitio, ni al revés.
Comprobar que funciona
- Abra su sitio en una ventana de incógnito.
- Debe ver el botón del asistente. Si no aparece, vaya a Solución de problemas.
- Escriba un mensaje. Después abra Chats en su panel: la conversación debe estar ahí.
Probar en su computador
Si desarrolla en local, agregue localhost a los dominios autorizados. Mientras prueba, el asistente aparece en http://localhost:3000 (o el puerto que use).
Cuidado
Quite localhost de la lista cuando termine, para que su asistente no aparezca en sitios de prueba que usted no controla.