ChatzoraDocumentación
Desarrolladores

Opciones del código de inserción

Los atributos que lee el script del chat del sitio web, para desarrolladores que añaden el chat a mano.

Esta página es para desarrolladores. La mayoría de las personas puede copiar el código de Canales → Chat del sitio web sin cambiarlo. Consulta Instalar en tu sitio web.

El código de inserción

<script
  src="https://chatzora.com/widget.js"
  data-agent-id="YOUR_ASSISTANT_ID"
  data-api-base="https://chatzora.com"
  data-title="Your business name"
  async
></script>

Colócalo antes de la etiqueta de cierre </body> en todas las páginas donde quieras que aparezca el chat.

Atributos

AtributoObligatorioQué hace
data-agent-idSíEl asistente que se carga. Sin él, el script no hace nada.
data-api-baseNoLa dirección de Chatzora con la que se comunica. Por defecto, la dirección desde la que se cargó el script.
data-titleNoTexto del encabezado que se muestra antes de cargar los ajustes guardados.
data-colorNoColor del tema que se muestra antes de cargar los ajustes guardados, por ejemplo #059669.
data-welcome-messageNoMensaje de bienvenida que se muestra antes de cargar los ajustes guardados.
data-launcher-textNoTexto del botón del chat que se muestra antes de cargar los ajustes guardados.
data-positionNoleft o right, antes de cargar los ajustes guardados.
data-lead-captureNotrue para mostrar el formulario de contacto antes de cargar los ajustes guardados.
data-visitor-idNoTu propio ID estable del visitante, como el ID de tu cliente. Si lo omites, se crea un ID aleatorio y se guarda en el navegador.

Los atributos de apariencia son solo valores iniciales. Cuando el chat carga, los ajustes guardados en el panel (Ajustes → Ventana de chat) los reemplazan. Cambia la apariencia en el panel, no en el código.

Comportamiento

  • En pantallas de 480 px de ancho o menos, el chat se abre a pantalla completa. En pantallas más grandes se abre como una ventana flotante.
  • Las respuestas se muestran a medida que se escriben si el navegador lo admite. Las respuestas que usan una integración, como una búsqueda de productos, llegan de una sola vez.
  • Si has definido Sitios web autorizados a mostrar tu chat, el chat solo funciona en esos orígenes exactos.
  • Si el chat del sitio web está desactivado en el panel, el script lo quita de la página.

Content Security Policy

Si tu sitio usa una Content Security Policy, permite script-src, connect-src y frame-src para tu dirección de Chatzora (https://chatzora.com). Las páginas de reservas se abren en un marco, así que, si usas enlaces de reserva, permite también a tu proveedor de citas en frame-src.

Página de chat alojada

Puedes enlazar o insertar la página de chat alojada en lugar del script:

https://chatzora.com/widget?agentId=YOUR_ASSISTANT_ID