Inicio rápido: documentos de EasyLiveChat

§ 01Crea tu workspace.

Dirígete al panel demo en la página de inicio de sesión. Usa la cuenta propietaria precargada, o en producción crea un nuevo workspace — elige un slug, eso se convierte en tu subdominio (acme.livechattools.com).

En el primer inicio de sesión llegas al inbox. Aún no hay conversaciones reales — eso lo arregla el paso dos.

§ 02Incrusta el widget.

Pega el script loader antes de la etiqueta de cierre </body> . Eso es todo — sin componente React que montar, sin plugin Vue que registrar.

HTMLapps/your-site/index.html

<script>
  window.LivechattoolsConfig = { tenant: 'acme' };
</script>
<script src="https://cdn.livechattools.com/widget-loader.js" async defer></script>

Reemplaza acme con el slug de tu propio workspace. El script obtiene el tema en vivo desde tu tenant — colores, textos, bandera RTL y avatar — así los cambios de diseño nunca requieren un re-deploy de tu sitio.

Identificar a un visitante

Si el visitante ha iniciado sesión en tu producto, pasa al widget su identidad para que puedas correlacionar las conversaciones de EasyLiveChat con tu propia tabla de usuarios:

JSwindow.LivechattoolsConfig — identificación

window.LivechattoolsConfig = {
  tenant: 'acme',
  identify: {
    id:    'usr_28x91',          // your stable user id
    name:  'Mariam El-Sayed',
    email: 'mariam@example.com',
    locale: 'ar',
    attributes: {
      plan:        'pro',
      mrr_cents:   4900,
      signed_up:   '2024-11-04',
    },
  },
};

§ 03Envía tu primera respuesta.

Abre tu sitio en una segunda pestaña del navegador, haz clic en la burbuja y escribe "Hello world". El mensaje llega al inbox del panel en tiempo real a través de un canal Socket.IO — en menos de un segundo, sin fallback de polling.

Pulsa ⌘↩ en cualquier respuesta de agente para enviarla. El visitante ve tu mensaje aparecer con un sonido suave y un punto de presencia que cambia a "Typing…" mientras compones.

§ 04Invita a tu equipo.

Desde Ajustes → Agentes, haz clic en Invitar, e introduce un email y un rol. EasyLiveChat envía por correo un enlace de un solo uso; al hacer clic se establece una contraseña y el nuevo agente llega directo al inbox. Los roles imponen lo que pueden ver — los owners administran la facturación, los admins gestionan agentes, los agentes responden.

bashPOST /api/tenant/agents — invitar mediante la REST API

curl -X POST https://acme.livechattools.com/api/tenant/agents \
  -H "Authorization: Bearer $EASYLIVECHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "email":  "noor@acme.test",
        "name":   "Noor Al-Saadi",
        "role":   "ADMIN"
      }'

§ 05Establece horas laborales.

Fuera de horario el widget cambia el composer por un formulario offline. Las conversaciones siguen llegando al inbox — se etiquetan como offline para un seguimiento limpio a la mañana siguiente. Configura las ventanas de los días laborales en Ajustes → Horas laborales, cada una en la zona horaria local de tu tenant.

JSONHorario de ejemplo — Dom–Jue, 09:00–18:00 Asia/Erbil

{
  "timezone": "Asia/Erbil",
  "schedule": {
    "sunday":    [{ "from": "09:00", "to": "18:00" }],
    "monday":    [{ "from": "09:00", "to": "18:00" }],
    "tuesday":   [{ "from": "09:00", "to": "18:00" }],
    "wednesday": [{ "from": "09:00", "to": "18:00" }],
    "thursday":  [{ "from": "09:00", "to": "18:00" }],
    "friday":    [],
    "saturday":  []
  },
  "offlineMessage": "We're back Sunday at 9. Leave a note — we will reply."
}

§ 06A dónde ir después.

¿Fue útil este artículo?

Sugerir una edición ↗