Instalación del widget

Obtener el script

El script de instalación se genera automáticamente al crear un chatbot. Para obtenerlo:

Ve a Chatbots en el dashboard
Selecciona tu chatbot
Haz clic en Instalar widget
Copia el snippet generado

El snippet tiene este formato:

<script
  src="https://widget.scrivot.cl/widget.js?jwt=TU_WIDGET_TOKEN"
  async
></script>

El parámetro jwt es el Widget Token — un JWT que identifica tu chatbot y workspace. Cada chatbot tiene su propio token.

Instalación por plataforma

HTML puro
Next.js
React (Vite / CRA)
WordPress
Webflow

Pega el script antes del cierre de </body>:

<body>
  <!-- Tu contenido aquí -->

  <script
    src="https://widget.scrivot.cl/widget.js?jwt=TU_WIDGET_TOKEN"
    async
  ></script>
</body>

En tu layout raíz (app/layout.tsx):

import Script from 'next/script'

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="es">
      <body>
        {children}
        <Script
          src="https://widget.scrivot.cl/widget.js?jwt=TU_WIDGET_TOKEN"
          strategy="lazyOnload"
        />
      </body>
    </html>
  )
}

En tu index.html:

<script
  src="https://widget.scrivot.cl/widget.js?jwt=TU_WIDGET_TOKEN"
  async
></script>

O como efecto en el componente raíz:

import { useEffect } from 'react'

export function ScrivotWidget() {
  useEffect(() => {
    const script = document.createElement('script')
    script.src = 'https://widget.scrivot.cl/widget.js?jwt=TU_WIDGET_TOKEN'
    script.async = true
    document.body.appendChild(script)
    return () => document.body.removeChild(script)
  }, [])
  return null
}

Ve a Apariencia → Editor de temas → footer.php y pega el script antes de </body>:

<script
  src="https://widget.scrivot.cl/widget.js?jwt=TU_WIDGET_TOKEN"
  async
></script>
<?php wp_footer(); ?>
</body>

También puedes usar el plugin Insert Headers and Footers para evitar editar el tema directamente.

Parámetros del script

Parámetro	Tipo	Requerido	Descripción
`jwt`	`string`	✅	Widget Token del chatbot
`host`	`string`	❌	URL base del servicio widget (para self-hosted)

Verificar la instalación

Después de instalar el script, recarga tu sitio. Deberías ver el botón flotante de Scrivot en la esquina inferior derecha. Si el widget no aparece:

El dominio no está autorizado

Ve a Workspace → Configuración → Dominios y agrega el dominio donde está instalado. Ver autorizar dominios.

El JWT es inválido o expirado

Los widget tokens no expiran, pero pueden ser revocados. Regenera el token desde Chatbots → [chatbot] → Instalar → Regenerar token.

Error de CORS o red

Abre las DevTools del navegador (F12) → pestaña Console y busca errores en rojo. Si ves un error 403, confirma que el dominio está autorizado.

Primeros pasos

Widget

Chatbot

Facturación

Instalación del widget

Obtener el script

Instalación por plataforma

Parámetros del script

Verificar la instalación

​Obtener el script

​Instalación por plataforma

​Parámetros del script

​Verificar la instalación

Obtener el script

Instalación por plataforma

Parámetros del script

Verificar la instalación