AstrhorusDocumentación

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

  1. Crea un botón flotante abajo a la derecha, con el avatar y el color que usted eligió.
  2. Pide una sesión a Astrhorus y comprueba que el sitio donde está sea uno de sus dominios autorizados.
  3. Al abrirse, muestra el chat en una ventana flotante. En el celular ocupa casi toda la pantalla.
  4. 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

  1. Abra su sitio en una ventana de incógnito.
  2. Debe ver el botón del asistente. Si no aparece, vaya a Solución de problemas.
  3. 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.