Insertar el widget

La versión breve

Coloque esta línea en la cabecera de su página y sustituya SITE_KEY por su clave:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        async></script>

Eso es todo. El cargador pesa 3,48 kB y solo obtiene el núcleo cuando el navegador tiene tiempo o cuando el visitante toca el botón del chat.

Si sirve loader.js desde su infraestructura, necesita una línea más

Algunas personas prefieren cargar el script desde su propio directorio en lugar de nuestra red de distribución, por una política, por un entorno de pruebas o simplemente por costumbre. Es posible, pero entonces debe indicar expresamente la conexión del chat:

<script src="/js/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-ws-url="wss://ws.reactive.chat/rc_wss/"
        async></script>

Por qué: sin ese dato, el widget deduce la dirección a partir del lugar de donde procede el script. Si procede de su dominio, también busca allí el chat y no encuentra nada.

Y el fallo resulta difícil de detectar. El botón del chat aparece, la ventana se abre, el color y el idioma son correctos y todo parece listo. Pero no llega ningún mensaje. No aparece ningún error: la conexión sigue reintentándolo en segundo plano, y eso es precisamente lo que oculta el fallo. Solo la consola del navegador indica el host que busca en vano.

El valor anterior es el mismo para todas nuestras cuentas. Solo si ejecuta el servidor personalmente debe indicar el suyo.

Mediante un subdominio de su propio sitio web

Si el chat debe funcionar como first-party a través de su propio subdominio (por ejemplo, chat.your-company.com en lugar de cdn.reactive.chat), la guía de dominio propio describe la configuración del proxy. Su cuenta muestra entonces el código de inserción correspondiente.

Cuando WebSockets está bloqueado

Si una red no deja pasar WebSocket, por ejemplo detrás de un proxy corporativo, el chat continúa automáticamente mediante HTTPS normal. Para ello, su política de seguridad de contenido necesita la dirección https:// indicada más abajo, además de la dirección wss://. En Alternativa HTTP se explica cuándo se utiliza y cómo forzarla para realizar pruebas.

Abrir el chat desde enlaces propios y mostrar una tarjeta promocional

Cualquier enlace o botón de su página puede abrir el chat, con la ventana justo al lado: Abrir el chat desde un enlace o botón propio. En La tarjeta promocional en el chat se describe cómo mostrar en el chat una tarjeta para una oferta propia, como su plan de pago.

Insertar automáticamente el texto de privacidad

Un pequeño elemento en la página de su política de privacidad muestra el texto correspondiente al chat, siempre de acuerdo con los ajustes de su proyecto y en el idioma de la página: Insertar automáticamente el texto de privacidad.

Por qué no hay un script en línea

La forma habitual que ofrecen nuestros competidores es un <script> en línea. Con una política de seguridad de contenido estricta sin unsafe-inline, se bloquea antes de que se ejecute una sola línea. La forma con atributos de arriba no necesita ninguno.

Qué más debe permitir su política:

• script-src el host de distribución, aquí cdn.reactive.chat
• connect-src la dirección WebSocket, aquí wss://ws.reactive.chat
• connect-src también la misma dirección con https:// en este caso: https://ws.reactive.chat – la utilizan el formulario sin conexión y la alternativa HTTP cuando un proxy corporativo bloquea WebSockets

Los ajustes de la etiqueta de script

1. data-rc-site-key — obligatorio. Sin ella no se inicia nada, y es intencionado.
2. data-rc-locale — de, en o pl. Si falta, decide el navegador.
3. data-rc-brand — el color de su marca. El texto se recalcula hasta que resulte legible.
4. data-rc-ws-url — obligatorio en cuanto deje de cargar loader.js desde cdn.reactive.chat. Véase la sección anterior.

Todo lo demás está en la vista general de funciones y en la página de precios.

En detalle en la documentación

Paso a paso: Inicio rápido. Todos los atributos de la etiqueta de script con su tipo y valor predeterminado: Referencia de la etiqueta de script. Todos los capítulos están en la documentación.