Documentación

Todo lo que necesitas para poner Ontara en tu web y responder a los visitantes en cualquier idioma.

Instalar el widget

Inicia sesión, crea un espacio de trabajo y abre Widget de chat en el panel. Copia tu fragmento de código y pégalo antes de </body> en todas las páginas:

<script src="https://YOUR-LINGLY-HOST/w.js" data-site="pk_your_site_key" async></script>

El widget solo funciona en el dominio que registraste y sus subdominios (por ejemplo, example.com también cubre shop.example.com). Antes de instalarlo, abre la Página de prueba desde el panel para probarlo.

WordPress

Instala el plugin de Ontara para WordPress, o pega el mismo fragmento con cualquier plugin de scripts de cabecera y pie de página.

Aplicaciones de una sola página

Añade el script una vez en tu plantilla HTML. Sigue funcionando aunque cambien las rutas en el cliente.

API de JavaScript

Cuando el script se carga, tienes disponible un pequeño objeto global:

LlamadaQué hace
lingly.open()Abre la ventana del chat, por ejemplo desde tu propio botón de «Contacto».
lingly.close()Cierra la ventana del chat.
lingly.identify({ userId, email, name, hash })Le dice a Ontara quién es el visitante. Consulta la verificación de identidad.
lingly.reset()Olvida al visitante, por ejemplo cuando un usuario cierra sesión.
lingly.shutdown()Quita el widget de la página.

Traducción

Configura el idioma del equipo en Equipo. Cuando un visitante escribe en otro idioma, el mensaje se traduce para tu equipo y el original está a un clic. Tus respuestas se traducen al idioma del visitante antes de entregarse. El mensaje de bienvenida y las respuestas automáticas también se traducen.

Activa o desactiva la traducción en Automatización. Los botones del propio widget siguen el idioma del navegador del visitante (inglés, chino, español, portugués, francés, alemán, japonés, coreano e italiano), o el idioma que elijas.

Respuestas de IA

  1. Añade contenido en Base de conocimiento: preguntas y respuestas, la URL de una página web o texto.
  2. Usa Prueba la IA en la misma página para ver cómo respondería.
  3. En Automatización, elige cuándo responde la IA: solo cuando no hay nadie conectado, o siempre primero.

La IA responde solo con tu base de conocimiento y en el idioma del visitante. Cuando no sabe responder, o el visitante pide hablar con una persona, pasa la conversación a tu equipo y deja de responder en esa conversación. También se detiene en cuanto responde alguien del equipo.

Cuando no estás

Equipo y roles

RolPuede
PropietarioTodo, incluida la facturación.
AdministradorConfiguración, base de conocimiento, webs, invitaciones y facturación.
AgenteResponder conversaciones y leer la base de conocimiento.

Invita a personas desde Equipo. Se unen iniciando sesión con el email invitado. Todos los planes tienen agentes ilimitados.

Planes y límites

Consulta los precios para ver qué incluye cada plan. Cuando se alcanza un límite mensual, el chat en vivo sigue funcionando; las respuestas de IA y la traducción se pausan hasta el mes siguiente o hasta que mejores el plan. Las conversaciones más antiguas que el periodo de historial de tu plan se eliminan automáticamente.

Verificación de identidad

Cuando un visitante ha iniciado sesión en tu web, puedes decirle a Ontara quién es y demostrarlo, para que nadie pueda hacerse pasar por uno de tus usuarios.

  1. En Widget de chat → Verificación de identidad, actívala y copia el secreto. Guárdalo solo en tu servidor.
  2. En tu servidor, calcula hex(HMAC-SHA256(secret, userId)).
  3. En la página, llama a lingly.identify({ userId, email, name, hash }).
// Node.js import { createHmac } from "node:crypto"; const hash = createHmac("sha256", process.env.LINGLY_IDENTITY_SECRET).update(user.id).digest("hex"); // PHP $hash = hash_hmac('sha256', $userId, getenv('LINGLY_IDENTITY_SECRET'));

Los agentes ven una insignia de Verificado junto al visitante. Una llamada con un hash incorrecto se rechaza. Los visitantes que solo escriben su email en el chat no aparecen como verificados.

Respuestas por email

Cuando tu respuesta le llega por email a un visitante que se ha ido, basta con que conteste a ese correo. Su respuesta aparece en la misma conversación, sin el texto citado ni las firmas.

Para esto necesitas un dominio de recepción. En Cloudflare Email Routing, envía r-*@reply.your-domain.com al Worker de Ontara y configura INBOUND_EMAIL_DOMAIN=reply.your-domain.com. Solo la dirección del propio visitante puede escribir en su conversación; las respuestas automáticas y los rebotes se ignoran.

Notificaciones

En Cuenta → Notificaciones del navegador, cada miembro del equipo puede activar las notificaciones en el dispositivo que usa. Cuando un visitante escribe y la bandeja no está abierta, aparece una notificación; al hacer clic se abre la conversación. Los avisos por email (en Equipo) siguen funcionando como respaldo.

React

Instala @lingly/react, coloca <LinglyChat siteKey="pk_..." user={...} /> en el componente raíz y usa useLingly() para obtener open, close, identify y reset. Cuando el usuario cierra sesión (user pasa a null), el widget olvida al visitante. El paquete aún no está publicado en npm; mientras tanto, la API de JavaScript hace lo mismo en cualquier app de React.

WordPress

  1. Descarga el plugin y, en WordPress, ve a Plugins → Añadir nuevo → Subir plugin.
  2. Actívalo y abre Ajustes → Ontara Chat.
  3. Pega tu clave del sitio. Si quieres, pega también el secreto de verificación de identidad para que los usuarios de WordPress con sesión iniciada aparezcan como verificados.

API REST

Crea una clave en Desarrolladores y envíala en cada petición con Authorization: Bearer lk_.... Hay endpoints para listar tus webs, listar y consultar conversaciones, leer mensajes, responder como tu equipo (la respuesta se traduce para el visitante), cerrar y reabrir, eliminar conversaciones y ver los datos de un visitante. Cada clave admite 120 peticiones por minuto. La referencia completa está en la versión en inglés.

Webhooks

Añade un endpoint https en Desarrolladores y elige los eventos que quieras. Cada evento llega como un POST en JSON con la cabecera Lingly-Signature: t=marca_de_tiempo,v1=firma, donde la firma es hex(HMAC-SHA256(secret, t + "." + rawBody)). Responde con cualquier estado 2xx. Las entregas fallidas se reintentan durante unos 20 minutos, y un endpoint que sigue fallando se pausa. Un evento puede llegar dos veces de forma ocasional, así que usa id para descartar duplicados.